Tutorial: Supervisión de los dispositivos IoT Edge

Se aplica a: IoT Edge 1.5

Use Azure Monitor Workbooks para supervisar el estado y el rendimiento de las implementaciones de Azure IoT Edge.

En este tutorial, aprenderá a:

Requisitos previos

Necesita un dispositivo IoT Edge con el módulo de sensor de temperatura simulado implementado. Si no tiene un dispositivo a punto, siga los pasos descritos en Implementación del primer módulo IoT Edge en un dispositivo virtual Linux para crear uno con el uso de una máquina virtual.

Información sobre las métricas de IoT Edge

Cada dispositivo IoT Edge se basa en dos módulos, denominados módulos en tiempo de ejecución, que administran el ciclo de vida y la comunicación de todos los demás módulos de un dispositivo. Estos módulos son el agente de IoT Edge y el centro de IoT Edge. Para obtener más información sobre estos módulos, consulte Información del entorno de ejecución de Azure IoT Edge y su arquitectura.

Ambos módulos en tiempo de ejecución crean métricas que permiten supervisar de forma remota cómo funciona un dispositivo IoT Edge o sus módulos individuales. El agente de IoT Edge informa sobre el estado de los módulos individuales y el dispositivo host, por lo que crea métricas como cuánto tiempo se ejecuta correctamente un módulo, o la cantidad de RAM y el porcentaje de CPU que se usa en el dispositivo. El centro de IoT Edge informa sobre las comunicaciones en el dispositivo, por lo que crea métricas como el número total de mensajes enviados y recibidos, o el tiempo necesario para resolver un método directo. Para obtener la lista completa de métricas disponibles, consulte Acceso a métricas integradas.

Ambos módulos exponen automáticamente estas métricas, por lo que puede crear sus propias soluciones para acceder a ellas e informar sobre ellas. Para facilitar este proceso, Microsoft proporciona el módulo azureiotedge-metrics-collector, que controla este proceso si no tiene o desea una solución personalizada. El módulo recopilador de métricas recopila métricas de los dos módulos en tiempo de ejecución y de cualquier otro módulo que quiera supervisar y los envía fuera del dispositivo.

El módulo recopilador de métricas envía las métricas a la nube de una de estas dos maneras. La primera opción, que se usa en este tutorial, envía las métricas directamente a Log Analytics. La segunda opción solo se recomienda si las directivas de red lo requieren. Envía las métricas a través de IoT Hub y, a continuación, configura una ruta para pasar los mensajes de métrica a Log Analytics. En cualquier caso, una vez que las métricas estén en el área de trabajo de Log Analytics, puede verlas a través de cuadernos de Azure Monitor.

Creación de un área de trabajo de Log Analytics

Un área de trabajo de Log Analytics es necesaria para recopilar datos de métricas, usar un lenguaje de consulta e integrarlo con Azure Monitor para que pueda supervisar los dispositivos.

1. Inicie sesión en Azure Portal.

2. Busque áreas de trabajo de Log Analytics y selecciónela.

3. Seleccione Crear y siga las indicaciones para crear una nueva área de trabajo.

4. Cuando el área de trabajo esté lista, seleccione Ir al recurso.

5. En el menú principal, en Configuración, seleccione Agentes.

6. Copie los valores de ID de espacio de trabajo y clave primaria en las instrucciones del agente de Log Analytics. Estos valores se usan más adelante en el tutorial para configurar el módulo recopilador de métricas para enviar métricas a esta área de trabajo.

Recuperación del id. de recurso del centro de IoT

Al configurar el módulo recopilador de métricas, escriba el id. de recurso de Azure Resource Manager de su centro de IoT. Obtenga ese identificador ahora.

1. En Azure Portal, vaya hasta su instancia de IoT Hub.

2. En Configuración, seleccione Propiedades.

3. Copie el valor de Id. de recurso. El formato es /subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IoTHubs/<iot_hub_name>.

Implementación del módulo recopilador de métricas

Implemente el módulo del recopilador de métricas en cada dispositivo que quiera supervisar. Se ejecuta en el dispositivo como cualquier otro módulo y supervisa sus puntos de conexión asignados para que las métricas recopilen y envíen a la nube.

Siga estos pasos para implementar y configurar el módulo recopilador:

