Adicionar uma origem de evento do hub de eventos ao seu ambiente do Azure Time Series Insights
Observação
O serviço Time Series Insights será desativado em 7 de julho de 2024. Considere migrar ambientes existentes para soluções alternativas o mais rápido possível. Para obter mais informações sobre a substituição e a migração, visite nossa documentação.
Este artigo descreve como usar o portal do Azure para adicionar uma origem do evento que leia de um Hubs de Eventos do Azure para o ambiente do Azure Time Series Insights.
Observação
As etapas descritas neste artigo se aplicam aos ambientes do Azure Time Series Insights Gen 1 e do Azure Time Series Insights Gen 2.
Pré-requisitos
- Criar um ambiente do Azure Time Series Insights conforme descrito no artigo Criar um ambiente do Azure Time Series Insights.
- Criar um hub de eventos. Leia o artigo Criar um namespace e um hub de eventos dos Hubs de Eventos usando o portal do Azure.
- O hub de eventos deve ter eventos de mensagem ativos enviados a ele. Saiba como Enviar eventos aos Hubs de Eventos do Azure usando o .NET Framework.
- Criar um grupo de consumidores dedicado no hub de eventos do qual o ambiente do Azure Time Series Insights pode consumir eventos. Cada origem do evento do Azure Time Series Insights deverá ter um grupo de consumidores dedicado que não seja compartilhado com outros consumidores. Caso vários leitores consumam eventos do mesmo grupo de consumidores, eles provavelmente apresentarão falhas. Há um limite de 20 grupos de consumidores por Hub de Eventos. Para obter detalhes, leia o Guia de programação dos Hubs de Eventos.
Adicionar um grupo de consumidores ao hub de eventos
Aplicativos usam grupos de consumidores para efetuar pull dos dados de Hubs de Eventos do Azure. Para ler os dados do seu hub de eventos de modo confiável, forneça um grupo de consumidores dedicado que seja usado somente por esse ambiente do Azure Time Series Insights.
Para adicionar um novo grupo de consumidores ao seu hub de eventos:
No portal do Azure, localize e abra a instância do hub de eventos no painel Visão Geral do namespace do hub de eventos. Selecione Entidades > Hubs de Eventos ou localize a instância sob Nome.
Na instância do hub de eventos, selecione Entidades > Grupos de consumidores. Depois clique em + Grupo de consumidores para adicionar um grupo de consumidores.
Como alternativa, selecione um grupo de consumidores existente e prossiga para a próxima seção.
Na página Grupos de consumidores, insira um novo valor exclusivo para Nome. Use o mesmo nome ao criar a origem do evento no ambiente do Azure Time Series Insights.
Selecione Criar.
Adicionar uma nova origem do evento
Entre no portal do Azure.
Localize o ambiente existente do Azure Time Series Insights. No menu esquerdo, selecione Todos os recursos e seu ambiente do Azure Time Series Insights.
Selecione Origens do Evento, depois clique em Adicionar.
Insira um valor na opção Nome da origem do evento que seja exclusivo para esse ambiente do Azure Time Series Insights, como
Contoso-TSI-Gen 1-Event-Hub-ES.Para Origem, selecione Hub de Eventos.
Selecione os valores apropriados para Opção de importação:
Se você tiver um hub de eventos existente em uma de suas assinaturas, selecione Usar Hub de Eventos de assinaturas disponíveis. Essa opção é a abordagem mais fácil.
A tabela a seguir descreve as propriedades necessárias para a opção Usar Hub de Eventos de assinaturas disponíveis:
Propriedade Descrição Assinatura Uma assinatura à qual pertencem a instância do hub de eventos e o namespace desejados. Namespace do Hub de Eventos O namespace do hub de eventos ao qual pertence a instância do hub de eventos desejada. Nome do Hub de Eventos O nome da instância do hub de eventos desejada. Valor da política do Hub de Eventos Selecione a política de acesso compartilhado desejada. É possível criar uma política de acesso compartilhado na guia Configurar do hub de eventos. Cada política de acesso compartilhado tem um nome, permissões definidas e chaves de acesso. A política de acesso compartilhado para a origem do evento deve ter permissões de leitura. Chave de política do Hub de Eventos Ela será preenchida previamente com base no valor da política selecionado do Hub de Eventos. Se o hub de eventos for externo às suas assinaturas ou se você quiser selecionar opções avançadas, selecione Fornecer configurações do Hub de Eventos manualmente.
A tabela a seguir descreve as propriedades necessárias para a opção Fornecer configurações do Hub de Eventos manualmente:
Propriedade Descrição ID da assinatura Uma assinatura à qual pertencem a instância do hub de eventos e o namespace desejados. Grupo de recursos O grupo de recursos ao qual pertencem a instância do hub de eventos e o namespace desejados. Namespace do Hub de Eventos O namespace do hub de eventos ao qual pertence a instância do hub de eventos desejada. Nome do Hub de Eventos O nome da instância do hub de eventos desejada. Valor da política do Hub de Eventos Selecione a política de acesso compartilhado desejada. É possível criar uma política de acesso compartilhado na guia Configurar do hub de eventos. Cada política de acesso compartilhado tem um nome, permissões definidas e chaves de acesso. A política de acesso compartilhado para a origem do evento deve ter permissões de leitura. Chave de política do Hub de Eventos A chave de acesso compartilhado usada para autenticar o acesso ao namespace do Barramento de Serviço. Insira aqui a chave primária ou secundária. As duas opções compartilham as seguintes opções de configuração:
Propriedade Descrição Grupo de consumidores do Hub de Eventos O grupo de consumidor que lê os eventos do hub de eventos. Recomendamos que você use um grupo de consumidores dedicado para a origem do evento. Formato de serialização do evento No momento, JSON é único o formato de serialização disponível. As mensagens de evento deverão estar no formato abaixo, caso contrário, os dados não poderão ser lidos. Nome da propriedade timestamp Para determinar esse valor, você precisa entender o formato da mensagem dos dados de mensagem enviados para o hub de eventos. Esse valor é o nome da propriedade de evento específica nos dados da mensagem que você deseja usar como o carimbo de data/hora do evento. O valor diferencia maiúsculas de minúsculas. Se deixado em branco, o tempo de enfileiramento do evento na origem do evento será usado como o carimbo de data/hora do evento.
Insira o nome do grupo de consumidores dedicado do Azure Time Series Insights adicionado ao seu hub de eventos.
Selecione Criar.
Após a criação da origem do evento, o Azure Time Series Insights vai começar a transmitir dados de modo automático para o seu ambiente.
Próximas etapas
Definir as políticas de acesso de dados para proteger os dados.
Enviar eventos para a origem do evento.