Búsqueda y corrección de dispositivos que faltan en Device Update for IoT Hub mediante la comprobación del agente

Obtenga información sobre cómo usar la característica de comprobación del agente para buscar, diagnosticar y corregir los dispositivos que faltan en la instancia de Device Update for IoT Hub.

Prerrequisitos

• Acceso a una instancia de IoT Hub con Device Update para IoT Hub habilitado.
• Un dispositivo IoT (o simulador) aprovisionado para Device Update e informando de un identificador de modelo de Plug and Play (PnP) compatible.

Nota

La característica de comprobación del agente solo puede realizar comprobaciones de validación en los dispositivos que tienen instalado el agente de Device Update y notifican un identificador de modelo PnP que coincida con los compatibles con Device Update for IoT Hub.

Azure Portal

Exploradores admitidos:

• Microsoft Edge
• Google Chrome

CLI de Azure

Un entorno de la CLI de Azure:

• Use el entorno de Bash en Azure Cloud Shell.

  

• O bien, si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure.

  1. Inicie sesión en la CLI de Azure mediante el comando az login.
  2. Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
  3. Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que lo use. Los comandos de este artículo usan la extensión azure-iot. Ejecute az extension update --name azure-iot para asegurarse de usar la versión más reciente de la extensión.

Comprobaciones de validación admitidas por la comprobación del agente

La característica de comprobación del agente realiza actualmente las siguientes comprobaciones de validación en todos los dispositivos que cumplen los requisitos previos anteriores.

Comprobación de la validación	Criterios
Id. de modelo PnP	El identificador de modelo PnP es una cadena notificada por el agente de Device Update al dispositivo gemelo que describe qué modelo PnP se debe usar para la comunicación entre dispositivos y nubes. Esta cadena debe ser un identificador de modelo de gemelo digital (DTMI) válido que admita la interfaz de Device Update.
Id. de interfaz	El identificador de interfaz es una cadena notificada por el agente de Device Update al dispositivo gemelo que describe qué versión de la interfaz de Device Update se debe usar para la comunicación entre dispositivos y nubes. Esta cadena debe ser un DTMI válido que admita la interfaz de Device Update.
Nombres de propiedad de compatibilidad	CompatPropertyNames es un campo notificado por el agente de Device Update al dispositivo gemelo que describe qué campos deviceProperties se deben usar para determinar la compatibilidad del dispositivo con una implementación determinada. 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 <32 caracteres.
Valores de propiedad de compatibilidad	Los valores de propiedad de compatibilidad son los pares field:value especificados por el campo compatPropertyNames y notificados por el agente de Device Update al dispositivo gemelo como deviceProperties. Cada nombre definido en los nombres de propiedad de compatibilidad debe tener un par field:value correspondiente notificado. El valor de cada par está limitado a 64 caracteres.
Grupo de ADU	La etiqueta de grupo de ADU es una etiqueta opcional que se define en el dispositivo gemelo del dispositivo y determina a qué grupo de dispositivos pertenece el dispositivo. Si se especifica, la cadena de etiqueta está limitada a 255 caracteres y solo puede contener caracteres alfanuméricos y los siguientes caracteres especiales: "." "-" "_" "~"

Si un dispositivo no cumple cualquiera de estos criterios, es posible que no aparezca correctamente en Device Update. Corregir el valor no válido para cumplir los criterios especificados debe hacer que el dispositivo aparezca correctamente en Device Update. Si el dispositivo no aparece en Device Update ni en la comprobación del agente, es posible que tenga que ejecutar la sincronización de dispositivos para resolver el problema.

Visualización de los resultados de la comprobación del agente

Azure Portal

Los resultados de la comprobación del agente se pueden encontrar en la pestaña diagnósticos de Device Update.

1. En Azure Portal, navegue hasta su centro de IoT.
2. Seleccione Actualizaciones en el menú de navegación y, a continuación, seleccione la pestaña Diagnósticos.
3. Expanda la sección Búsqueda de dispositivos que faltan.

CLI de Azure

Use az iot du device health list para ver el estado de los dispositivos.

El comando device health list toma los argumentos siguientes:

• --account: nombre de la cuenta de Device Update.
• --instance: nombre de la instancia de Device Update.
• --filter: un filtro de estado del dispositivo, ya sea filtrado por el estado del dispositivo o por el identificador de dispositivo. Por ejemplo:
  • Para enumerar todos los dispositivos correctos, filtre por state eq 'Healthy'
  • Para enumerar todos los dispositivos incorrectos, filtre por state eq 'Unhealthy'
  • Para mostrar el estado de mantenimiento de un dispositivo de destino, filtre por deviceId eq '<device_name>' o deviceId eq '<device_name>' and moduleId eq '<module_name>'

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

Inicio de una operación de sincronización de dispositivos

La sincronización de dispositivos debe desencadenarse si un dispositivo se ha registrado en IoT Hub, pero no aparece en Device Update ni en los resultados de la comprobación del agente.

Solo una operación de sincronización de dispositivos puede estar activa al mismo tiempo para cada instancia de Device Update.

Azure Portal

1. En Azure Portal, navegue hasta su centro de IoT.
2. Seleccione Actualizaciones en el menú de navegación y, a continuación, seleccione la pestaña Diagnósticos.
3. Expanda la sección Ver estado del dispositivo.
4. Seleccione Iniciar una sincronización de dispositivos.

CLI de Azure

Use az iot du device import para importar dispositivos y módulos a la instancia de Device Update desde un centro de IoT vinculado.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

Pasos siguientes

Para más información sobre las funcionalidades de diagnóstico de Device Update, consulte Información general sobre la característica de diagnóstico de actualización de dispositivos