Tutorial: Visualización y análisis de eventos de los espacios de Azure Digital Twins mediante Time Series InsightsTutorial: Visualize and analyze events from your Azure Digital Twins spaces by using Time Series Insights

Después de implementar la instancia de Azure Digital Twins, aprovisionar los espacios e implementar una función personalizada para supervisar condiciones concretas, puede visualizar los eventos y los datos procedentes de los espacios para buscar tendencias y anomalías.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.

En el primer tutorial, configuró el grafo espacial de un edificio imaginario con una sala que contiene sensores de movimiento, temperatura y dióxido de carbono.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. En el segundo tutorial, aprovisionó el grafo y una función definida por el usuario.In the second tutorial, you provisioned your graph and a user-defined function. La función supervisa estos valores del sensor y desencadena notificaciones cuando se dan las condiciones adecuadas.The function monitors these sensor values and triggers notifications for the right conditions. Es decir, la sala está vacía y los niveles de temperatura y dióxido de carbono son normales.That is, the room is empty, and the temperature and carbon dioxide levels are normal.

En este tutorial se muestra cómo puede integrar las notificaciones y los datos procedentes de la configuración de Azure Digital Twins con 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. Luego, puede visualizar los valores del sensor con el paso del tiempo.You can then visualize your sensor values over time. Puede buscar tendencias, como qué sala se usa más y cuáles son las horas más ocupadas del día.You can look for trends such as which room is getting the most use and which are the busiest times of the day. También puede detectar anomalías como qué salas están más cargadas y calientes o, si un área del edificio está enviando constantemente valores de temperatura alta que indican que el aire acondicionado está defectuoso.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.

En este tutorial, aprenderá a:In this tutorial, you learn how to:

  • Transmitir datos mediante Azure Event HubsStream data by using Azure Event Hubs.
  • Analizar con Time Series InsightsAnalyze with Time Series Insights.

Requisitos previosPrerequisites

En este tutorial se supone que ha configurado y aprovisionado Azure Digital Twins.This tutorial assumes that you have configured and provisioned your Azure Digital Twins setup. Antes de continuar, asegúrese de que:Before proceeding, make sure that you have:

Transmisión de datos mediante Event HubsStream data by using Event Hubs

Puede usar el servicio Event Hubs para crear una canalización para transmitir sus datos.You can use the Event Hubs service to create a pipeline to stream your data. En esta sección se muestra cómo crear un centro de eventos como conector entre las instancias de Azure Digital Twins y 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.

Creación de un centro de eventosCreate an event hub

  1. Inicie sesión en el Azure Portal.Sign in to the Azure portal.

  2. En el panel izquierdo, seleccione Crear un recurso.In the left pane, select Create a resource.

  3. Busque Event Hubs y selecciónelo.Search for and select Event Hubs. Seleccione Crear.Select Create.

  4. Escriba un nombre para el espacio de nombres de Event Hubs.Enter a Name for your Event Hubs namespace. Elija Estándar en Plan de tarifa, la suscripción, el grupo de recursos que usó para la instancia de Digital Twins y la ubicación.Choose Standard for Pricing tier, your Subscription, the Resource group that you used for your Digital Twins instance, and the Location. Seleccione Crear.Select Create.

  5. En la implementación del espacio de nombres de Event Hubs, seleccione el espacio de nombres en RECURSO.In the Event Hubs namespace deployment, select the namespace under RESOURCE.

    Espacio de nombres de Event Hubs después de la implementación

  6. En el panel Información general del espacio de nombres de Event Hubs, haga clic en el botón Centro de eventos de la parte superior.In the Event Hubs namespace Overview pane, select the Event Hub button at the top. Botón Centro de eventosEvent Hub button

  7. Escriba el nombre del centro de eventos y haga clic en Crear.Enter a Name for your event hub, and select Create.

    Una vez implementado el centro de eventos, aparece en el panel Event Hubs del espacio de nombres de Event Hubs con un estado Activo.After the event hub is deployed, it appears in the Event Hubs pane of the Event Hubs namespace with an Active status. Seleccione este centro de eventos para abrir su panel Información general.Select this event hub to open its Overview pane.

  8. Haga clic en el botón Grupo de consumidores de la parte superior y escriba un nombre como tsievents para el grupo de consumidores.Select the Consumer group button at the top, and enter a name such as tsievents for the consumer group. Seleccione Crear.Select Create.

    Grupo de consumidores de Event Hubs

    Una vez creado el grupo de consumidores, aparece en la lista de la parte inferior del panel Información general del centro 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 el panel Directivas de acceso compartido del centro de eventos y haga clic en el botón Agregar.Open the Shared access policies pane for your event hub, and select the Add button. Escriba ManageSend como nombre de la directiva, asegúrese de que todas las casillas estén activadas y seleccione Crear.Enter ManageSend as the policy name, make sure all the check boxes are selected, and select Create.

    Cadenas de conexión de Event Hub

  10. Abra la directiva ManageSend que ha creado y copie los valores de Cadena de conexión: clave principal y Cadena de conexión: clave secundaria en un archivo temporal.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. Necesitará estos valores para crear un punto de conexión para el centro de eventos en la sección siguiente.You'll need these values to create an endpoint for the event hub in the next section.

