Use as informações do Time Series para visualizar a telemetria enviada a partir do acelerador de solução do Device Simulation

O acelerador de solução Device Simulation permite gerar telemetria de dispositivos simulados para testar suas soluções de IoT. Este guia prático mostra como visualizar e analisar a telemetria simulada usando um ambiente de Séries Temporais.

Pré-requisitos

Para seguir as etapas deste guia prático, você precisa de uma assinatura ativa do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

As etapas neste guia prático pressupõem que você tenha implantado o acelerador da solução Simulação de dispositivos em sua assinatura do Azure. Se você ainda não implantou a Simulação de Dispositivo, confira Implantação da Simulação de Dispositivo no GitHub.

Este artigo presume que o nome do seu acelerador de solução é contoso-simulation. Substitua contoso-simulation pelo nome do seu acelerador de solução ao concluir as etapas a seguir.

Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada no seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção	Exemplo/Link
Selecione Experimentar no canto superior direito de um bloco de código ou de comando. Selecionar Experimentar não copia automaticamente o código nem o comando para o Cloud Shell.
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador.
Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure.

Para usar o Azure Cloud Shell:

1. Inicie o Cloud Shell.

2. Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou o comando.

3. Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e no Linux, ou selecionando Cmd+Shift+V no macOS.

4. Pressione Enter para executar o código ou comando.

Criar um grupo de consumidores

Você precisa criar um grupo de consumidores dedicado no hub IoT para telemetria de fluxo para o Time Series Insights. Uma fonte de evento no Time Series Insights deve ter o uso exclusivo de um grupo de consumidores do Hub IoT.

As etapas a seguir usam a CLI do Azure no Azure Cloud Shell para criar o grupo de consumidores:

1. O hub IoT é um dos vários recursos criados quando você implantou o acelerador de solução de Simulação de Dispositivo. Execute o seguinte comando para localizar o nome do hub IoT - lembre-se de usar o nome do seu acelerador de solução:

   az resource list --resource-group contoso-simulation -o table
   

   O hub IoT é o recurso do tipo Microsoft.Devices/IotHubs.

2. Adicione um grupo de consumidores chamado devicesimulationtsi ao hub. No comando a seguir, use o nome do acelerador de solução e de hub:

   az iot hub consumer-group create --hub-name contoso-simulation7d894 --name devicesimulationtsi --resource-group contoso-simulation
   

   Agora, você pode fechar o Azure Cloud Shell.

Crie um novo ambiente do Time Series Insights

Azure Time Series Insights é um serviço totalmente gerenciado de análise, armazenamento e visualização para o gerenciamento de dados de série temporal em escala IoT na nuvem. Para criar um novo ambiente do Time Series Insights:

1. Entre no portal do Azure.

2. Selecione Criar um recurso>Internet das Coisas>Time Series Insights:

   

3. Para criar seu ambiente do Time Series Insights no mesmo grupo de recursos do acelerador de solução, use os valores na tabela a seguir:

   Configuração	Valor
   Nome do ambiente	A captura de tela a seguir usa o nome Contoso-TSI. Ao concluir esta etapa, escolha seu próprio nome exclusivo.
   Assinatura	Na lista suspensa, selecione sua assinatura do Azure.
   Grupo de recursos	contoso-simulation. Use o nome do seu acelerador de solução.
   Localidade	Este exemplo usa Leste dos EUA. Crie seu ambiente na mesma região que seu acelerador de simulação de dispositivo.
   Sku	S1
   Capacidade	1

   

   Observação

   Adicionar o ambiente do Time Series Insights ao mesmo grupo de recursos do acelerador de solução significa que ele é excluído quando você exclui o acelerador de solução.

4. Clique em Criar. Pode levar alguns minutos para o ambiente ser criado.

Criar uma origem de eventos

Crie uma nova fonte de evento para se conectar ao hub IoT. Use o grupo de consumidores criado nas etapas anteriores. A fonte de evento do Time Series Insights requer um grupo de consumidores dedicado que não esteja em uso por outro serviço.

1. No portal do Azure, navegue até o novo Ambiente do Time Series.

2. À esquerda, clique em Origens de Eventos:

   

3. Clique em Adicionar:

   

4. Para configurar seu hub IoT como uma nova origem do evento, use os valores da tabela a seguir:

   Configuração	Valor
   Nome da Origem do Evento	A captura de tela a seguir usa o nome contoso-iot-hub. Ao concluir esta etapa, use seu próprio nome exclusivo.
   Origem	Hub IoT
   Importar opção	Usar o Hub IoT nas assinaturas disponíveis
   ID da assinatura	Na lista suspensa, selecione sua assinatura do Azure.
   Nome do Hub IoT	contoso-simulation7d894. Use o nome do hub IoT do seu acelerador de solução de simulação de dispositivo.
   Nome da política do Hub IoT	iothubowner
   Chave de política do hub IoT	Este campo é preenchido automaticamente.
   Grupo de consumidores do Hub IoT	devicesimulationtsi
   Formato de serialização do evento	JSON
   Nome da propriedade timestamp	Deixar em branco

   

5. Clique em Criar.

Observação

Você pode conceder acesso a usuários adicionais para o Time Series Insights explorer.

Iniciar uma simulação

Antes de usar o explorador do Time Series Insights, configure o acelerador de solução do Device Simulation para gerar alguma telemetria. A captura de tela a seguir mostra uma simulação em execução com 10 dispositivos do chiller:

Time Series Insights Explorer

O explorador do Time Series Insights é um aplicativo da web que você pode usar para visualizar sua telemetria.

1. No portal do Azure, selecione a guia Visão Geral de Séries Temporais Visão geral.

2. Para abrir o aplicativo da web do explorador do Time Series Insights, clique em Ir para o ambiente:

   

3. No painel de seleção de tempo, selecione Últimos 30 minutos no menu de horários rápidos e clique em Pesquisar:

   

4. No painel de termos à esquerda, selecione temperature como Measure e iothub-connection-device-id como o valor Split By:

   

5. Clique com o botão direito do mouse no gráfico e selecione Explorar eventos:

   

6. Os dados do evento são exibidos em uma grade:

   

7. Clique no botão de visualização em perspectiva:

   

8. Clique em + para adicionar uma nova consulta à perspectiva:

   

9. Selecione Últimos 30 minutos como o intervalo de tempo, Umidade como Medida e iothub-connection-device-id como o Dividir por valor:

   

10. Clique no botão de vista em perspectiva para ver o painel de telemetria do dispositivo:

    

Limpar os recursos

Se você planejar explorar ainda mais, deixe o acelerador de solução implantado.

Caso não precise mais do acelerador de solução, exclua-o da página Soluções provisionadas selecionando-o e clicando em Excluir Solução.

Se você tiver adicionado o ambiente do Time Series Insights ao grupo de recursos do acelerador de solução, ele será excluído automaticamente quando você excluir o acelerador de solução. Caso contrário, você deverá remover manualmente o ambiente do Time Series Insights do portal do Azure.

Próximas etapas

Para saber mais sobre como explorar e consultar dados no explorador Estatísticas do Time Series, consulte Explorador do Azure Time Series Insights.