Поиск и исправление устройств, отсутствующих в обновлении устройств для Центр Интернета вещей с помощью агента проверка

Узнайте, как использовать функцию агента проверка для поиска, диагностики и исправления устройств, отсутствующих в обновлении устройств для экземпляра Центр Интернета вещей.

Необходимые компоненты

• Доступ к Центр Интернета вещей с обновлением устройства для Центр Интернета вещей включен.
• Устройство Интернета вещей (или симулятор), подготовленное для обновления устройств и сообщающее совместимый идентификатор модели самонастраивающийся (PnP).

Примечание.

Компонент агента проверка может выполнять проверку только проверка на устройствах с установленным агентом обновления устройств и сообщает идентификатор модели PnP, соответствующий совместимым с обновлением устройств для Центр Интернета вещей.

Портал Azure

Поддерживаемые браузеры:

• Microsoft Edge
• Google Chrome

Azure CLI

Среда интерфейса командной строки Azure:

• Используйте среду Bash в Azure Cloud Shell.

  

• Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI

  1. Выполните вход в Azure CLI с помощью команды az login.
  2. Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.
  3. При появлении запроса установите расширения Azure CLI при первом использовании. В командах в этой статье используется расширение azure-iot. Запустите az extension update --name azure-iot и убедитесь, что используется последняя версия расширения.

Проверка проверки, поддерживаемые агентом проверка

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

Проверка	Критерии
Идентификатор модели PnP	Идентификатор модели PnP — это строка, сообщаемая агентом обновления устройства двойником устройства, в котором описывается, какую модель PnP следует использовать для взаимодействия с устройством или облаком. Эта строка должна быть допустимым идентификатором модели цифрового двойника (DTMI), поддерживающим интерфейс обновления устройства.
Идентификатор интерфейса	Идентификатор интерфейса — это строка, сообщаемая агентом обновления устройства двойником устройства, в котором описывается версия интерфейса обновления устройства для взаимодействия с устройством или облаком. Эта строка должна быть допустимым DTMI, поддерживающим интерфейс обновления устройства.
Имена свойств совместимости	CompatPropertyNames — это поле, сообщаемое агентом обновления устройств двойником устройства, в котором описывается, какие deviceProperties поля следует использовать для определения совместимости устройства с данным развертыванием. Это поле должно быть строкой имен с разделителями-запятыми. Строка должна содержать не менее одного и не более пяти имен. Каждое имя должно быть <32 символами.
Значения свойств совместимости	Значения свойств совместимости — это пары field:value, указанные compatPropertyNames полем и сообщаемые агентом обновления устройства двойнику устройства как deviceProperties. Каждое имя, определенное в именах свойств совместимости, должно иметь соответствующую пару field:value. Значение для каждой пары ограничено 64 символами.
Группа ADU	Тег группы ADU — это необязательный тег, определенный в двойнике устройства и определяющий группу устройств, к которой принадлежит устройство. Если задано, строка тега ограничена 255 символами и может содержать только буквенно-цифровые символы и следующие специальные символы: ". "-" "_" "~"

Если устройство завершается ошибкой любого из этих условий, оно может не отображаться должным образом в обновлении устройства. Исправление недопустимого значения в соответствии с указанными критериями должно привести к правильному отображению устройства в обновлении устройства. Если устройство не отображается в обновлении устройств или в проверка агента, может потребоваться запустить синхронизацию устройств, чтобы устранить эту проблему.

Просмотр результатов проверка агента

Портал Azure

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

1. Найдите нужный Центр Интернета вещей на портале Azure.
2. Выберите Обновления в меню навигации, а затем перейдите на вкладку "Диагностика".
3. Разверните раздел "Поиск отсутствующих устройств".

Azure CLI

Используйте az iot du device health list для просмотра работоспособности устройств.

Команда device health list принимает следующие аргументы:

• --account: имя учетной записи обновления устройства.
• --instance: имя экземпляра обновления устройства.
• --filter: фильтр работоспособности устройства( фильтрация по состоянию устройства или идентификатору устройства). Например:
  • Чтобы получить список всех работоспособных устройств, выполните фильтрацию по state eq 'Healthy'
  • Чтобы получить список всех неработоспособных устройств, выполните фильтрацию по state eq 'Unhealthy'
  • Чтобы показать состояние работоспособности целевого устройства, выполните фильтрацию по deviceId eq '<device_name>' или deviceId eq '<device_name>' and moduleId eq '<module_name>'

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

Запуск операции синхронизации устройств

Синхронизация устройств должна быть активирована, если устройство зарегистрировано в Центре Интернета вещей, но не отображается в обновлении устройств или в результатах проверка агента.

Для каждого экземпляра обновления устройства может быть активна только одна операция синхронизации устройств.

Портал Azure

1. Найдите нужный Центр Интернета вещей на портале Azure.
2. Выберите Обновления в меню навигации, а затем перейдите на вкладку "Диагностика".
3. Разверните раздел "Просмотр работоспособности устройства".
4. Нажмите кнопку "Запуск синхронизации устройств".

Azure CLI

Используйте az iot du device import для импорта устройств и модулей в экземпляр обновления устройств из связанного центра Интернета вещей.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

Следующие шаги

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