Tutorial: Visualizar e analisar eventos de espaços dos Gêmeos Digitais do Azure usando o Time Series InsightsTutorial: Visualize and analyze events from your Azure Digital Twins spaces by using Time Series Insights

Depois de implantar a instância de Gêmeos Digitais do Azure, provisionar seus espaços e implementar a função personalizada para monitorar condições específicas, você pode visualizar os eventos e os dados provenientes de seus espaços em busca de tendências e anomalias.After you deploy your Azure Digital Twins instance, provision your spaces, and implement a custom function to monitor specific conditions, you can visualize the events and data coming from your spaces to look for trends and anomalies.

No primeiro tutorial, você configurou o grafo espacial de um prédio imaginário, com uma sala que contém sensores de movimento, dióxido de carbono e temperatura.In the first tutorial, you configured the spatial graph of an imaginary building, with a room that contains sensors for motion, carbon dioxide, and temperature. No segundo tutorial, você provisionou o grafo e uma função definida pelo usuário.In the second tutorial, you provisioned your graph and a user-defined function. A função monitora esses valores de sensor e dispara notificações sob as condições corretas.The function monitors these sensor values and triggers notifications for the right conditions. Ou seja, a sala está vazia e os níveis de temperatura e dióxido de carbono estão normais.That is, the room is empty, and the temperature and carbon dioxide levels are normal.

Este tutorial mostra como você pode integrar as notificações e os dados provenientes da configuração dos Gêmeos Digitais do Azure com o Azure Time Series Insights.This tutorial shows you how you can integrate the notifications and data coming from your Azure Digital Twins setup with Azure Time Series Insights. Em seguida, você pode visualizar os valores de sensor ao longo do tempo.You can then visualize your sensor values over time. Você pode procurar tendências, como qual sala é a mais usada e quais são os horários mais cheios do dia.You can look for trends such as which room is getting the most use and which are the busiest times of the day. Você também pode detectar anomalias, como quais salas ficam mais abafadas ou quentes ou se alguma área do seu prédio está enviando valores de temperatura consistentemente altos, indicando que o ar-condicionado está com defeito.You can also detect anomalies such as which rooms feel stuffier and hotter, or whether an area in your building is sending consistently high temperature values, indicating faulty air conditioning.

Neste tutorial, você aprenderá como:In this tutorial, you learn how to:

  • Transmitir dados por streaming usando os Hubs de Eventos do Azure.Stream data by using Azure Event Hubs.
  • Analisar com o Time Series Insights.Analyze with Time Series Insights.

Pré-requisitosPrerequisites

Este tutorial pressupõe que você configurou e provisionou sua configuração dos Gêmeos Digitais do Azure.This tutorial assumes that you have configured and provisioned your Azure Digital Twins setup. Antes de prosseguir, verifique se você tem:Before proceeding, make sure that you have:

Dica

Use um nome de instância dos Gêmeos Digitais exclusivo quando estiver provisionando uma nova instância.Use a unique Digital Twins instance name if you're provisioning a new instance.

Transmitir dados por streaming usando os Hubs de EventosStream data by using Event Hubs

Você pode usar o serviço Hubs de Eventos para criar um pipeline para transmitir os dados.You can use the Event Hubs service to create a pipeline to stream your data. Esta seção mostra como criar seu hub de eventos como o conector entre os Gêmeos Digitais do Azure e as instâncias do Time Series Insights.This section shows you how to create your event hub as the connector between your Azure Digital Twins and Time Series Insights instances.

