Compartir vía

Introducción a los diagnósticos de Device Update for IoT Hub

  • Artículo

El servicio Device Update for IoT Hub tiene varias características que puede usar para diagnosticar y solucionar errores del lado del dispositivo. Con el lanzamiento de la versión 0.9.0 del agente, tiene disponibles tres características de diagnóstico:

  • Los códigos de error de implementación se pueden ver directamente en la interfaz de usuario de Device Update.

  • La recopilación remota de registros permite la creación de operaciones de registro, que indican a los dispositivos de destino que carguen registros de diagnóstico en el dispositivo en una cuenta de Azure Blob Storage vinculada.

  • Comprobación del agente realiza comprobaciones de validación en los dispositivos registrados en la instancia de Device Update cuyo objetivo es diagnosticar los dispositivos registrados en la instancia de IoT Hub conectada, pero que no se muestran en Device Update.

Códigos de error de implementación en la interfaz de usuario

Cuando se notifica un error de implementación de un dispositivo al servicio Device Update, los códigos de los elementos resultCode y extendedResultCode del dispositivo, que se notifican desde este, se muestran en la interfaz de usuario de Device Update. Para visualizar los códigos, siga estos pasos:

  1. En Azure Portal, navegue hasta su centro de IoT.

  2. Seleccione Novedades y vaya a la pestaña Grupos e implementaciones.

  3. Seleccione el nombre de un grupo que tenga una implementación activa para ir a la página Detalles del grupo.

  4. Seleccione el nombre de cualquier dispositivo en la Lista de dispositivos para abrir su panel de detalles. En este panel, podrá visualizar el código de resultado que se haya notificado desde el dispositivo.

  5. En el agente de referencia de Device Update, se sigue la convención estándar de códigos de estado HTTP a la hora de rellenar el campo del código de resultado (por ejemplo: se usa "200" para indicar que el estado es correcto). Para obtener más información sobre cómo analizar los códigos de resultados, consulte la página Códigos de error de cliente de Device Update.

    Nota

    Aunque haya modificado el agente de Device Update para que se notifiquen códigos de resultado personalizados, los códigos numéricos se seguirán pasando a su interfaz de usuario. Puede consultar cualquier documentación que haya creado para analizar estos códigos numéricos.

Colección de registros remotos

Cuando se necesita más información del dispositivo para diagnosticar y solucionar un error, puede usar la característica de recopilación de registros para indicar a los dispositivos de destino que carguen registros de diagnóstico en el dispositivo en una cuenta de Azure Blob Storage vinculada. Para empezar a usar esta característica, puede seguir las instrucciones que se incluyen en Recopilación remota de registros de diagnóstico de dispositivos.

La recopilación remota de registros de Device Update es una característica basada en operaciones controlada por el servicio. Para aprovechar las ventajas de la recopilación de registros, el dispositivo solo necesita poder implementar la interfaz de diagnóstico y el archivo de configuración, y poder cargar archivos en Azure Blob Storage a través del SDK.

Desde un nivel superior, la característica de recopilación de registros funciona de la siguiente manera:

  1. El usuario crea una nueva operación de registro mediante la interfaz de usuario o las API de Device Update, que tiene como destino hasta 100 dispositivos donde se ha implementado la interfaz de diagnóstico.

  2. Desde el servicio de Device Update, se envía un mensaje de inicio del proceso de recopilación de registros a los dispositivos de destino mediante la interfaz de diagnóstico. Este mensaje de inicio incluye el id. de operación de registro y un token de SAS para cargar en la cuenta de Azure Storage asociada.

  3. Tras recibirse el mensaje de inicio en el agente de Device Update del dispositivo de destino, se intentará recopilar y cargar los archivos de las rutas de acceso de archivo predefinidas que se especifican en el archivo de configuración del agente del dispositivo. El agente de referencia de Device Update está configurado para cargar el registro de diagnóstico del agente de Device Update (aduc.log), así como el registro de diagnóstico del agente DO ("do-agent.log") de forma predeterminada.

  4. A continuación, desde el agente de Device Update, se informa sobre el estado de la operación (puede ser Correcto o Con errores) al servicio. Esto incluye el id. de operación de registro, un código ResultCode y un código ExtendedResultCode. Si se produce un error durante una operación de registro del agente de Device Update, esta se reintentará automáticamente tres veces, y solo se informará del estado final al servicio.

  5. Una vez que todos los dispositivos de destino hayan notificado su estado de terminal al servicio Device Update, el estado de la operación de registro se marcará como Correcto o Con errores. Si la operación de registro es correcta, significará que todos los dispositivos de destino completaron la operación de registro correctamente. Si la operación de registro tiene errores, significará que la operación de registro no se pudo realizar correctamente en, al menos, un dispositivo de destino.

    Nota

    Como la operación de registro se lleva a cabo en paralelo en los dispositivos de destino, es posible que algunos dispositivos de destino carguen los registros correctamente, pero que la operación de registro general se marque con el estado "Con errores". Para visualizar los dispositivos donde el proceso se realizó correctamente y los que hayan fallado, consulte los detalles de la operación de registro en la interfaz de usuario o las API.

Comprobación del agente

Cuando el dispositivo está registrado en IoT Hub pero no aparece en la instancia de Device Update, puede usar la característica Comprobación del agente para ejecutar comprobaciones de validación realizadas previamente que le ayudarán a diagnosticar el problema subyacente. Para empezar a usar esta característica, siga estas instrucciones de Comprobación del agente.

Desde un nivel superior, la característica de comprobación del agente funciona de la siguiente manera:

  • El usuario registra un dispositivo en IoT Hub. Si el dispositivo indica que hay un identificador de modelo que coincide con los compatibles con Device Update for IoT Hub, la instancia de Device Update conectada del usuario registrará automáticamente el dispositivo en Device Update.

  • Para que Device Update administre correctamente un dispositivo, debe cumplir ciertos criterios que se pueden comprobar mediante las comprobaciones de validación realizadas previamente de Comprobación del agente. Aquí puede encontrar más información sobre estos criterios.

  • Si un dispositivo no cumple todos estos criterios, Device Update no puede administrarlo correctamente y no se mostrará en la interfaz de Device Update ni en las respuestas de la API. Los usuarios pueden utilizar Comprobación de agente para buscar este dispositivo e intentar identificar los criterios que no se cumplen mediante Comprobación del agente.

  • Una vez que el usuario los haya identificado qué criterios, puede corregir el problema y el dispositivo debería aparecer correctamente en la interfaz de Device Update.

Pasos siguientes

Aprenda a usar las característica de recopilación remota de registros y de Comprobación de agente de Device Update: