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

Обзор обновления устройства для диагностики Центра Интернета вещей

Обновление устройств для Центра Интернета вещей содержит несколько функций, которые помогают диагностировать и устранять ошибки на стороне устройства. Доступны три функции диагностики:

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

  • Удаленная коллекция журналов позволяет создавать операции журналов, которые указывают целевым устройствам отправлять журналы диагностики на устройстве в связанную учетную запись хранения BLOB-объектов Azure.

  • Проверка агента выполняет проверку на устройствах, зарегистрированных в экземпляре Device Update, с целью диагностики устройств, зарегистрированных в подключенном Центре Интернета вещей, но не отображаются в Device Update.

Коды ошибок развертывания в пользовательском интерфейсе

Когда устройство сообщает о сбое развертывания в службу обновления устройств, пользовательский интерфейс отображает переданные устройством параметры resultCode и extendedResultCode. Чтобы просмотреть эти коды, выполните следующие действия.

  1. Найдите нужный Центр Интернета вещей на портале Azure.

  2. Выберите "Обновления", а затем перейдите на вкладку "Группы и развертывания".

  3. Выберите имя группы с активным развертыванием, чтобы открыть страницу сведений о группе .

  4. Выберите любое имя устройства в списке устройств , чтобы открыть панель сведений об устройстве. Здесь вы увидите код результата, сообщаемого устройством.

  5. Эталонный агент Device Update соответствует стандартному соглашению об использовании кодов состояния HTTP для поля с кодом результата (например, "200" указывает на успешное выполнение). Дополнительные сведения о анализе кодов результатов см. в разделе "Коды ошибок клиента обновления устройства".

    Замечание

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

Сбор удаленных журнальных данных

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

Сбор удаленных журналов обновлений устройств — это функция, управляемая службами и выполняемая на основе операций. Чтобы воспользоваться преимуществами сбора журналов, устройство должно реализовать интерфейс диагностики и файл конфигурации, а также загрузить файлы в хранилище BLOB-объектов Azure с помощью SDK.

На высоком уровне функция сбора журналов работает следующим образом:

  1. Вы создаете новую операцию журнала, используя интерфейс пользователя или API обновления устройства, ориентированную на до 100 устройств, которые реализовали интерфейс диагностики.

  2. Служба обновления устройств отправляет сообщение о начале сбора журналов на целевые устройства с помощью интерфейса диагностики. Это начальное сообщение включает идентификатор операции журнала и маркер SAS для отправки в ассоциированную учетную запись Azure Storage.

  3. После получения начального сообщения агент обновления устройств целевого устройства пытается собрать и отправить файлы в один или несколько предварительно определенных файловых путей, указанных в файле конфигурации агента на устройстве. Агент Device Update настроен для отправки журнала диагностики агента Device Update (aduc.log) и журнала диагностики агента DO ("do-agent.log") по умолчанию.

  4. Затем агент обновления устройств сообщает о состоянии операции (Успешно или Ошибка) в службу, включая идентификатор операции журнала, результирующий код и расширенный код результата. Если при выполнении операции журнала произошел сбой, агент обновления устройств автоматически пытается повторить действие три раза, сообщая только конечное состояние обратно в службу.

  5. После того как все целевые устройства сообщили о своем состоянии терминала обратно в службу обновления устройств, служба обновления устройств помечает операцию обновления устройства как "Успешно" или " Сбой". Успешная операция регистрации указывает, что все целевые устройства успешно завершили операцию регистрации. Сбой операции журнала указывает на то, что по крайней мере для одного целевого устройства операция журнала завершилась неудачей.

    Замечание

    Так как операция журнала выполняется параллельно целевыми устройствами, возможно, что некоторые целевые устройства успешно отправили журналы, но общая операция журнала помечается как сбой. Вы можете увидеть, какие устройства завершились успешно и какие - сбоем, просмотрев сведения об операции журнала через пользовательский интерфейс или API.

Проверка агента

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

На высоком уровне функция проверки агента работает следующим образом:

  1. Вы регистрируете устройство в Центре Интернета вещей. Если устройство сообщает идентификатор модели, соответствующий тем, которые совместимы с обновлением устройств для Центра обновления IoT Hub, подключенный экземпляр автоматически регистрирует устройство с помощью Центра обновления.
  2. Чтобы устройство могло правильно управляться с помощью Device Update, оно должно соответствовать определенным критериям, которые можно проверить с помощью заранее подготовленных проверок Agent Check. Дополнительные сведения об этих критериях см. здесь.
  3. Если устройство не соответствует всем этим критериям, оно не может быть правильно управляемым обновлением устройства и не отображается в интерфейсе обновления устройства или ответах API. С помощью Agent Check можно найти это устройство и попытаться определить, какие критерии не выполнены.
  4. Когда вы определили, какие критерии не выполняются, вы можете исправить проблему, и устройство должно правильно отображаться в интерфейсе обновления устройств.

Дальнейшие шаги

Узнайте, как использовать функцию удаленного сбора логов Device Update и функции проверки агента:

  • Last updated on