Supervisión de la conectividad de dispositivos mediante la CLI de Azure
Use la extensión de IoT de la CLI de Azure para:
- Vea los mensajes que los dispositivos envían a IoT Central.
- Observe los cambios en el dispositivo gemelo.
- Diagnostique problemas en los que los mensajes del dispositivo no llegan a la nube.
- Diagnosticar problemas en los que los dispositivos no responden a los cambios de gemelos.
Consulte la referencia de extensiones de la CLI de Azure para obtener más detalles
Requisitos previos
Una cuenta profesional o educativa de Azure, agregada como usuario en una aplicación de IoT Central.
Preparación del entorno para la CLI de Azure
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
Instalación de la extensión de IoT Central
Ejecute el siguiente comando desde su línea de comando paras instalarlo:
az extension add --name azure-iot
Compruebe la versión de la extensión. Para ello, ejecute el siguiente comando:
az --version
Debería ver que la extensión azure-iot es 0.14.1 o posterior. Si no es así, ejecute:
az extension update --name azure-iot
Uso de la extensión
En las secciones siguientes se describen comandos y opciones comunes que puede usar al ejecutar az iot central. Para ver el conjunto completo de comandos y opciones, pase --help a az iot central o a cualquiera de sus subcomandos.
Iniciar sesión
Para empezar, inicie sesión en la CLI de Azure:
az login
Obtener el id. de la aplicación de la aplicación de IoT Central
En Aplicación > Administración, copie el Identificador de aplicación. Se usará este valor en pasos posteriores.
Controlar mensajes
Supervise los mensajes que se envían a la aplicación de IoT Central desde sus dispositivos. La salida incluye todos los encabezados y anotaciones.
az iot central diagnostics monitor-events --app-id <app-id> --properties all
Visualización de las propiedades del dispositivo
Consulte las propiedades actuales del dispositivo de lectura y de lectura y escritura para un dispositivo determinado.
az iot central device twin show --app-id <app-id> --device-id <device-id>
Pasos siguientes
Un siguiente paso sugerido es obtener información sobre por qué los datos de los dispositivos no se muestran en Azure IoT Central.