Criar um Hub de EventoCreate an event hub

  1. Entre no Portal do Azure.Sign in to the Azure portal.

  2. No painel esquerdo, selecione Criar um recurso.In the left pane, select Create a resource.

  3. Pesquise e selecione Hubs de Eventos.Search for and select Event Hubs. Selecione Criar.Select Create.

  4. Insira um Nome para o namespace dos Hubs de Eventos.Enter a Name for your Event Hubs namespace. Escolha Standard como Tipo de preço, sua Assinatura, o Grupo de recursos que você usou para sua instância dos Gêmeos Digitais e o Local.Choose Standard for Pricing tier, your Subscription, the Resource group that you used for your Digital Twins instance, and the Location. Selecione Criar.Select Create.

  5. Na implantação de namespace dos Hubs de eventos, selecione o painel Visão geral e, em seguida, selecione Ir para o recurso.In the Event Hubs namespace deployment, select the Overview pane, then select Go to resource.

    Namespace dos Hubs de Eventos após a implantaçãoEvent Hubs namespace after deployment

  6. No painel Visão geral do namespace dos Hubs de Eventos, selecione o botão Hub de Eventos na parte superior.In the Event Hubs namespace Overview pane, select the Event Hub button at the top. Botão Hub de EventosEvent Hub button

  7. Insira um Nome para o seu hub de eventos e selecione Criar.Enter a Name for your event hub, and select Create.

    Uma vez implantado, ele aparecerá no painel Hubs de Eventos do namespace dos Hubs de Eventos com um status Ativo.After the event hub is deployed, it appears in the Event Hubs pane of the Event Hubs namespace with an Active status. Selecione o hub de eventos para abrir seu painel Visão geral.Select this event hub to open its Overview pane.

  8. Selecione o botão Grupo de consumidores na parte superior e digite um nome, como tsievents, para o grupo de consumidores.Select the Consumer group button at the top, and enter a name such as tsievents for the consumer group. Selecione Criar.Select Create.

    Grupo de consumidores do Hub de EventosEvent Hub consumer group

    Depois de criado, o grupo de consumidores aparecerá na lista, na parte inferior do painel Visão geral do hub de eventos.After the consumer group is created, it appears in the list at the bottom of the event hub's Overview pane.

  9. Abra o painel Políticas de acesso compartilhadas do hub de eventos e selecione o botão Adicionar.Open the Shared access policies pane for your event hub, and select the Add button. Insira ManageSend como o nome da política, verifique se todas as caixas de seleção estão selecionadas e selecione Criar.Enter ManageSend as the policy name, make sure all the check boxes are selected, and select Create.

    Cadeias de conexão do Hub de EventosEvent Hub connection strings

  10. Abra a política ManageSend que você criou e copie os valores da Cadeia de conexão – chave primária e Cadeia de conexão – chave secundária para um arquivo temporário.Open the ManageSend policy that you created, and copy the values for Connection string--primary key and Connection string--secondary key to a temporary file. Você precisará desses valores para criar um ponto de extremidade para o hub de eventos na próxima seção.You'll need these values to create an endpoint for the event hub in the next section.

Criar um ponto de extremidade para o hub de eventosCreate an endpoint for the event hub

  1. Na janela de comando, verifique se você está na pasta occupancy-quickstart\src do exemplo dos Gêmeos Digitais do Azure.In the command window, make sure you're in the occupancy-quickstart\src folder of the Azure Digital Twins sample.

  2. Abra o arquivo actions\createEndpoints.yaml no editor.Open the file actions\createEndpoints.yaml in your editor. Substitua o conteúdo pelo seguinte:Replace the contents with the following:

    - 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 de conexão – chave primária para o hub de eventos.Replace the placeholders Primary_connection_string_for_your_event_hub with the value of Connection string--primary key for the event hub. Verifique se o formato dessa cadeia de conexão é o seguinte:Make sure the format of this connection string is as follows:

    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 de conexão – chave secundária para o hub de eventos.Replace the placeholders Secondary_connection_string_for_your_event_hub with the value of Connection string--secondary key for the event hub. Verifique se o formato dessa cadeia de conexão é o seguinte:Make sure the format of this connection string is as follows:

    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 Hub de Eventos.Replace the placeholders Name_of_your_Event_Hub with the name of your Event Hub.

    Importante

    Insira todos os valores sem aspas.Enter all values without any quotes. Verifique se há pelo menos um caractere de espaço após os dois-pontos no arquivo YAML.Make sure there's at least one space character after the colons in the YAML file. Você também pode validar o conteúdo do arquivo YAML usando qualquer validador YAML online, como esta ferramenta.You can also validate your YAML file contents by using any online YAML validator, such as this tool.

  6. Salve e feche o arquivo.Save and close the file. Execute o seguinte comando na janela de comando e entre com sua conta do Azure quando solicitado.Run the following command in the command window, and sign in with your Azure account when prompted.

    dotnet run CreateEndpoints
    

    Ele cria dois pontos de extremidade para seu hub de eventos.It creates two endpoints for your event hub.

    Pontos de extremidade para os Hubs de EventosEndpoints for Event Hubs