1. Inicie sesión en Azure Portal y vaya al centro de IoT.

1.En Administración de dispositivos, seleccione Dispositivos.

1. Seleccione el identificador de dispositivo del dispositivo de destino en la lista de dispositivos IoT Edge para abrir la página de detalles del dispositivo.

2. En la barra de menús, seleccione Establecer módulos.

3. El primer paso para implementar módulos desde el portal es declarar qué módulos están en un dispositivo. Si usa el mismo dispositivo que creó en el inicio rápido, ya verá SimulatedTemperatureSensor en la lista. Si no está, agréguela ahora:

   1. En la sección Módulos de IoT Edge , seleccione Agregar y, después, elija Módulo ioT Edge.

   2. Actualice la siguiente configuración del módulo:

      Configuración	Valor
      Nombre del módulo de IoT	SimulatedTemperatureSensor
      URI de imagen	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
      Directiva de reinicio	Siempre
      Estado deseado	en ejecución

   3. Seleccione Siguiente: Rutas para continuar configurando rutas.

   4. Agregue una ruta que envíe todos los mensajes desde el módulo de temperatura simulado a IoT Hub.

      Configuración	Valor
      NOMBRE	SimulatedTemperatureSensorToIoTHub
      Valor	FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

4. Agregue y configure el módulo recopilador de métricas:

   1. Seleccione Agregar y, a continuación, elija Módulo IoT Edge.

   2. Busque y seleccione Recopilador de métricas de IoT Edge.

   3. Actualice la siguiente configuración del módulo:

      Configuración	Valor
      Nombre del módulo de IoT	IoTEdgeMetricsCollector
      URI de imagen	mcr.microsoft.com/azureiotedge-metrics-collector:latest
      Directiva de reinicio	Siempre
      Estado deseado	en ejecución

   Para usar una versión o arquitectura diferentes del módulo recopilador de métricas, busque imágenes disponibles en el Registro de artefactos de Microsoft.

   1. Vaya a la pestaña Variables de entorno .

   2. Agregue las siguientes variables de entorno de tipo de texto:

      NOMBRE	Valor
      ResourceId	El id. de recurso del centro de IoT que recuperó en una sección anterior.
      UploadTarget	AzureMonitor
      LogAnalyticsWorkspaceId	El id. del área de trabajo de Log Analytics que recuperó en una sección anterior.
      LogAnalyticsSharedKey	La clave de Log Analytics que recuperó en una sección anterior.

      Para obtener más información sobre la configuración de variables de entorno, consulte configuración del recopilador de métricas.

   3. Seleccione Aplicar para guardar los cambios.

   Nota:

   Para enviar métricas a través de IoT Hub, agregue una ruta a upstream similar a FROM /messages/modules/< FROM_MODULE_NAME >/* INTO $upstream. En este tutorial, las métricas se envían directamente a Log Analytics, por lo que esta ruta no es necesaria.

5. Seleccione Revisar y crear para continuar con el paso final de la implementación de módulos.

6. Seleccione Crear para finalizar la implementación.

Después de finalizar la implementación de los módulos, vuelva a la página de detalles del dispositivo, donde verá cuatro módulos enumerados como Especificado en Implementación. Los cuatro módulos pueden tardar unos minutos en aparecer como Notificados por dispositivo, lo que significa que se han iniciado y notificado su estado a IoT Hub. Actualice la página para ver el estado más reciente.

Supervisar el estado del dispositivo

Los libros de supervisión de dispositivos pueden tardar hasta quince minutos en poder visualizarse. Después de implementar el módulo del recopilador de métricas, comienza a enviar mensajes de métricas a Log Analytics, donde se organizan en una tabla. El identificador de recurso de IoT Hub que proporciona vincula las métricas ingeridas al centro correcto. Por lo tanto, los libros de trabajo personalizados de IoT Edge recuperan métricas mediante la consulta de la tabla de métricas con el identificador de recurso.

Azure Monitor proporciona tres plantillas de libro predeterminadas para IoT:

• El libro Fleet View (Vista de flota) muestra el estado de los dispositivos en distintos recursos de IoT. La vista le permite establecer umbrales para el estado del dispositivo y muestra agregaciones de métricas principales por dispositivo.
• El libro Detalles del dispositivo muestra visualizaciones para mensajería, módulos y host. La vista de mensajería visualiza las rutas de mensaje para un dispositivo e informa sobre el estado general del sistema de mensajería. La vista módulos muestra cómo funcionan los módulos individuales de un dispositivo. La vista host muestra información sobre el dispositivo host, incluida la información de versión para los componentes host y el uso de recursos.
• El libro Alertas presenta alertas para dispositivos en distintos recursos de IoT.

Exploración de la vista de flota y los libros de instantáneas de mantenimiento

El libro de vista de flota muestra todos los dispositivos y le permite seleccionar dispositivos específicos para ver sus instantáneas de mantenimiento. Siga estos pasos para explorar las visualizaciones del libro:

1. Vaya a la página de IoT Hub en Azure Portal.

2. En el menú principal, desplácese hacia abajo hasta la sección Supervisión y seleccione Cuadernos.

   

3. Seleccione el libro Fleet View (Vista de flota).

4. Verá el dispositivo que ejecuta el módulo recopilador de métricas. El dispositivo aparece en la lista como correcto o incorrecto.

5. Seleccione el nombre del dispositivo para ver las métricas detalladas.

6. En cualquier gráfico de tiempo, use los iconos de flecha bajo el eje X o seleccione el gráfico y arrastre el cursor para cambiar el intervalo de tiempo.

   

7. Cierre el libro de instantáneas de mantenimiento. En el libro de vista de flota, seleccione Libros para volver a la galería de libros.

Explore el libro de detalles del dispositivo

El libro de detalles del dispositivo muestra los detalles de rendimiento de un dispositivo individual. Siga estos pasos para explorar las visualizaciones del libro:

1. En la galería de libros, seleccione el libro de Detalles del dispositivo IoT Edge.

2. La primera página del libro de detalles del dispositivo es la vista de mensajería con la pestaña enrutamiento seleccionada.

   A la izquierda, una tabla muestra las rutas en el dispositivo, organizadas por punto de conexión. Para este dispositivo, el punto de conexión ascendente, utilizado para el enrutamiento hacia IoT Hub, recibe mensajes desde la salida temperatureOutput del módulo del sensor de temperatura simulado.

   A la derecha, un gráfico muestra el número de clientes conectados a lo largo del tiempo. Seleccione y arrastre el gráfico para cambiar el intervalo de tiempo.

   

3. Seleccione la pestaña gráfico para ver una visualización diferente de las rutas. En la página del gráfico, arrastra y suelta los extremos para reorganizar el gráfico. Esta característica ayuda cuando tiene muchas rutas para visualizar.

   

4. La pestaña estado muestra cualquier problema con la mensajería, como mensajes quitados o clientes desconectados.

5. Seleccione la vista módulos para ver el estado de todos los módulos implementados en el dispositivo. Seleccione un módulo para ver los detalles sobre su uso de CPU y memoria.

   

6. Seleccione la vista de host para ver información sobre el dispositivo de host, incluido su sistema operativo, la versión del demonio de IoT Edge y el uso de recursos.

Vista de los registros del módulo

Después de ver las métricas de un dispositivo, es posible que quiera profundizar más e inspeccionar los módulos individuales. IoT Edge proporciona asistencia para la solución de problemas en Azure Portal con una característica de registro de módulos en directo.

1. En el libro de detalles del dispositivo, seleccione Solucionar problemas en directo.

   

2. La página de solución de problemas se abre con los registros de edgeAgent del dispositivo de IoT Edge. Si selecciona un intervalo de tiempo específico en el libro de detalles del dispositivo, esa configuración pasa a la página de solución de problemas.

3. Use el menú desplegable para cambiar a los registros de otros módulos que se ejecutan en el dispositivo y use el botón Reiniciar para reiniciar un módulo.

   

También puede acceder a la página de solución de problemas desde la página de detalles de un dispositivo IoT Edge. Para más información, consulte Solución de problemas de dispositivos IoT Edge desde Azure Portal.

Pasos siguientes

A medida que pase por el resto de los tutoriales, mantenga el módulo recopilador de métricas en los dispositivos y vuelva a estos libros para ver cómo cambia la información al agregar módulos y enrutamiento más complejos.

Vaya al siguiente tutorial para configurar el entorno de desarrollador e inicie la implementación de módulos personalizados en los dispositivos.