az iot central diagnostics

Vista previa

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). La extensión instalará automáticamente la primera vez que ejecute un comando az iot central diagnostics. Learn more about extensions.

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Realice diagnósticos de nivel de aplicación y dispositivo.

Comandos

Nombre	Description	Tipo	Estado
az iot central diagnostics monitor-events	Vea los mensajes de telemetría del dispositivo enviados a la aplicación de IoT Central.	Extension	Preview
az iot central diagnostics monitor-properties	Vea las propiedades deseadas y notificadas enviadas a o desde la aplicación de IoT Central.	Extension	Preview
az iot central diagnostics registration-summary	Vea el resumen de registro de todos los dispositivos de una aplicación.	Extension	Preview
az iot central diagnostics validate-messages	Valide los mensajes enviados a IoT Hub para una aplicación de IoT Central.	Extension	Preview
az iot central diagnostics validate-properties	Valide las propiedades notificadas enviadas a la aplicación de IoT Central.	Extension	Preview

az iot central diagnostics monitor-events

Vista previa

El grupo de comandos "iot central diagnostics" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Vea los mensajes de telemetría del dispositivo enviados a la aplicación de IoT Central.

Muestra los datos de telemetría enviados a la aplicación de IoT Central. De forma predeterminada, muestra todos los datos enviados por todos los dispositivos. Use el parámetro --device-id para filtrar a un dispositivo específico.

az iot central diagnostics monitor-events --app-id
                                          [--central-api-uri --central-dns-suffix]
                                          [--cg --consumer-group]
                                          [--device-id]
                                          [--enqueued-time --et]
                                          [--module-id]
                                          [--properties --props {all, anno, app, sys}]
                                          [--repair {false, true}]
                                          [--timeout --to]
                                          [--token]
                                          [--yes {false, true}]

Ejemplos

Basic usage

az iot central diagnostics monitor-events --app-id {app_id}

Uso básico al filtrar en el dispositivo de destino

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id}

Uso básico al filtrar dispositivos de destino con un carácter comodín en el identificador

az iot central diagnostics monitor-events --app-id {app_id} -d Device*d

Uso básico al filtrar en el módulo.

az iot central diagnostics monitor-events --app-id {app_id} -m {module_id}

Uso básico al filtrar módulos de destino con un carácter comodín en el identificador

az iot central diagnostics monitor-events --app-id {app_id} -m Module*

Filtre el dispositivo y especifique un grupo de consumidores del centro de eventos al que se va a enlazar.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Recibir anotaciones de mensaje (encabezados de mensaje)

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno

Recibir anotaciones de mensaje + propiedades del sistema. Nunca se agota el tiempo de espera.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno sys --timeout 0

Recepción de todos los atributos de mensaje de todos los mensajes de dispositivo

az iot central diagnostics monitor-events --app-id {app_id} --props all

Recepción de todos los mensajes y análisis de la carga de mensajes como JSON

az iot central diagnostics monitor-events --app-id {app_id} --output json

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad	Valor
Valor predeterminado:	azureiotcentral.com

--cg --consumer-group -c

Especifique el grupo de consumidores que se usará al conectarse al punto de conexión del centro de eventos.

Propiedad	Valor
Valor predeterminado:	$Default

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

--enqueued-time --et -e

Indica la hora que se debe usar como punto de partida para leer los mensajes de las particiones. Las unidades son milisegundos desde la época unix. Si no se indica "ahora" se usa ninguna hora.

--module-id -m

Identificador del módulo ioT Edge si el tipo de dispositivo es IoT Edge.

--properties --props -p

Indique las propiedades del mensaje clave que se van a generar. sys = propiedades del sistema, app = propiedades de la aplicación, anno = anotaciones.

Propiedad	Valor
Valores aceptados:	all, anno, app, sys

--repair -r

Vuelva a instalar la dependencia de uamqp compatible con la versión de la extensión. Default: false.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--timeout --to -t

Máximo de segundos para mantener la conexión sin recibir el mensaje. Use 0 para infinito.

Propiedad	Valor
Valor predeterminado:	300

--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

--yes -y

Omita las indicaciones del usuario. Indica la aceptación de la acción. Se usa principalmente para escenarios de automatización. Default: false.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot central diagnostics monitor-properties

Vista previa

El grupo de comandos "iot central diagnostics" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Vea las propiedades deseadas y notificadas enviadas a o desde la aplicación de IoT Central.

Sondea el dispositivo gemelo desde central y lo compara con las últimas propiedades del dispositivo gemelo Analiza las propiedades del dispositivo gemelo y detecta si se realizaron cambios En el subconjunto de propiedades que se cambiaron dentro del intervalo de sondeo.

az iot central diagnostics monitor-properties --app-id
                                              --device-id
                                              [--central-api-uri --central-dns-suffix]
                                              [--token]

Ejemplos

Basic usage

az iot central diagnostics monitor-properties --app-id {app_id} -d {device_id}

Parámetros requeridos

--app-id -n

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad	Valor
Valor predeterminado:	azureiotcentral.com

--token

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot central diagnostics registration-summary

Vista previa

El grupo de comandos "iot central diagnostics" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Vea el resumen de registro de todos los dispositivos de una aplicación.

Nota: Este comando puede tardar mucho tiempo en devolverse si la aplicación contiene una gran cantidad de dispositivos.

