Adicionar uma fonte de eventos do hub de eventos ao seu ambiente do Azure Time Series Insights
Nota
O serviço Time Series Insights será desativado em 7 de julho de 2024. Considere migrar os ambientes existentes para soluções alternativas o mais rápido possível. Para obter mais informações sobre a substituição e migração, visite nossa documentação.
Este artigo descreve como usar o portal do Azure para adicionar uma fonte de eventos que lê dados dos Hubs de Eventos do Azure ao seu ambiente do Azure Time Series Insights.
Nota
As etapas descritas neste artigo se aplicam aos ambientes Azure Time Series Insights Gen 1 e Azure Time Series Insights Gen 2.
Pré-requisitos
- Crie um ambiente do Azure Time Series Insights, conforme descrito em Criar um ambiente do Azure Time Series Insights.
- Crie um hub de eventos. Leia Criar um namespace de Hubs de Eventos e um hub de eventos usando o portal do Azure.
- O hub de eventos deve ter eventos de mensagem ativos enviados para ele. Saiba como Enviar eventos para Hubs de Eventos do Azure usando o .NET Framework.
- Crie um grupo de consumidores dedicado no hub de eventos do qual o ambiente do Azure Time Series Insights pode consumir. Cada fonte de evento do Azure Time Series Insights deve ter seu próprio grupo de consumidores dedicado que não seja compartilhado com nenhum outro consumidor. Se vários leitores consumirem eventos do mesmo grupo de consumidores, é provável que todos os leitores apresentem 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 seu hub de eventos
Os aplicativos usam grupos de consumidores para extrair dados dos Hubs de Eventos do Azure. Para ler de forma confiável os dados do seu hub de eventos, forneça um grupo de consumidores dedicado que seja usado apenas por este 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 Hubs de Eventos de Entidades ou localize sua instância em Nome>.
Na instância do hub de eventos, selecione Grupos de consumidores de entidades>. Em seguida, selecione + Grupo de consumidores para adicionar um novo grupo de consumidores.
Caso contrário, selecione um grupo de consumidores existente e vá para a próxima seção.
Na página Grupos de consumidores , insira um novo valor exclusivo para Nome. Use esse mesmo nome ao criar uma nova fonte de eventos no ambiente do Azure Time Series Insights.
Selecione Criar.
Adicionar uma nova fonte de evento
Inicie sessão no portal do Azure.
Localize seu ambiente existente do Azure Time Series Insights. No menu à esquerda, selecione Todos os recursos e, em seguida, selecione seu ambiente do Azure Time Series Insights.
Selecione Fontes de Eventos e, em seguida, selecione Adicionar.
Insira um valor para Nome da fonte do evento que seja exclusivo para este ambiente do Azure Time Series Insights, como
Contoso-TSI-Gen 1-Event-Hub-ES.Em Source, selecione Event Hub.
Selecione os valores apropriados para a opção Importar:
Se você tiver um hub de eventos existente em uma de suas assinaturas, selecione Usar Hub de Eventos nas assinaturas disponíveis. Esta 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:
Property Descrição Subscrição A assinatura à qual pertence a instância do hub de eventos e o namespace desejados. Espaço de nomes do hub de eventos O namespace do hub de eventos ao qual a instância de hub de evento desejada pertence. Nome do Hub de Eventos O nome da instância desejada do hub de eventos. Valor da política do Hub de Eventos Selecione a política de acesso compartilhado desejada. Você pode criar a 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 fonte do evento deve ter permissões de leitura . Chave de política do Hub de Eventos Pré-preenchido a partir do valor da política do Hub de Eventos selecionado. 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 :
Property Description ID de Subscrição A assinatura à qual pertence a instância do hub de eventos e o namespace desejados. Grupo de recursos O grupo de recursos ao qual a instância do hub de eventos e o namespace desejados pertencem. Espaço de nomes do hub de eventos O namespace do hub de eventos ao qual a instância de hub de evento desejada pertence. Nome do Hub de Eventos O nome da instância desejada do hub de eventos. Valor da política do Hub de Eventos Selecione a política de acesso compartilhado desejada. Você pode criar a 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 fonte do evento deve ter permissões de leitura . Chave de política do Hub de Eventos A chave de acesso compartilhada usada para autenticar o acesso ao namespace do Service Bus. Insira a chave primária ou secundária aqui. Ambas as opções compartilham as seguintes opções de configuração:
Property Description Grupo de consumidor do Hub de Eventos O grupo de consumidores que lê eventos do hub de eventos. É altamente recomendável que você use um grupo de consumidores dedicado para sua fonte de evento. Formato de serialização de eventos Atualmente, JSON é o único formato de serialização disponível. As mensagens de evento devem estar nesse formato ou os dados não podem ser lidos. Nome da propriedade do carimbo de data/hora Para determinar esse valor, você precisa entender o formato da mensagem dos dados da mensagem que são 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 fonte do evento é usado como o carimbo de data/hora do evento.
Adicione o nome dedicado do grupo de consumidores do Azure Time Series Insights que você adicionou ao seu hub de eventos.
Selecione Criar.
Depois que a fonte do evento é criada, o Azure Time Series Insights inicia automaticamente o streaming de dados para seu ambiente.
Próximos passos
Defina políticas de acesso a dados para proteger os dados.
Envie eventos para a fonte do evento.