Tutorial: Visualizar e analisar eventos de Azure Digital Twins usando Time Series Insights

Importante

Foi lançada uma nova versão do serviço Azure Digital Twins. À luz das capacidades expandidas do novo serviço, o serviço original Azure Digital Twins (descrito neste conjunto de documentação) foi retirado.

Para ver a documentação do novo serviço, visite a Documentação ativa da Azure Digital Twins.

Depois de implementar a sua instância Azure Digital Twins, a provisionar os seus espaços e implementar uma função personalizada para monitorizar condições específicas, pode visualizar os eventos e dados provenientes dos seus espaços para procurar tendências e anomalias.

No primeiro tutorial, configuraste o gráfico espacial de um edifício imaginário, com uma sala que contém sensores de movimento, dióxido de carbono e temperatura. No segundo tutorial, aprovisionou o gráfico e uma função definida pelo utilizador. A função monitoriza estes valores de sensor e aciona notificações para as condições certas. Ou seja, a sala está vazia, e os níveis de temperatura e dióxido de carbono estão normais.

Este tutorial mostra-lhe como pode integrar as notificações e dados provenientes da configuração da Azure Digital Twins com Azure Time Series Insights. Em seguida, pode visualizar os valores do sensor ao longo do tempo. Você pode procurar por tendências como qual o quarto que está recebendo mais uso e que são as horas mais movimentadas do dia. Também pode detetar anomalias tais como quais os quartos que se sentem mais abafados e quentes, ou se uma área do seu edifício está enviando valores de temperatura consistentemente elevados, indicando ar condicionado defeituoso.

Neste tutorial, ficará a saber como:

• Transmita os dados utilizando Hubs de Eventos do Azure.
• Analise com insights de séries temporências.

Pré-requisitos

Neste tutorial, parte-se do princípio de que configurou e aprovisionou a sua configuração do Azure Digital Twins. Antes de avançar, confirme que tem:

• Uma conta de Azure.
• Uma instância do Digital Twins em execução.
• As amostras Digital Twins C# descarregadas e extraídas na sua máquina de trabalho.
• .NET Core SDK versão 2.1.403 ou posteriormente na sua máquina de desenvolvimento para executar a amostra. Corra dotnet --version para verificar se a versão certa está instalada.

Dica

Use um nome único de instância digital gémeos se estiver a providenciar um novo exemplo.

Fluxo de dados utilizando centros de eventos

Pode utilizar o serviço Event Hubs para criar um pipeline para transmitir os seus dados. Esta secção mostra-lhe como criar o seu centro de eventos como o conector entre as suas instâncias Azure Digital Twins e Time Series Insights.

Criar um hub de eventos

1. Inicie sessão no portal do Azure.

2. No painel esquerdo, selecione Criar um recurso.

3. Procure e selecione Hubs de Eventos. Selecione Criar.

   

4. Insira um nome para o seu espaço de nomes de Centros de Eventos. Escolha o Standard para o nível de Preços, a sua Subscrição, o grupo de Recursos que usou para a sua instância Digital Twins e a Localização. Selecione Criar.

5. Na implementação do espaço de nomes Do Event Hubs, selecione o painel de visão geral e, em seguida, selecione Ir para o recurso.

   

6. No painel de visão geral do espaço de nome do Event Hubs, selecione o botão Event Hub na parte superior.

7. Insira um Nome para o seu centro de eventos e selecione Criar.

   Após a implantação do centro de eventos, aparece no painel de nomes do Event Hubs com um estatuto Ativo . Selecione este centro de eventos para abrir o painel de visão geral.

8. Selecione o botão de grupo Consumer na parte superior e introduza um nome como tsievents para o grupo de consumidores. Selecione Criar.

   

   Após a criação do grupo de consumidores, aparece na lista na parte inferior do painel de visão geral do centro de eventos.

9. Abra o painel de políticas de acesso compartilhado para o seu centro de eventos e selecione o botão Adicionar . Insira Gerir Como nome de política, certifique-se de que todas as caixas de verificação estão selecionadas e selecione Criar.

   

   Dica

   Verifique se está a criar uma Política SAS para a sua instância do centro de eventos em vez do seu espaço de nome.

10. Abra a política ManageSend que criou e copie os valores para a cadeia De ligação — chave primária e cadeia de ligação — chave secundária para um ficheiro temporário. Você precisará destes valores para criar um ponto final para o centro de eventos na próxima secção.

Criar um ponto final para o centro de eventos

1. Na janela de comando, certifique-se de que está na pasta de arranque rápido de ocupação da amostra Azure Digital Twins.

