Guía de solución de problemas de Device Update para IoT Hub

En este documento se enumeran algunas preguntas comunes y problemas que han notificado los usuarios de Device Update. A medida que la actualización de dispositivos avanza a través de la versión preliminar pública, esta guía de solución de problemas se actualizará periódicamente con nuevas preguntas y soluciones. Si encuentra un problema que no aparece en esta guía de solución de problemas, consulte la sección Ponerse en contacto con el soporte técnico de Microsoft para documentar su situación.

Importación de actualizaciones

P: Tengo problemas para conectar mi instancia de Device Update a mi instancia de IoT Hub.

Asegúrese de que las rutas de mensajes de IoT Hub están configuradas correctamente, según la documentación de recursos de Device Update .

Es posible que no tenga permisos de acceso configurados correctamente. Asegúrese de que ha configurado los permisos de acceso correctamente según la documentación del control de acceso de Device Update .

P: Encuentro un error de tipo 500 al importar contenido al servicio Device Update.

Un código de error en el intervalo de 500 puede indicar un problema con el servicio Device Update. Espere 5 minutos y vuelva a intentarlo. Si el mismo error persiste, siga las instrucciones de la sección Ponerse en contacto con el soporte técnico de Microsoft para presentar una solicitud de soporte técnico con Microsoft.

P: Quiero mantener las mismas propiedades de compatibilidad (como destino mi actualización al mismo tipo de dispositivo), pero cambiar el proveedor o el nombre en el manifiesto de importación. Pero recibo un error "Error: error al importar la actualización debido al límite superado" cuando lo hago.

No se puede usar el mismo conjunto exacto de propiedades de compatibilidad con más de una combinación de proveedor y nombre de actualización. Esto permite al servicio Device Update determinar con certeza qué actualizaciones deben estar disponibles para implementarse en un dispositivo determinado. Si necesita actualizar varios componentes o particiones en un único dispositivo, la característica de actualizaciones de proxy proporciona esa funcionalidad.

P: Encuentro un mensaje de error al importar contenido y me gustaría comprender más sobre él.

Consulte la documentación de códigos de error de Device Update para obtener información más detallada sobre los mensajes de error relacionados con la importación.

Errores de dispositivo

P: ¿Cómo puedo asegurarme de que mi dispositivo está conectado a Device Update para IoT Hub?

Para comprobar que el dispositivo está conectado a Device Update, compruebe si aparece en la sección "Dispositivos sin agrupar" en la vista de cumplimiento de Azure Portal.

P: Uno o varios de mis dispositivos no se pueden actualizar.

Hay muchas causas principales posibles de un error de actualización del dispositivo. Compruebe que el dispositivo está: 1) conectado a su instancia de IoT Hub, 2) conectado a su instancia de Device Update, y 3) que el servicio de Optimización de Distribución (DO) se está ejecutando. Si los tres son verdaderos para su dispositivo, siga las instrucciones de la sección Contactar con el soporte técnico de Microsoft para presentar una solicitud de soporte técnico con Microsoft.

Implementación de una actualización

P: He implementado una actualización en mis dispositivos, pero el estado de cumplimiento indica que no está en la actualización más reciente. ¿Qué debo hacer?

El estado de cumplimiento del dispositivo puede tardar hasta 5 minutos en actualizarse. Espere y vuelva a comprobarlo.

P: El estado de implementación de mi dispositivo indica que es incompatible, ¿qué debo hacer?

Es posible que se hayan cambiado las propiedades de fabricante y modelo de un dispositivo de destino después de conectar el dispositivo a IoT Hub, lo que hace que el dispositivo se considere ahora incompatible con el contenido de actualización de la implementación actual.

Compruebe la interfaz principal de ADU para ver qué fabricante y modelo informa el dispositivo al servicio Device Update y asegúrese de que coincide con el fabricante y el modelo especificados en el manifiesto de importación del contenido de actualización que se está implementando. Puede cambiar estas propiedades para un dispositivo determinado mediante el archivo de configuración Device Update.

P: Veo que el despliegue está en la etapa "Activa", pero ninguno de mis dispositivos está "En progreso" con la actualización. ¿Qué debo hacer?

Asegúrese de que la fecha de inicio de la implementación no esté establecida en el futuro. Al crear una nueva implementación, la fecha de inicio de la implementación se define de forma predeterminada en el día siguiente como protección a menos que la cambie explícitamente. Puede esperar a que llegue la fecha de inicio de la implementación, o bien cancelar la implementación en curso y crear una implementación con la fecha de inicio deseada.

P: Estoy intentando agrupar mis dispositivos, pero no veo la etiqueta en la lista desplegable al crear un grupo.

