Encuentra y arregla dispositivos que faltan en Device Update for IoT Hub usando la comprobación de agentes

Aprende a usar la función de verificación de agentes para encontrar, diagnosticar y arreglar dispositivos que faltan en tu instancia de Actualización de Dispositivos para IoT Hub.

Prerequisites

Note

La función de comprobación del agente solo puede realizar comprobaciones de validación en dispositivos que tengan instalado el agente de Actualización de Dispositivos y que informen de un ID de modelo PnP que coincida con los compatibles con Device Update for IoT Hub.

Exploradores admitidos:

Comprobaciones de validación soportadas por la verificación del agente

La función de verificación del agente realiza actualmente las siguientes comprobaciones de validación en todos los dispositivos que cumplen con los requisitos anteriores.

Comprobación de validación Criteria
ID de modelo PnP El ID del modelo PnP es una cadena que el agente de Actualización de Dispositivos reporta al gemelo de dispositivo y describe qué modelo PnP debe usarse para la comunicación entre dispositivos y nubes. Esta cadena debe ser un identificador de modelo digital twin (DTMI) válido que soporte la interfaz de Actualización de Dispositivos.
ID de interfaz El ID de la interfaz es una cadena que el agente de Actualización de Dispositivo reporta al gemelo de dispositivos y describe qué versión de la interfaz de Actualización de Dispositivo debe usarse para la comunicación entre dispositivos y nube. Esta cadena debe ser un DTMI válido que soporte la interfaz de Actualización de Dispositivos.
Nombres de propiedades de compatibilidad CompatPropertyNames es un campo que el agente de Device Update comunica al gemelo del dispositivo. Describe qué deviceProperties campos usar para determinar la compatibilidad del dispositivo con un despliegue determinado. El valor de este campo debe ser una cadena de nombres delimitados por comas. La cadena debe contener al menos uno y no más de cinco nombres. Cada nombre debe tener menos de 32 caracteres.
Valores de propiedades de compatibilidad Los valores de la propiedad de compatibilidad son los pares campo: valor especificados por el campo compatPropertyNames y notificados por el agente de Device Update al gemelo del dispositivo como deviceProperties. Cada nombre definido en los nombres de propiedades de compatibilidad debe tener un par campo:valor correspondiente reportado. El valor de cada par está limitado a 64 caracteres.
Grupo ADU La etiqueta de grupo de ADU es una etiqueta opcional que se define en el gemelo del dispositivo. Determina a qué grupo de dispositivos pertenece el dispositivo. Si se especifica, la cadena de etiquetas está limitada a 255 caracteres y solo puede contener caracteres alfanuméricos y los siguientes caracteres especiales: "." "-" "_" "~"

Si un dispositivo no cumple alguno de estos criterios, puede que no aparezca correctamente en Actualización del Dispositivo. Corregir el valor inválido para cumplir los criterios especificados debería hacer que el dispositivo aparezca correctamente en Actualización del Dispositivo. Si el dispositivo no aparece en Actualización de dispositivo ni en la comprobación del agente, puede que necesites ejecutar sincronización de dispositivos para resolver el problema.

Ver resultados de las comprobaciones del agente

Los resultados de la comprobación del agente pueden encontrarse en la pestaña de diagnóstico de Actualización del Dispositivo.

  1. En el portal web Azure, navega a tu IoT Hub.
  2. Selecciona Actualizaciones en el menú de navegación y luego selecciona la pestaña Diagnósticos.
  3. Amplía la sección Buscar dispositivos perdidos .

Iniciar una operación de sincronización de dispositivo

La sincronización de dispositivos debería activarse si un dispositivo ha sido registrado en el hub IoT pero no aparece en Actualización de Dispositivo ni en los resultados de la comprobación del agente.

Solo puede estar activa una operación de sincronización de dispositivo a la vez para cada instancia de actualización de dispositivo.

  1. En el portal web Azure, navega a tu IoT Hub.
  2. Selecciona Actualizaciones en el menú de navegación y luego selecciona la pestaña Diagnósticos.
  3. Amplía la sección Ver estado del dispositivo.
  4. Selecciona Iniciar sincronización de dispositivo.

Pasos siguientes

Para saber más sobre las capacidades de diagnóstico de Actualización de Dispositivos, consulte Resumen general de las funciones de diagnóstico de actualización de dispositivos

  • Se actualizó por última vez el