Поделиться через

az iot central diagnostics

  • Предварительный просмотр
  • Ссылка

Примечание.

Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.46.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot central диагностика. Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Выполнение диагностика уровня приложения и устройства.

Команды

Имя Описание Тип Состояние
az iot central diagnostics monitor-events

Просмотр сообщений телеметрии устройства, отправленных в приложение IoT Central.

 Расширение Предварительный просмотр
az iot central diagnostics monitor-properties

Просмотр требуемых и сообщаемых свойств, отправленных в приложение IoT Central или из нее.

 Расширение Предварительный просмотр
az iot central diagnostics registration-summary

Просмотрите сводку регистрации всех устройств в приложении.

 Расширение Предварительный просмотр
az iot central diagnostics validate-messages

Проверьте сообщения, отправленные в Центр Интернета вещей для приложения IoT Central.

 Расширение Предварительный просмотр
az iot central diagnostics validate-properties

Проверьте сообщаемые свойства, отправленные в приложение IoT Central.

 Расширение Предварительный просмотр

az iot central diagnostics monitor-events

Предварительный просмотр

Группа команд iot central диагностика находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Просмотр сообщений телеметрии устройства, отправленных в приложение IoT Central.

Отображает данные телеметрии, отправленные в приложение IoT Central. По умолчанию отображаются все данные, отправляемые всеми устройствами. Используйте параметр --device-id для фильтрации на определенное устройство.

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

Примеры

Базовое использование

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

Базовое использование при фильтрации на целевом устройстве

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

Базовое использование при фильтрации целевых устройств с подстановочным знаком в идентификаторе

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

Базовое использование при фильтрации в модуле.

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

Базовое использование при фильтрации целевых модулей с подстановочным знаком в идентификаторе

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

Отфильтруйте устройство и укажите группу потребителей Концентратора событий для привязки.

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

Получение заметок сообщения (заголовки сообщений)

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

Получение заметок сообщения + системных свойств. Никогда не истекает время ожидания.

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

Получение всех атрибутов сообщения из всех сообщений устройства

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

Получение всех сообщений и полезных данных для анализа сообщений в формате JSON

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

Обязательные параметры

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

Необязательные параметры

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

Суффикс DNS IoT Central, связанный с приложением.

Default value: azureiotcentral.com
--cg --consumer-group -c

Укажите группу потребителей, используемую при подключении к конечной точке концентратора событий.

Default value: $Default
--device-id -d

Идентификатор устройства целевого устройства. Идентификатор устройства можно найти, нажав кнопку "Подключить" на странице сведений об устройстве.

--enqueued-time --et -e

Указывает время, которое следует использовать в качестве отправной точки для чтения сообщений из секций. Единицы являются миллисекундами с эпохи UNIX. Если время не указано "сейчас", используется.

--module-id -m

Идентификатор модуля IoT Edge, если тип устройства — IoT Edge.

--properties --props -p

Укажите ключевые свойства сообщения для вывода. sys = системные свойства, приложение = свойства приложения, anno = заметки.

Допустимые значения: all, anno, app, sys
--repair -r

Переустановите зависимость uamqp, совместимую с версией расширения. По умолчанию: false.

Допустимые значения: false, true
Default value: False
--timeout --to -t

Максимальное количество секунд для поддержания подключения без получения сообщения. Используйте 0 для бесконечности.

Default value: 300
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

--yes -y

Пропустить запросы пользователей. Указывает на принятие действия. Используется в основном для сценариев автоматизации. По умолчанию: false.

Допустимые значения: false, true
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot central diagnostics monitor-properties

Предварительный просмотр

Группа команд iot central диагностика находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Просмотр требуемых и сообщаемых свойств, отправленных в приложение IoT Central или из нее.

Опрашивает двойник устройства из центра и сравнивает его с последним анализом свойств двойника устройства из двойника устройства и определяет, были ли изменения внесены в подмножество свойств, которые были изменены в интервале опроса.

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

Примеры

Базовое использование

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

Обязательные параметры

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

--device-id -d

Идентификатор устройства целевого устройства. Идентификатор устройства можно найти, нажав кнопку "Подключить" на странице сведений об устройстве.

Необязательные параметры

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

Суффикс DNS IoT Central, связанный с приложением.

Default value: azureiotcentral.com
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot central diagnostics registration-summary

Предварительный просмотр

Группа команд iot central диагностика находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Просмотрите сводку регистрации всех устройств в приложении.

Примечание. Эта команда может занять значительное время, чтобы вернуться, если приложение содержит много устройств.

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

Примеры

Сводка по регистрации

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

Обязательные параметры

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

Необязательные параметры

--api-version --av
Не рекомендуется

Аргумент "api_version" устарел и будет удален в будущем выпуске.

Этот параметр команды не рекомендуется использовать и будет игнорироваться. В будущем выпуске мы будем поддерживать только API IoT Central из последней версии общедоступной версии. Если любой API еще не является общедоступной, мы вызовем последнюю предварительную версию.

Допустимые значения: 2022-06-30-preview, 2022-07-31
Default value: 2022-07-31
--central-api-uri --central-dns-suffix

Суффикс DNS IoT Central, связанный с приложением.

Default value: azureiotcentral.com
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot central diagnostics validate-messages

Предварительный просмотр

Группа команд iot central диагностика находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Проверьте сообщения, отправленные в Центр Интернета вещей для приложения IoT Central.

Выполняет проверку сообщений телеметрии и сообщает обратно данные, которые не моделировались в шаблоне устройства или данных, где тип данных не соответствует определенному в шаблоне устройства.

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

Примеры

Базовое использование

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

Ошибки вывода при обнаружении

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

Базовое использование при фильтрации на целевом устройстве

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

Базовое использование при фильтрации целевых устройств с подстановочным знаком в идентификаторе

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

Базовое использование при фильтрации в модуле.

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

Базовое использование при фильтрации целевых модулей с подстановочным знаком в идентификаторе

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

Отфильтруйте устройство и укажите группу потребителей Концентратора событий для привязки.

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

Обязательные параметры

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

Необязательные параметры

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

Суффикс DNS IoT Central, связанный с приложением.

Default value: azureiotcentral.com
--cg --consumer-group -c

Укажите группу потребителей, используемую при подключении к конечной точке концентратора событий.

Default value: $Default
--device-id -d

Идентификатор устройства целевого устройства. Идентификатор устройства можно найти, нажав кнопку "Подключить" на странице сведений об устройстве.

--dr --duration

Максимальная длительность получения сообщений от целевого устройства перед завершением подключения. Используйте 0 для бесконечности.

Default value: 300
--enqueued-time --et -e

Указывает время, которое следует использовать в качестве отправной точки для чтения сообщений из секций. Единицы являются миллисекундами с эпохи UNIX. Если время не указано "сейчас", используется.

--max-messages --mm

Максимальное количество сообщений для получения от целевого устройства перед завершением подключения. Используйте 0 для бесконечности.

Default value: 10
--minimum-severity

Минимальная серьезность проблемы, необходимой для создания отчетов.

Допустимые значения: error, info, warning
Default value: warning
--module-id -m

Идентификатор модуля IoT Edge, если тип устройства — IoT Edge.

--properties --props -p

Укажите ключевые свойства сообщения для вывода. sys = системные свойства, приложение = свойства приложения, anno = заметки.

Допустимые значения: all, anno, app, sys
--repair -r

Переустановите зависимость uamqp, совместимую с версией расширения. По умолчанию: false.

Допустимые значения: false, true
Default value: False
--style

Укажите выходные стилиcroll = доставить ошибки по мере их поступления, json = суммировать результаты в формате json, csv = суммировать результаты в формате CSV.

Допустимые значения: csv, json, scroll
Default value: scroll
--timeout --to -t

Максимальное количество секунд для поддержания подключения без получения сообщения. Используйте 0 для бесконечности.

Default value: 300
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

--yes -y

Пропустить запросы пользователей. Указывает на принятие действия. Используется в основном для сценариев автоматизации. По умолчанию: false.

Допустимые значения: false, true
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot central diagnostics validate-properties

Предварительный просмотр

Группа команд iot central диагностика находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Проверьте сообщаемые свойства, отправленные в приложение IoT Central.

Выполняет проверки при обновлении сообщаемого свойства:

  1. Предупреждение — свойства, отправляемые устройством, которое не моделировалось в центре.
  2. Предупреждение. Свойства с одинаковым именем, объявленным в нескольких интерфейсах, должны содержать имя интерфейса в рамках обновления свойства.
az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Примеры

Базовое использование

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

Обязательные параметры

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

--device-id -d

Идентификатор устройства целевого устройства. Идентификатор устройства можно найти, нажав кнопку "Подключить" на странице сведений об устройстве.

Необязательные параметры

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

Суффикс DNS IoT Central, связанный с приложением.

Default value: azureiotcentral.com
--minimum-severity

Минимальная серьезность проблемы, необходимой для создания отчетов.

Допустимые значения: error, info, warning
Default value: warning
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.