2. Abra o ficheiro actions\createEndpoints.yaml no editor. Substitua os conteúdos pelo seguinte:

   - type: EventHub
     eventTypes:
     - SensorChange
     - SpaceChange
     - TopologyOperation
     - UdfCustom
     connectionString: Primary_connection_string_for_your_event_hub
     secondaryConnectionString: Secondary_connection_string_for_your_event_hub
     path: Name_of_your_Event_Hub
   - type: EventHub
     eventTypes:
     - DeviceMessage
     connectionString: Primary_connection_string_for_your_event_hub
     secondaryConnectionString: Secondary_connection_string_for_your_event_hub
     path: Name_of_your_Event_Hub
   

3. Substitua os espaços reservados Primary_connection_string_for_your_event_hub pelo valor da cadeia Connection — chave primária para o centro de eventos. Certifique-se de que o formato desta cadeia de ligação é o seguinte:

   Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey1GUID;EntityPath=nameOfYourEventHub
   

4. Substitua os espaços reservados Secondary_connection_string_for_your_event_hub pelo valor da cadeia Connection — chave secundária para o centro de eventos. Certifique-se de que o formato desta cadeia de ligação é o seguinte:

   Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey2GUID;EntityPath=nameOfYourEventHub
   

5. Substitua os espaços reservados Name_of_your_Event_Hub pelo nome do seu Centro de Eventos.

   Importante

   Introduza todos os valores, sem aspas. Certifique-se de que há pelo menos um personagem espacial após os cólons no ficheiro YAML. Também pode validar o seu conteúdo de ficheiro YAML utilizando qualquer validador YAML online, como esta ferramenta.

6. Guarde e feche o ficheiro. Na janela de comandos, execute o comando seguinte e inicie sessão com a sua conta do Azure quando lhe for pedido.

   dotnet run CreateEndpoints
   

   Cria dois pontos finais para o seu centro de eventos.

   

Analisar com o Time Series Insights

1. No painel esquerdo do portal do Azure, selecione Criar um recurso.

2. Procure e selecione um recurso de Disponibilidade Geral de Insights (GA) da Série De Tempo . Selecione Criar.

3. Introduza um Nome para a instância do Time Series Insights e selecione a sua Subscrição. Selecione o grupo de Recursos que usou para a sua instância Digital Twins e a sua localização. Selecione Seguinte: Botão Fonte de Evento ou o separador Fonte de Evento .

   

4. No separador 'Fonte de Eventos ', insira um Nome, selecione o Centro de Eventos como o tipo 'Fonte' e certifique-se de que os outros valores são selecionados corretamente para fazer referência ao hub de eventos que criou. Selecione ManageSend para o nome da política de acesso ao Event Hub e, em seguida, selecione o grupo de consumidores que criou na secção anterior para o grupo de consumidores Event Hub. Selecione Rever + criar.

   

5. No painel 'Revisão + Criar ', revê as informações que introduziu e selecione Criar.

6. No painel de implementação, selecione o recurso Time Series Insights que criou. Abre o painel de visão geral para o seu ambiente de Insights de Séries Tempo.

7. Selecione o botão Ir para o Ambiente na parte superior. Se receber um aviso de acesso a dados, abra o painel de Políticas de Acesso a Dados para a sua instância de Insights de Séries Tempotuais, selecione Add, selecione o Colaborador como função e selecione o utilizador apropriado.

8. O botão Go to Environment abre o explorador Time Series Insights. Se não mostrar quaisquer eventos, simular eventos de dispositivo navegando para o projeto de conectividade do dispositivo da sua amostra De Gémeos Digitais, e executando dotnet run.

9. Depois de gerados alguns eventos simulados, volte ao explorador de Insights da Série De Tempo e selecione o botão de atualização no topo. Os seus gráficos analíticos que estão a ser criados para os seus dados de sensores simulados aparecerão.

   

10. No explorador time series Insights, você pode então gerar gráficos e mapas de calor para diferentes eventos e dados de seus quartos, sensores e outros recursos. Do lado esquerdo, utilize as caixas MEDIDA E SPLIT BY drop-down para criar as suas próprias visualizações.

    Por exemplo, selecione Eventos para MEDIDA e DigitalTwins-SensorHardwareId para SPLIT BY, para gerar um mapa de calor para cada um dos seus sensores. O mapa térmico será semelhante à seguinte imagem:

    

Limpar os recursos

Se quiser parar de explorar as Gémeas Digitais Azure para além deste ponto, sinta-se livre para eliminar os recursos criados neste tutorial:

1. A partir do menu esquerdo no portal do Azure, selecione Todos os recursos, selecione o seu grupo de recursos Digital Twins e, em seguida, selecione Delete.

   Dica

   Se sentiu problemas em eliminar a sua instância Digital Twins, foi lançada uma atualização de serviço com a correção. Por favor, ressalta o seu caso.

2. Se necessário, elimine as aplicações de amostra na sua máquina de trabalho.

Passos seguintes

Vá ao próximo artigo para saber mais sobre gráficos de inteligência espacial e modelos de objetos em Azure Digital Twins.

Understanding Digital Twins object models and spatial intelligence graph (Compreender os modelos de objetos e o gráfico de inteligência espacial do Digital Twins)