Recopilación remota de registros de diagnóstico de dispositivos mediante Device Update para IoT Hub

Aprenda a iniciar una operación de registro de Device Update para IoT Hub y a ver los registros recopilados en Azure Blob Storage.

Prerrequisitos

Azure Portal

• Acceso a IoT Hub con Device Update para IoT Hub habilitado.
• Un dispositivo IoT (o simulador) aprovisionado para Device Update dentro de IoT Hub e implementando la Interfaz de Diagnóstico.
• Una cuenta de Azure Blob Storage en la misma suscripción que la cuenta de Device Update para IoT Hub.

Nota:

La característica de recopilación remota de registros solo es compatible actualmente con dispositivos que implementan la interfaz de diagnóstico y pueden cargar archivos en Azure Blob Storage. La implementación del agente de referencia también espera que el dispositivo escriba archivos de registro en una ruta de archivo definida por el usuario en el dispositivo.

CLI de Azure

• Acceso a IoT Hub con Device Update para IoT Hub habilitado.

• Un dispositivo IoT (o simulador) aprovisionado para Device Update dentro de IoT Hub e implementando la Interfaz de Diagnóstico.

• Una cuenta de Azure Blob Storage en la misma suscripción que la cuenta de Device Update para IoT Hub.

• 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.

    • Inicie sesión en la CLI de Azure mediante el comando az login .
    • Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.
    • 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.

Nota:

La característica de recopilación remota de registros solo es compatible actualmente con dispositivos que implementan la interfaz de diagnóstico y pueden cargar archivos en Azure Blob Storage. La implementación del agente de referencia también espera que el dispositivo escriba archivos de registro en una ruta de archivo especificada por el usuario en el propio dispositivo.

Vinculación de la cuenta de Azure Blob Storage a la instancia de Device Update

Para usar la característica de recopilación remota de registros, primero debe vincular una cuenta de Azure Blob Storage con la instancia de Device Update. Esta cuenta de Azure Blob Storage es donde los dispositivos cargarán los registros de diagnóstico.

Azure Portal

1. En Azure Portal, vaya a la cuenta de Device Update for IoT Hub.

2. Seleccione Instancias en la sección de Administración de Instancias bajo la en el panel de navegación.

3. Seleccione su instancia de Actualización de Dispositivos de la lista y, a continuación, Configurar diagnósticos.

4. Seleccione la pestaña de diagnóstico de clientes y después seleccione la cuenta de almacenamiento de Azure.

5. Elija la cuenta de almacenamiento deseada en la lista y seleccione Guardar.

6. Una vez de nuevo en la lista de instancias, seleccione Actualizar periódicamente hasta que el estado de aprovisionamiento de la instancia muestre "Correcto". Este proceso suele tardar entre 2 y 3 minutos.

CLI de Azure

Usa el comando az iot device-update instance create para configurar diagnósticos para la instancia de Device Update.

Sugerencia

Puede usar el comando az iot device-update instance create en una instancia de Device Update existente y configurará la instancia con los parámetros actualizados.

Sustituya los siguientes marcadores de posición por su propia información.

• <account_name>: el nombre de la cuenta de Device Update.
• <instance_name>: el nombre de la instancia de Device Update.
• <storage_id>: el identificador de recurso de la cuenta de almacenamiento donde se almacenarán los registros de diagnóstico. Puede recuperar el ID del recurso utilizando el comando az storage show y consultando el valor del ID: az storage account show -n <storage_name> --query id.

az iot device-update instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

Configuración de la recopilación de registros

El agente de actualización de dispositivos hace referencia a un archivo de configuración en el dispositivo, ubicado en /etc/adu/du-diagnostics-config.json en el agente de referencia.

Rutas de archivos de recopilación de registros

El agente de Device Update de un dispositivo recopilará archivos de rutas de archivos específicas en el dispositivo cuando reciba una señal de inicio de carga de registros desde el servicio Device Update. Las rutas de acceso de estos archivos se definen en el archivo de configuración de diagnósticos.

Dentro del archivo de configuración, cada archivo de registro que se va a recopilar y cargar se representa como un objeto logComponent con las propiedades componentName y logPath. Esta configuración se puede modificar según sea necesario.

Tamaño máximo del archivo de registro

El agente de Device Update solo recopilará archivos de registro con un tamaño de archivo determinado. Este tamaño máximo de archivo se define en el archivo de configuración de diagnóstico.

El parámetro pertinente "maxKilobytesToUploadPerLogPath" se aplicará a cada objeto logComponent y se puede modificar según sea necesario.

Creación de una operación de registro

Las operaciones de registro son una acción impulsada por el servicio que puede instruir a los dispositivos IoT para que las realicen a través del servicio Device Update. Para obtener una explicación más detallada de cómo funcionan las operaciones de registro de eventos, consulte Diagnóstico de actualización de dispositivos.

1. Vaya a su IoT Hub y seleccione la pestaña Actualizaciones en la sección Administración de Dispositivos del panel de navegación.

2. Seleccione la pestaña Diagnósticos en la interfaz de usuario. Si no ve una pestaña Diagnósticos, asegúrese de que usa la versión más reciente de la interfaz de usuario de Device Update para IoT Hub. Si ve "Los diagnósticos deben estar habilitados para esta instancia de Device Update", asegúrese de que ha vinculado una cuenta de Azure Blob Storage con la instancia de Device Update.

3. Seleccione agregar operación de carga de registros para ir a la página de creación de la operación de registro.

4. Escriba un nombre (ID) y una descripción para la nueva operación de registro y, a continuación, seleccione Agregar dispositivos para seleccionar los dispositivos IoT de los que desea recopilar registros de diagnóstico.

5. Selecciona Agregar.

6. Una vez de nuevo en la pestaña Diagnósticos, seleccione Actualizar hasta que vea la operación de registro en la tabla de operaciones.

7. Una vez que el estado de la operación sea Exitoso o Fallido, seleccione el nombre de la operación para ver sus detalles. Una operación se marcará como "Correcto" solo si todos los dispositivos de destino completaron correctamente la carga del registro. Si algunos dispositivos de destino tuvieron éxito y otros fallaron, la operación de registro se marcará como "Falló". Puede usar la página de detalles de la operación de registro para ver qué dispositivos tuvieron éxito y cuáles fallaron.

8. En los detalles de la operación de registro, puede consultar el estado específico del dispositivo y ver la ruta de ubicación del registro. Esta ruta de acceso corresponde a la ruta de acceso del directorio virtual dentro de la cuenta de Azure Blob Storage donde se han cargado los registros de diagnóstico.

Visualización y exportación de registros de diagnóstico recopilados

1. Una vez que la operación de registro se haya realizado correctamente, vaya a la cuenta de Azure Blob Storage.

2. Seleccione Containers en la sección Data Storage del panel de navegación.

3. Seleccione el contenedor con el mismo nombre que la instancia de Device Update.

4. Utiliza la ruta de los registros desde los detalles de la operación de registros para acceder al directorio correcto con los registros. De forma predeterminada, la característica de recopilación remota de registros indica a los dispositivos de destino que carguen registros de diagnóstico mediante el siguiente modelo de ruta de acceso de directorio: contenedor de Blob Storage/ID del dispositivo de destino/ID de la operación de registro/ruta de registro en el dispositivo

5. Si no ha modificado el componente de diagnóstico del agente DU, el dispositivo responderá a cualquier operación de registro intentando cargar dos archivos de registro de texto no cifrado: el registro de diagnóstico del agente DU ("aduc.log") y el registro de diagnóstico del agente de DO ("do-agent.log"). Puede obtener más información sobre los archivos de registro que recopila el agente de referencia DU leyendo la página de concepto de diagnósticos de actualizaciones de dispositivos.

6. Puede ver el contenido del archivo de registro seleccionando el nombre de archivo y seleccionando el elemento de menú (puntos suspensivos) y haciendo clic en Ver o editar. También puede descargar o eliminar el archivo de registro seleccionando las opciones etiquetadas respectivamente.

   

Pasos siguientes

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