Asegúrese de haber configurado correctamente las rutas de mensaje según la documentación de Device Update resources en su IoT Hub. Tendrá que etiquetar el dispositivo de nuevo después de configurar la ruta.

Otra causa principal podría ser que aplicara la etiqueta antes de conectar el dispositivo a Device Update para IoT Hub. Asegúrese de que el dispositivo ya está conectado a Device Update. Para comprobar que el dispositivo está conectado a Device Update para IoT Hub, compruebe si aparece en dispositivos "Sin agrupar" en la vista de cumplimiento. Agregue temporalmente una etiqueta de un valor diferente y, a continuación, vuelva a agregar la etiqueta prevista una vez que el dispositivo esté conectado.

Si usa Device Provisioning Service (DPS), asegúrese de etiquetar los dispositivos después de que se aprovisionen y no durante el proceso de creación del dispositivo. Si ya ha etiquetado el dispositivo durante el paso de creación del dispositivo, tendrá que etiquetar temporalmente el dispositivo con un valor diferente después de aprovisionarlo y, a continuación, volver a agregar la etiqueta deseada.

P: Mi implementación se completó correctamente, pero algunos dispositivos no se pudieron actualizar.

Esto puede deberse a un error del lado cliente en los dispositivos con errores. Consulte la sección Errores del dispositivo de esta guía de solución de problemas.

P: He encontrado un error en la experiencia del usuario al intentar iniciar una implementación.

Esto puede deberse a un error de experiencia de usuario o servicio o por un problema de permisos de API. Siga las instrucciones de la sección Ponerse en contacto con el soporte técnico de Microsoft para presentar una solicitud de soporte técnico con Microsoft.

P: He iniciado una implementación, pero no alcanza un estado de finalización.

Esto puede deberse a un problema de rendimiento del servicio, un error de servicio o un error de cliente. Por favor, intente de nuevo la implementación después de 10 minutos. Si encuentra el mismo problema, extraiga los registros del dispositivo y consulte la sección Errores del dispositivo de esta guía de solución de problemas. Si el mismo problema persiste, siga las instrucciones de la sección Ponerse en contacto con el soporte técnico de Microsoft para presentar una solicitud de soporte técnico con Microsoft.

P: Migré de un agente de nivel de dispositivo a agregar el agente como una identidad de módulo en el dispositivo y mi actualización se muestra como "en curso" aunque se haya aplicado al dispositivo.

Esto puede haber sido causado si no quitó el agente anterior que se estaba comunicando a través del Device Twin. Al aprovisionar el agente de Device Update como módulo (vea cómo) todas las comunicaciones entre el dispositivo y el servicio Device Update se producen a través del módulo gemelo, por lo que recuerde etiquetar el módulo gemelo del dispositivo al crear grupos y todas las comunicaciones deben ocurrir a través del módulo gemelo.

Descarga de actualizaciones en dispositivos

P: ¿Cómo reanudo una descarga cuando un dispositivo se ha vuelto a conectar después de un período de desconexión?

La descarga se reanudará automáticamente cuando se restaure la conectividad en un período de 24 horas. Después de 24 horas, el usuario deberá volver a iniciar la descarga.

Uso de Microsoft Connected Cache (MCC)

P: Encuentro un problema al intentar implementar el módulo MCC en mi dispositivo IoT Edge.

Consulte la documentación de IoT Edge para implementar módulos de Edge en dispositivos IoT Edge. Para comprobar si el módulo MCC se está ejecutando correctamente en el dispositivo IoT Edge, vaya a . http://localhost:5100/Summary.

P: Uno de mis dispositivos IoT está intentando descargar una actualización a través de MCC, pero se produce un error.

Hay varios problemas que podrían provocar que un dispositivo IoT no se conecte a MCC. Para diagnosticar el problema, recopile el cliente de DO y los registros de Nginx del dispositivo con errores (consulte la sección Ponerse en contacto con el soporte técnico de Microsoft para obtener instrucciones sobre cómo recopilar registros de cliente).

Es posible que el dispositivo no pueda extraer contenido de Internet para pasar a su módulo MCC porque no se permite la dirección URL que usa. Para determinar si es así, deberá comprobar las variables de entorno de IoT Edge en Azure Portal.

Ponerse en contacto con el soporte técnico de Microsoft

Si tiene problemas que no se pueden resolver con las preguntas más frecuentes anteriores, puede presentar una solicitud de soporte técnico con soporte técnico de Microsoft a través de la interfaz de Azure Portal. En función de la categoría a la que indique que pertenece el problema, es posible que se le pida que recopile y comparta datos adicionales para ayudar al soporte técnico de Microsoft a investigar el problema.

Consulte a continuación para obtener instrucciones sobre cómo recopilar cada tipo de datos. Puede usar getDevices para comprobar información adicional en la respuesta de carga de la API.

Además, la siguiente información puede ser útil para restringir la causa principal del problema:

Qué tipo de dispositivo está intentando actualizar (Azure Percept, Puerta de enlace de IoT Edge, otro)
Qué tipo de cliente de Device Update está usando (basado en imágenes, basado en paquetes, simulador)
¿Qué sistema operativo está ejecutando el dispositivo?
Detalles sobre la arquitectura del dispositivo
Si ha usado correctamente Device Update para actualizar un dispositivo antes

Si tiene alguna de las informaciones anteriores disponibles, inclúyela en su descripción del problema.

Recopilación de registros de cliente

En el dispositivo Raspberry Pi hay dos conjuntos de registros que se encuentran aquí:
```
/adu/logs
```
```
/var/cache/do-client-lite/log
```
Para el cliente empaquetado, los registros se encuentran aquí:
```
/var/log/adu
```
```
/var/cache/do-client-lite/log
```
Para el simulador, los registros se encuentran aquí:
```
/tmp/aduc-logs
```

Códigos de error

Es posible que se le pida que proporcione códigos de error al notificar un problema relacionado con la importación de una actualización, un error de dispositivo o la implementación de una actualización.

Los códigos de error se pueden obtener examinando la interfaz ADUCoreInterface . Consulte la documentación de códigos de error de Device Update para obtener información sobre cómo analizar los códigos de error para el autodiagnóstico y la solución de problemas.

ID de seguimiento

Es posible que se le pida que proporcione un identificador de seguimiento al notificar un problema relacionado con la importación o implementación de una actualización.

El identificador de seguimiento de una acción de usuario determinada se puede encontrar en la respuesta de la API o en la sección Historial de importación de la interfaz de usuario de Azure Portal.

Actualmente, los identificadores de seguimiento de las acciones de implementación solo son accesibles a través de la respuesta de la API.

ID de implementación

Es posible que se le pida que proporcione un identificador de implementación al notificar un problema relacionado con la implementación de una actualización.

El usuario crea el identificador de implementación al llamar a la API para iniciar una implementación.

Actualmente, los identificadores de implementación para las implementaciones iniciadas desde la interfaz de usuario de Azure Portal se generan automáticamente y no se exponen al usuario.

Nombre de instancia de IoT Hub

Es posible que se le pida que proporcione el nombre de la instancia de IoT Hub al notificar un problema relacionado con errores de dispositivo o implementar una actualización.

El usuario elige el nombre de IoT Hub cuando se aprovisiona por primera vez.

Nombre de la cuenta de Device Update

Es posible que se le pida que proporcione el nombre de la cuenta de Device Update al notificar un problema relacionado con la importación de una actualización, errores de dispositivo o la implementación de una actualización.

El usuario elige el nombre de la cuenta de Device Update al registrarse por primera vez en el servicio. Puede encontrar más información en la documentación sobre los recursos de actualización de dispositivos.

Nombre de instancia de Device Update

Es posible que se le pida que proporcione el nombre de la instancia de Device Update al notificar un problema relacionado con la importación de una actualización, errores de dispositivo o la implementación de una actualización.

El usuario elige el nombre de la instancia de Device Update cuando se aprovisiona por primera vez. Puede encontrar más información en la documentación sobre los recursos de actualización de dispositivos.

Id. de dispositivo

Es posible que se le pida que proporcione un identificador de dispositivo al notificar un problema relacionado con los errores del dispositivo o la implementación de una actualización.

El cliente define el identificador de dispositivo cuando el dispositivo se aprovisiona por primera vez. También se puede recuperar del gemelo digital del dispositivo.

Id. de actualización

Es posible que se le pida que proporcione un identificador de actualización al notificar un problema relacionado con la implementación de una actualización.

El cliente define el identificador de actualización al iniciar una implementación.

Registros de Nginx

Es posible que se le pida que proporcione registros de Nginx al notificar un problema relacionado con la caché conectada de Microsoft.

ADU-conf.txt

Es posible que se le pida que proporcione el archivo de configuración de Device Update ("adu-conf.txt") al notificar un problema relacionado con la implementación de una actualización.

El archivo de configuración es opcional y lo crea el usuario siguiendo las instrucciones de la documentación de configuración de Device Update .

Manifiesto de importación

Es posible que se le pida que proporcione el archivo de manifiesto de importación al notificar un problema relacionado con la importación o implementación de una actualización.

El manifiesto de importación es un archivo creado por el cliente al importar contenido de actualización al servicio Device Update.

Paso siguiente: Más información sobre los códigos de error de Device Update

Last updated on 2021-02-17

Compartir por