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

En este documento se enumeran algunas preguntas y problemas comunes notificados por los usuarios de Device Update. 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: He importado correctamente una actualización, pero no se muestra como disponible para implementar en los dispositivos con los que debería ser compatible.

Compruebe que el archivo de manifiesto de importación .json no tenga errores accidentales, especialmente en los valores del objeto de compatibilidad. Las propiedades de compatibilidad del manifiesto de importación deben coincidir exactamente con las propiedades notificadas por los dispositivos, lo que garantiza que las actualizaciones correctas siempre se envíen a los dispositivos adecuados. Por ejemplo, podría haber un error tipográfico en el manifiesto de importación que hace que una propiedad de compatibilidad tenga un carácter ausente, transpuesto o adicional en comparación con lo que informa un dispositivo. Si es así, el servicio Device Update para IoT Hub no puede coincidir con la actualización de ese dispositivo. Si ya importó una actualización, puede comprobar rápidamente si hay problemas con las propiedades de compatibilidad haciendo clic en el vínculo "Detalles" para esa actualización y, a continuación, haciendo clic en "Detalles adicionales" en el menú flotante derecho. Desde allí, puede ver el contenido JSON del manifiesto de importación para esa actualización e identificar los posibles errores.

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, conforme a la documentación de los Recursos de Device Update.

P: Encuentro un error relacionado con el rol (mensaje de error en Azure Portal o un error de API 403)

Es posible que no tenga permisos de acceso configurados correctamente. Asegúrese de que los permisos de acceso están configurados 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 obtengo 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. Esta directiva 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 la instancia de IoT Hub, 2) conectado a la instancia de Device Update y 3) 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 a Microsoft.

P: Mi agente de Device Update no se puede iniciar

Una de las razones más comunes para un error en el inicio del agente de Device Update es un archivo de configuración con formato incorrecto (du-config.json). Consulte la documentación del archivo de configuración y asegúrese de que el agente está configurado correctamente. Todos los valores del archivo de configuración deben usar comillas dobles.

Implementación de una actualización

P: He implementado una actualización en mi dispositivo, pero el estado de cumplimiento dice 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.

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

Es posible que las propiedades de fabricante y modelo de un dispositivo de destino hayan cambiado 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 Núcleo de ADU para ver qué fabricante y modelo está reportando el dispositivo al servicio de actualización de dispositivos. Asegúrese de que coincide con el fabricante y el modelo especificados en el manifiesto de importación del contenido de actualización que va a implementar. Puede cambiar estas propiedades para un dispositivo determinado mediante el archivo de configuración Device Update.

P: veo que una implementación está en la fase "Activa" (Activo), pero ninguno de los dispositivos está "In progress" (En curso) 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 que las rutas de mensajes de IoT Hub se han configurado correctamente, tal como se indica en la documentación de los recursos de Device Update. 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 prevista.

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

Esta condición 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

Esta condición puede deberse a un error de experiencia de usuario o servicio o a 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 llega a un estado final

Esta condición puede deberse a un problema de rendimiento del servicio, un error de servicio o un error de cliente. Intente la implementación de nuevo 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é desde un agente a nivel de dispositivo a agregar el agente como identidad de módulo en el dispositivo. Ahora mi actualización aparece como "en curso", aunque ya se haya aplicado al dispositivo.

Esta condición puede ocurrir si no se eliminó un antiguo agente que estaba comunicándose a través del Device Twin. Al aprovisionar el agente de Device Update como módulo (vea cómo hacerlo), todas las comunicaciones entre el dispositivo y el servicio Device Update se producen a través del módulo gemelo. Recuerde etiquetar el módulo gemelo del dispositivo al crear grupos y todas las comunicaciones deben producirse a través del módulo gemelo.

Descarga de actualizaciones en dispositivos

P: ¿Cómo reanudo una descarga cuando un dispositivo se vuelve 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 las 24 horas, el usuario tendrá que 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 los registros del cliente de DO y 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 confirmar esto, compruebe las variables de entorno de IoT Edge en Azure Portal.

Solución de problemas de una instancia que falta en Azure Portal

P: no veo una instancia de Device Update for IoT Hub cuando selecciono el icono de "engranaje"

Hay algunas causas posibles de este problema. Consulte a continuación para ver los pasos de solución de problemas.

Una instancia de Device Update debe asociarse a un centro de Azure IoT en el mismo grupo de recursos y suscripción. Si mueve su instancia de Device Update o su centro a otro grupo de recursos o suscripción, es posible que no pueda ver su instancia en el portal de Azure. Si es así, realice uno de los pasos siguientes para seguir usando Device Update para IoT Hub:

• Devuelve los elementos movidos a su configuración original.

• Si solo ha movido el centro de IoT de un grupo de recursos a otro, modifique la instancia de Device Update con el nuevo resourceId del centro de IoT.

• Si ha movido elementos de una suscripción a otra, asegúrese de que la cuenta de Device Update y el centro de IoT estén en la misma suscripción y, a continuación, modifique la instancia de Device Update con el nuevo resourceId del centro de IoT.

Se necesitan al menos permisos de nivel de lectura tanto para su Centro de IoT como para su cuenta de Actualización de Dispositivos para IoT Hub a fin de acceder a la funcionalidad de Actualización de Dispositivos a través de la experiencia del Centro de IoT en el portal de Azure.

• Para administrar los permisos de IoT Hub:
  • Selecciona tu centro en el Azure portal
  • Seleccione "Control de acceso (IAM) en la barra de navegación izquierda.
  • Seleccione "Agregar asignación de roles".
  • Seleccione un rol con al menos acceso de lectura y seleccione Siguiente.
  • Junto a "Miembros", seleccione "+Seleccionar miembros".
  • Agregue su cuenta en el panel lateral derecho y seleccione el botón "Seleccionar".
  • Seleccione “Revisar y asignar”.
• Para administrar los permisos de la cuenta de Device Update para IoT Hub, pida al propietario de la cuenta que realice estos pasos:
  • Seleccione la cuenta de Device Update en Azure Portal.
  • Seleccione "Control de acceso (IAM) en la barra de navegación izquierda.
  • Seleccione "Agregar asignación de roles".
  • Seleccione el rol Lector (o uno con permisos equivalentes).
  • Junto a "Miembros", seleccione "+Seleccionar miembros".
  • Agregue su cuenta en el panel lateral derecho y seleccione el botón "Seleccionar".
  • Seleccione “Revisar y asignar”.

Obtenga más información sobre el control de acceso basado en rol para el servicio Device Update.

Ponerse en contacto con el soporte técnico de Microsoft

Si tiene problemas que no se pueden resolver mediante el contenido de esta página, 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 más datos para ayudar al soporte técnico de Microsoft a investigar el problema.

Consulte el texto restante de esta sección para obtener instrucciones sobre cómo recopilar cada tipo de datos.

Puede usar getDevice para comprobar información adicional en la respuesta de carga de la API.

Incluya también la siguiente información si es posible, ya que puede ser útil para restringir la causa principal del problema:

• ¿Qué tipo de dispositivo está intentando actualizar (Gateway 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

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 códigos de error para autodiagnóstico y 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 dispositivo gemelo 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.

Pasos siguientes

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