Analisar com o Time Series InsightsAnalyze with Time Series Insights

  1. No painel esquerdo do portal do Azure, selecione Criar um recurso.In the left pane of the Azure portal, select Create a resource.

  2. Pesquise e selecione um recurso de GA (disponibilidade geral) do Time Series Insights.Search for and select a Time Series Insights General Availability (GA) resource. Selecione Criar.Select Create.

  3. Insira um Nome para a instância do Time Series Insights e selecione a Assinatura.Enter a Name for your Time Series Insights instance, and then select your Subscription. Selecione o Grupo de recursos que você usou para a instância dos Gêmeos Digitais e seu Local.Select the Resource group that you used for your Digital Twins instance, and your Location. Selecione Avançar: Botão Origem do evento ou a guia Origem do evento.Select Next: Event Source button or the Event Source tab.

    Seleções para criar uma instância do Time Series InsightsSelections for creating a Time Series Insights instance

  4. Na guia Origem do evento, insira um nome, selecione Hub de eventos como o Tipo de fonte e verifique se os outros valores estão selecionados corretamente.In the Event Source tab, enter a Name, select Event Hub as the Source type, and make sure the other values are selected correctly. Selecione ManageSend como o Nome de política de acesso do hub de eventos e selecione o grupo de consumidores criado na seção anterior como o Grupo de consumidores do hub de eventos.Select ManageSend for Event Hub access policy name, and then select the consumer group that you created in the previous section for Event Hub consumer group. Selecione Examinar + criar.Select Review + create.

    Seleções para criar uma fonte de eventoSelections for creating an event source

  5. No painel Revisar + criar, examine as informações inseridas e selecione Criar.In the Review + Create pane, review the information you entered, and select Create.

  6. No painel de implantação, selecione o recurso de Time Series Insights que você acabou de criar.In the deployment pane, select the Time Series Insights resource you just created. Ele abre o painel Visão geral do ambiente do Time Series Insights.It opens the Overview pane for your Time Series Insights environment.

  7. Selecione o botão Ir para o ambiente na parte superior.Select the Go to Environment button at the top. Se você receber um aviso de acesso a dados, abra o painel Políticas de acesso de dados da instância do Time Series Insights, selecione Adicionar, selecione Colaborador como a função e selecione o usuário apropriado.If you get a data access warning, open the Data Access Policies pane for your Time Series Insights instance, select Add, select Contributor as the role, and select the appropriate user.

  8. O botão Ir para o ambiente abre o explorador do Time Series Insights.The Go to Environment button opens the Time Series Insights explorer. Se ele não mostrar eventos, simule eventos de dispositivo navegando até o projeto device-connectivity do exemplo dos Gêmeos Digitais e execute dotnet run.If it doesn't show any events, simulate device events by browsing to the device-connectivity project of your Digital Twins sample, and running dotnet run.

  9. Depois de alguns eventos simulados serem gerados, volte para o explorador do Time Series Insights e selecione o botão Atualizar na parte superior.After a few simulated events are generated, go back to the Time Series Insights explorer, and select the refresh button at the top. Você deve ver gráficos analíticos sendo criados para seus dados de sensor simulado.You should see analytical charts being created for your simulated sensor data.

    Gráfico no Gerenciador do Time Series InsightsChart in the Time Series Insights explorer

  10. No explorer do Time Series Insights, é possível gerar gráficos e mapas de calor para diferentes eventos e dados de suas salas, sensores e outros recursos.In the Time Series Insights explorer, you can then generate charts and heatmaps for different events and data from your rooms, sensors, and other resources. No lado esquerdo, use as listas suspensas MEDIDA e DIVIDIR POR para criar suas próprias visualizações.On the left side, use the MEASURE and SPLIT BY drop-down boxes to create your own visualizations.

    Por exemplo, selecione Eventos como MEDIDA e DigitalTwins-SensorHardwareId como DIVIDIR POR para gerar um mapa de calor para cada um dos sensores.For example, select Events for MEASURE and DigitalTwins-SensorHardwareId for SPLIT BY, to generate a heatmap for each of your sensors. O mapa de calor será semelhante à seguinte imagem:The heatmap will be similar to the following image:

    Mapa de calor no Gerenciador do Time Series InsightsHeatmap in the Time Series Insights explorer

Limpar recursosClean up resources

Se quiser parar de explorar os Gêmeos Digitais do Azure além desse ponto, você poderá excluir os recursos criados neste tutorial:If you want to stop exploring Azure Digital Twins beyond this point, feel free to delete resources created in this tutorial:

  1. No menu à esquerda no portal do Azure, selecione Todos os recursos, selecione o grupo de recursos dos Gêmeos Digitais e selecione Excluir.From the left menu in the Azure portal, select All resources, select your Digital Twins resource group, and then select Delete.

    Dica

    Se você teve problemas para excluir sua instância de Gêmeos Digitais, lançamos uma atualização de serviço com a correção.If you experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. Tente novamente excluir a instância.Please retry deleting your instance.

  2. Se necessário, exclua os aplicativos de exemplo em seu computador de trabalho.If necessary, delete the sample applications on your work machine.

Próximas etapasNext steps

Vá para o próximo artigo para saber mais sobre grafos de inteligência espacial e modelos de objeto nos Gêmeos Digitais do Azure.Go to the next article to learn more about spatial intelligence graphs and object models in Azure Digital Twins.