Enviar eventos para um ambiente do Azure Time Series Insights Gen1 usando um hub de eventos
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.
Atenção
Este é um artigo Gen1.
Este artigo explica como criar e configurar um hub de eventos nos Hubs de Eventos do Azure. Ele também descreve como executar um aplicativo de exemplo para enviar eventos por push para o Azure Time Series Insights de Hubs de Eventos. Se você tiver um hub de eventos existente com eventos no formato JSON, ignore este tutorial e exiba seu ambiente no Azure Time Series Insights.
Configurar um hub de eventos
Para saber como criar um hub de eventos, leia a documentação dos Hubs de Eventos.
Na caixa de pesquisa, procure Hubs de Eventos. Na lista retornada, selecione Hubs de Eventos.
Selecione seu hub de eventos.
Ao criar um hub de eventos, você está criando um namespace de hub de eventos. Se você ainda não criou um hub de eventos dentro do namespace, no menu, em Entidades, crie um hub de eventos.
Depois de criar um hub de eventos, selecione-o na lista de hubs de eventos.
No menu, em Entidades, selecione Hubs de Eventos.
Selecione o nome do hub de eventos para configurá-lo.
Em Visão geral, selecione Grupos de consumidores e, em seguida, selecione Grupo de consumidores.
Certifique-se de criar um grupo de consumidores que seja usado exclusivamente pela sua fonte de eventos do Azure Time Series Insights.
Importante
Verifique se esse grupo de consumidores não é usado por nenhum outro serviço, como um trabalho do Azure Stream Analytics ou outro ambiente do Azure Time Series Insights. Se o grupo de consumidores for usado pelos outros serviços, as operações de leitura serão afetadas negativamente tanto para esse ambiente quanto para outros serviços. Se você usar $Default como grupo de consumidores, outros leitores poderão reutilizar seu grupo de consumidores.
No menu, em Definições, selecione Políticas de acesso partilhado e, em seguida, selecione Adicionar.
No painel Adicionar nova política de acesso compartilhado, crie um acesso compartilhado chamado MySendPolicy. Você usa essa política de acesso compartilhado para enviar eventos nos exemplos de C# mais adiante neste artigo.
Em Declaração, marque a caixa de seleção Enviar.
Adicionar uma instância do Azure Time Series Insights
No Azure Time Series Insights Gen2, você pode adicionar dados contextuais à telemetria de entrada usando o Modelo de Série Temporal (TSM). No TSM, suas tags ou sinais são chamados de instâncias e você pode armazenar dados contextuais em campos de instância. Os dados são unidos no momento da consulta usando uma ID de Série Temporal. O ID da série temporal para o projeto de moinhos de vento de exemplo que usamos mais adiante neste artigo é id. Para saber mais sobre como armazenar dados em campos de instância, leia a visão geral do Modelo de Série Temporal.
Criar uma origem de evento do Azure Time Series Insights
Se você não criou uma fonte de evento, conclua as etapas para criar uma fonte de evento.
Defina um valor para
timeSeriesId. Para saber mais sobre a ID da Série Temporal, leia Modelos de Série Temporal.
Enviar eventos para a amostra de moinhos de vento
Na barra de pesquisa, procure Hubs de Eventos. Na lista retornada, selecione Hubs de Eventos.
Selecione sua instância do hub de eventos.
Vá para Políticas>de Acesso Compartilhado MySendPolicy. Copie o valor para Cadeia de conexão-chave primária.
Navegue até o empurrador de parque eólico de amostra da ETI. O local cria e executa dispositivos simulados de moinhos de vento.
Na caixa Cadeia de Conexão do Hub de Eventos na página da Web, cole a cadeia de conexão copiada no campo de entrada do moinho de vento.
Selecione Clique para iniciar.
Gorjeta
O simulador de moinho de vento também cria JSON que você pode usar como uma carga útil com as APIs de consulta GA do Azure Time Series Insights.
Nota
O simulador continuará a enviar dados até que a guia do navegador seja fechada.
Volte ao seu hub de eventos no portal do Azure. Na página Visão geral, os novos eventos recebidos pelo hub de eventos são exibidos.
Formas JSON suportadas
Exemplo um
Entrada: Um objeto JSON simples.
{ "id":"device1", "timestamp":"2016-01-08T01:08:00Z" }Saída: Um evento.
id carimbo de data/hora device1 2016-01-08T01:08:00Z
Exemplo dois
Entrada: uma matriz JSON com dois objetos JSON. Cada objeto JSON é convertido em um evento.
[ { "id":"device1", "timestamp":"2016-01-08T01:08:00Z" }, { "id":"device2", "timestamp":"2016-01-17T01:17:00Z" } ]Saída: Dois eventos.
id carimbo de data/hora device1 2016-01-08T01:08:00Z device2 2016-01-08T01:17:00Z
Exemplo três
Entrada: um objeto JSON com uma matriz JSON aninhada que contém dois objetos JSON.
{ "location":"WestUs", "events":[ { "id":"device1", "timestamp":"2016-01-08T01:08:00Z" }, { "id":"device2", "timestamp":"2016-01-17T01:17:00Z" } ] }Saída: Dois eventos. O local da propriedade é copiado para cada evento.
localização events.id events.timestamp WestUs device1 2016-01-08T01:08:00Z WestUs device2 2016-01-08T01:17:00Z
Exemplo quatro
Entrada: um objeto JSON com uma matriz JSON aninhada que contém dois objetos JSON. Essa entrada demonstra que as propriedades globais podem ser representadas pelo objeto JSON complexo.
{ "location":"WestUs", "manufacturer":{ "name":"manufacturer1", "location":"EastUs" }, "events":[ { "id":"device1", "timestamp":"2016-01-08T01:08:00Z", "data":{ "type":"pressure", "units":"psi", "value":108.09 } }, { "id":"device2", "timestamp":"2016-01-17T01:17:00Z", "data":{ "type":"vibration", "units":"abs G", "value":217.09 } } ] }Saída: Dois eventos.
localização manufacturer.name manufacturer.location events.id events.timestamp events.data.type events.data.units events.data.value WestUs manufacturer1 EastUs device1 2016-01-08T01:08:00Z pressão psi 108.09 WestUs manufacturer1 EastUs device2 2016-01-08T01:17:00Z vibration abs G 217.09
Próximos passos
- Leia mais sobre mensagens de dispositivo do Hub IoT