az iot central diagnostics registration-summary --app-id
                                                [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                                [--central-api-uri --central-dns-suffix]
                                                [--token]

Ejemplos

Registration summary

az iot central diagnostics registration-summary --app-id {appid}

Parámetros requeridos

--app-id -n

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version --av

Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad	Valor
Valor predeterminado:	2022-07-31
Valores aceptados:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad	Valor
Valor predeterminado:	azureiotcentral.com

--token

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot central diagnostics validate-messages

Vista previa

El grupo de comandos "iot central diagnostics" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Valide los mensajes enviados a IoT Hub para una aplicación de IoT Central.

Realiza validaciones en los mensajes de telemetría e informa de los datos que no están modelados en la plantilla de dispositivo o los datos en los que el tipo de datos no coincide con lo que se define en la plantilla de dispositivo.

az iot central diagnostics validate-messages --app-id
                                             [--central-api-uri --central-dns-suffix]
                                             [--cg --consumer-group]
                                             [--device-id]
                                             [--dr --duration]
                                             [--enqueued-time --et]
                                             [--max-messages --mm]
                                             [--minimum-severity {error, info, warning}]
                                             [--module-id]
                                             [--properties --props {all, anno, app, sys}]
                                             [--repair {false, true}]
                                             [--style {csv, json, scroll}]
                                             [--timeout --to]
                                             [--token]
                                             [--yes {false, true}]

Ejemplos

Basic usage

az iot central diagnostics validate-messages --app-id {app_id}

Errores de salida a medida que se detectan

az iot central diagnostics validate-messages --app-id {app_id} --style scroll

Uso básico al filtrar en el dispositivo de destino

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id}

Uso básico al filtrar dispositivos de destino con un carácter comodín en el identificador

az iot central diagnostics validate-messages --app-id {app_id} -d Device*

Uso básico al filtrar en el módulo.

az iot central diagnostics validate-messages --app-id {app_id} -m {module_id}

Uso básico al filtrar módulos de destino con un carácter comodín en el identificador

az iot central diagnostics validate-messages --app-id {app_id} -m Module*

Filtre el dispositivo y especifique un grupo de consumidores del centro de eventos al que se va a enlazar.

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Parámetros requeridos

--app-id -n

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad	Valor
Valor predeterminado:	azureiotcentral.com

--cg --consumer-group -c

Especifique el grupo de consumidores que se usará al conectarse al punto de conexión del centro de eventos.

Propiedad	Valor
Valor predeterminado:	$Default

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

--dr --duration

Duración máxima para recibir mensajes del dispositivo de destino antes de finalizar la conexión. Use 0 para infinito.

Propiedad	Valor
Valor predeterminado:	300

--enqueued-time --et -e

Indica la hora que se debe usar como punto de partida para leer los mensajes de las particiones. Las unidades son milisegundos desde la época unix. Si no se indica "ahora" se usa ninguna hora.

--max-messages --mm

Número máximo de mensajes que se van a recibir del dispositivo de destino antes de finalizar la conexión. Use 0 para infinito.

Propiedad	Valor
Valor predeterminado:	10

--minimum-severity

Gravedad mínima del problema necesaria para los informes.

Propiedad	Valor
Valor predeterminado:	warning
Valores aceptados:	error, info, warning

--module-id -m

Identificador del módulo ioT Edge si el tipo de dispositivo es IoT Edge.

--properties --props -p

Indique las propiedades del mensaje clave que se van a generar. sys = propiedades del sistema, app = propiedades de la aplicación, anno = anotaciones.

Propiedad	Valor
Valores aceptados:	all, anno, app, sys

--repair -r

Vuelva a instalar la dependencia de uamqp compatible con la versión de la extensión. Default: false.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--style

Indique los estilos de salidacroll = entregar errores a medida que llegan, json = resumir los resultados como json, csv = resumir los resultados como csv.

Propiedad	Valor
Valor predeterminado:	scroll
Valores aceptados:	csv, json, scroll

--timeout --to -t

Máximo de segundos para mantener la conexión sin recibir el mensaje. Use 0 para infinito.

Propiedad	Valor
Valor predeterminado:	300

--token

--yes -y

Omita las indicaciones del usuario. Indica la aceptación de la acción. Se usa principalmente para escenarios de automatización. Default: false.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot central diagnostics validate-properties

Vista previa

El grupo de comandos "iot central diagnostics" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Valide las propiedades notificadas enviadas a la aplicación de IoT Central.

Realiza validaciones en actualizaciones de propiedades notificadas:

Advertencia: propiedades enviadas por el dispositivo que no están modeladas en central.
Advertencia: las propiedades con el mismo nombre declarados en varias interfaces deben tener el nombre de interfaz incluido como parte de la actualización de propiedades.

az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri --central-dns-suffix]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Ejemplos

Basic usage

az iot central diagnostics validate-properties --app-id {app_id} -d {device_id}

Parámetros requeridos

--app-id -n

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad	Valor
Valor predeterminado:	azureiotcentral.com

--minimum-severity

Gravedad mínima del problema necesaria para los informes.

Propiedad	Valor
Valor predeterminado:	warning
Valores aceptados:	error, info, warning

--token

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Compartir a través de

az iot central diagnostics

Comandos

az iot central diagnostics monitor-events

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central diagnostics monitor-properties

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central diagnostics registration-summary

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central diagnostics validate-messages

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central diagnostics validate-properties

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios