Solucione los problemas por los que no se muestran los datos de los dispositivos en Azure IoT Central.

Este documento ayuda a averiguar por qué los datos que envían los dispositivos a IoT Central pueden no aparecer en la aplicación.

Hay dos áreas principales para investigar:

• Resolución de problemas de dispositivos
  • Problemas de autenticación como que el dispositivo tenga credenciales no válidas
  • Problemas de conectividad de red
  • El dispositivo no está aprobado o está bloqueado
• Problemas de forma de la carga útil del dispositivo

Esta guía de solución de problemas se centra en los relacionados con la conectividad de los dispositivos y en los de la forma de su carga útil.

Resolución de problemas de dispositivos

Esta sección le ayudará a determinar si los datos llegan a IoT Central.

Si todavía no lo ha hecho, instale la herramienta az cli y la extensión azure-iot.

Para más información sobre cómo instalar az cli, consulte Instalación de la CLI de Azure.

Para instalar la extensión azure-iot, ejecute el comando siguiente:

az extension add --name azure-iot

Cuando haya instalado la extensión azure-iot, inicie el dispositivo para ver si los mensajes que envía van a IoT Central.

Use los siguientes comandos para iniciar sesión en la suscripción en la que tenga la aplicación IoT Central:

az login
az account set --subscription <your-subscription-id>

Para supervisar la telemetría que el dispositivo envía, use el siguiente comando:

az iot central diagnostics monitor-events --app-id <app-id> --device-id <device-name>

Si el dispositivo se ha conectado correctamente a IoT Central, verá una salida similar a la siguiente:

Monitoring telemetry.
Filtering on device: device-001
{
    "event": {
        "origin": "device-001",
        "module": "",
        "interface": "",
        "component": "",
        "payload": {
            "temp": 65.57910343679293,
            "humid": 36.16224660107426
        }
    }
}

Para supervisar las actualizaciones de propiedades que el dispositivo intercambia con IoT Central, use el siguiente comando de versión preliminar:

az iot central diagnostics monitor-properties --app-id <app-id> --device-id <device-name>

Si el dispositivo envía correctamente las actualizaciones de propiedades, verá una salida similar a la siguiente:

Changes in reported properties:
version : 32
{'state': 'true', 'name': {'value': {'value': 'Contoso'}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac
': 200}, 'brightness': {'value': {'value': 2}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac': 200}, 'p
rocessorArchitecture': 'ARM', 'swVersion': '1.0.0'}

Si ve que los datos aparecen en el terminal, es que están llegando hasta la aplicación IoT Central.

Si no ve ningún dato después de unos minutos, pruebe a presionar la tecla Enter o return, por si la salida está atascada.

Si sigue sin ver ningún dato en el terminal, es probable que el dispositivo tenga problemas de conectividad de red o que no esté enviando los datos correctamente a IoT Central.

Comprobación del estado de aprovisionamiento del dispositivo

Si los datos no aparecen en el monitor, compruebe el estado de aprovisionamiento del dispositivo; para ello, ejecute el siguiente comando:

az iot central device registration-info --app-id <app-id> --device-id <device-name>

La salida siguiente muestra un ejemplo de un dispositivo que no se pudo conectar:

{
  "@device_id": "v22upeoqx6",
  "device_registration_info": {
    "device_status": "blocked",
    "display_name": "Environmental Sensor - v22upeoqx6",
    "id": "v22upeoqx6",
    "instance_of": "urn:krhsi_k0u:modelDefinition:w53jukkazs",
    "simulated": false
  },
  "dps_state": {
    "error": "Device is blocked from connecting to IoT Central application. Unblock the device in IoT Central and retry. Learn more:
https://aka.ms/iotcentral-docs-dps-SAS",
    "status": null
  }
}

Más información acerca de códigos de estado de dispositivo.

Códigos de error

Si sigue sin poder diagnosticar por qué los datos no se muestran en monitor-events, el siguiente paso es buscar los códigos de error que el dispositivo indique.

Inicie una sesión de depuración en el dispositivo o recopile los registros de este. Busque los códigos de error que el dispositivo notifique.

En las tablas siguientes se muestran códigos de error comunes y las posibles acciones para mitigarlos.

Si ve problemas relacionados con el flujo de autenticación:

Códigos de error de autorización detallados

Códigos de error de carga de archivos

A continuación se incluye una lista de códigos de error comunes que pueden mostrarse cuando un dispositivo intenta cargar un archivo en la nube. Recuerde que antes de que el dispositivo pueda cargar un archivo, debe configurar las cargas de archivos del dispositivo en la aplicación.

Problemas con la forma de la carga útil

Cuando haya establecido que el dispositivo está enviando datos a IoT Central, el siguiente paso es asegurarse de que los envía en un formato válido.

Hay dos categorías principales de problemas comunes que hacen que los datos del dispositivo no aparezcan en IoT Central:

• La plantilla de dispositivo para los datos del dispositivo no coincide:
  • No coinciden los nombres, por ejemplo, hay errores tipográficos o las mayúsculas y las minúsculas no concuerdan.
  • Propiedades no modeladas en las que el esquema no se define en la plantilla de dispositivo.
  • No coincide el esquema, por ejemplo, un tipo se define en la plantilla como boolean, pero los datos son una cadena.
  • El mismo nombre de telemetría se define en varias interfaces, pero el dispositivo no es compatible con IoT Plug and Play.
• La forma de los datos es un formato JSON no válido. Para más información, consulte Cargas de telemetría, propiedades y comandos.

Para detectar las categorías del problema, ejecute el comando más apropiado para su escenario:

• Para comprobar la telemetría, use el comando de la versión preliminar:

  az iot central diagnostics validate-messages --app-id <app-id> --device-id <device-name>
  

• Para comprobar las actualizaciones de las propiedades, use el comando de la versión preliminar:

  az iot central diagnostics validate-properties --app-id <app-id> --device-id <device-name>
  

Es posible que se le pida que instale la biblioteca uamqp la primera vez que ejecute un comando validate.

La siguiente salida muestra mensajes de error y advertencia de ejemplo del comando validate:

Validating telemetry.
Filtering on device: v22upeoqx6.
Exiting after 300 second(s), or 10 message(s) have been parsed (whichever happens first).
[WARNING] [DeviceId: v22upeoqx6] No encoding found. Expected encoding 'utf-8' to be present in message header.

[WARNING] [DeviceId: v22upeoqx6] Content type '' is not supported. Expected Content type is 'application/json'.

[ERROR] [DeviceId: v22upeoqx6] [TemplateId: urn:krhsi_k0u:modelDefinition:w53jukkazs] Datatype of field 'humid' does not match the da
tatype 'double'. Data '56'. All dates/times/datetimes/durations must be ISO 8601 compliant.

Si prefiere usar una GUI, use la vista Datos sin procesar de IoT Central y compruebe si algo no se está modelando. La vista Datos sin procesar no detecta si el dispositivo está enviando JSON con formato incorrecto.

Cuando haya detectado el problema, es posible que tenga que actualizar el firmware del dispositivo o crear una nueva plantilla de dispositivo que contenga los datos no modelados previamente.

Si decide crear una plantilla que modele los datos correctamente, migre los dispositivos de la plantilla anterior a la nueva. Para más información, consulte Administración de dispositivos en la aplicación de Azure IoT Central.

Pasos siguientes

Si necesita más ayuda, puede ponerse en contacto con los expertos de Azure en los foros de MSDN Azure o Stack Overflow. Como alternativa, puede abrir una incidencia de soporte técnico de Azure.

Para más información, consulte Opciones de ayuda y soporte técnico de IoT de Azure.