Creación de un punto de conexión para el centro de eventosCreate an endpoint for the event hub

  1. En la ventana de comandos, asegúrese de que se encuentra en la carpeta occupancy-quickstar\src del ejemplo de Azure Digital Twins.In the command window, make sure you're in the occupancy-quickstart\src folder of the Azure Digital Twins sample.

  2. Abra el archivo actions\createEndpoints.yaml en el editor.Open the file actions\createEndpoints.yaml in your editor. Reemplace el contenido por el siguiente: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. Reemplace los marcadores de posición Primary_connection_string_for_your_event_hub por el valor de Cadena de conexión: clave principal del centro de eventos.Replace the placeholders Primary_connection_string_for_your_event_hub with the value of Connection string--primary key for the event hub. Asegúrese de que el formato de esta cadena de conexión sea como este:Make sure the format of this connection string is as follows:

    Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey1GUID;EntityPath=nameOfYourEventHub
    
  4. Reemplace los marcadores de posición Secondary_connection_string_for_your_event_hub por el valor de Cadena de conexión: clave secundaria del centro de eventos.Replace the placeholders Secondary_connection_string_for_your_event_hub with the value of Connection string--secondary key for the event hub. Asegúrese de que el formato de esta cadena de conexión sea como este:Make sure the format of this connection string is as follows:

    Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey2GUID;EntityPath=nameOfYourEventHub
    
  5. Reemplace los marcadores de posición Name_of_your_Event_Hub por el nombre de su centro de eventos.Replace the placeholders Name_of_your_Event_Hub with the name of your Event Hub.

    Importante

    Escriba todos los valores sin comillas.Enter all values without any quotes. Asegúrese de que hay al menos un carácter de espacio después de los signos de dos puntos en el archivo YAML.Make sure there's at least one space character after the colons in the YAML file. También puede validar el contenido del archivo YAML mediante cualquier control de servidor de validación de YAML, como esta herramienta.You can also validate your YAML file contents by using any online YAML validator, such as this tool.

  6. Guarde y cierre el archivo.Save and close the file. Ejecute el comando siguiente en la ventana de comandos, e inicie sesión con su cuenta de Azure cuando se le solicite.Run the following command in the command window, and sign in with your Azure account when prompted.

    dotnet run CreateEndpoints
    

    Este comando crea dos puntos de conexión para el centro de eventos.It creates two endpoints for your event hub.

    Puntos de conexión de Event Hubs

Análisis con Time Series InsightsAnalyze with Time Series Insights

  1. En el panel izquierdo de Azure Portal, seleccione Crear un recurso.In the left pane of the Azure portal, select Create a resource.

  2. Busque un nuevo recurso de Time Series Insights y selecciónelo.Search for and select a new Time Series Insights resource. Seleccione Crear.Select Create.

  3. Escriba el nombre de la instancia de Time Series Insights seleccione su suscripción.Enter a Name for your Time Series Insights instance, and then select your Subscription. Seleccione el grupo de recursos que usó o para su instancia de Digital Twins y su ubicación.Select the Resource group that you used for your Digital Twins instance, and your Location. Seleccione Crear.Select Create.

    Selecciones para crear una instancia de Time Series Insights

  4. Después de implementar la instancia, abra el entorno de Time Series Insights y abra su panel Event Sources (Orígenes de eventos).After the instance is deployed, open the Time Series Insights environment, and then open its Event Sources pane. Haga clic en el botón Add (Agregar) de la parte superior para agregar un grupo de consumidores.Select the Add button at the top to add a consumer group.

  5. En el panel Nuevo origen de eventos, escriba un nombrey asegúrese de que los demás valores se seleccionan correctamente.In the New event source pane, enter a Name, and make sure the other values are selected correctly. Seleccione ManageSend en Event hub policy name (Nombre de directiva de centro de eventos) y, después, seleccione el grupo de consumidores que creó en la sección anterior en Event hub consumer group (Grupo de consumidores del centro de eventos).Select ManageSend for Event hub policy name, and then select the consumer group that you created in the previous section for Event hub consumer group. Seleccione Crear.Select Create.

    Selecciones para la creación de un origen de evento

  6. Abra el panel Overview (Información general) del entorno de Time Series Insights y haga clic en el botón Go to Environment (Ir al entorno) de la parte superior.Open the Overview pane for your Time Series Insights environment, and select the Go to Environment button at the top. Si recibe una advertencia sobre el acceso a los datos, abra el panel Data Access Policies (Directivas de acceso de datos) de la instancia de Time Series Insights, haga clic en Add (Agregar), seleccione Contributor (Colaborador) como rol y seleccione el usuario apropiado.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.

  7. El botón Go to Environment (Ir al entorno) abre el explorador de Time Series Insights.The Go to Environment button opens the Time Series Insights explorer. Si no se muestra ningún evento, simule eventos del dispositivo; para ello, vaya al proyecto device-connectivity del ejemplo de Digital Twins y ejecute 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.

  8. Cuando se hayan generado algunos eventos simulados, vuelva al explorador de Time Series Insights y haga clic en el botón de actualización de la 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. Verá que se crean gráficos analíticos para los datos de los sensores simulados.You should see analytical charts being created for your simulated sensor data.

    Gráfico del explorador de Time Series Insights

  9. En el explorador de Time Series Insights, puede generar gráficos y mapas térmicos para diferentes eventos y datos de las salas, los sensores y otros 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. En el lado izquierdo, use los cuadros desplegables MEASURE (MEDIDA) y SPLIT BY (DIVIDIR POR) para crear sus propias visualizaciones.On the left side, use the MEASURE and SPLIT BY drop-down boxes to create your own visualizations.

    Por ejemplo, seleccione Events (Eventos) en MEASURE (MEDIDA) y DigitalTwins-SensorHardwareId en SPLIT BY (DIVIDIDO POR), para generar un mapa térmico para cada uno de los sensores.For example, select Events for MEASURE and DigitalTwins-SensorHardwareId for SPLIT BY, to generate a heatmap for each of your sensors. El mapa térmico será similar a la siguiente imagen:The heatmap will be similar to the following image:

    Mapa término del explorador de Time Series Insights

Limpieza de recursosClean up resources

Si desea dejar de explorar Azure Digital Twins en este punto, elimine los recursos creados en este tutorial:If you want to stop exploring Azure Digital Twins beyond this point, feel free to delete resources created in this tutorial:

  1. En el menú izquierdo de Azure Portal, haga clic en Todos los recursos, seleccione el grupo de recurso de Digital Twins y haga clic en Eliminar.From the left menu in the Azure portal, select All resources, select your Digital Twins resource group, and then select Delete.

    Sugerencia

    Si tiene problemas al eliminar una instancia de Digital Twins, se ha incorporado una actualización del servicio con la corrección.If you experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. Vuelva a intentar eliminar la instancia.Please retry deleting your instance.

  2. Si es necesario, elimine las aplicaciones de ejemplo en la máquina de trabajo.If necessary, delete the sample applications on your work machine.

Pasos siguientesNext steps

Vaya al siguiente artículo para aprender más sobre los grafos de inteligencia espacial y los modelos de objetos en Azure Digital Twins.Go to the next article to learn more about spatial intelligence graphs and object models in Azure Digital Twins.