Обзор функций диагностики в службе "Обновление устройств для Центра Интернета вещей"
Обновление устройств для Центра Интернета вещей имеет несколько функций, упрощающих диагностику и устранение ошибок на стороне устройств. В выпуске агента версии 0.9.0 доступны три функции диагностики:
Коды ошибок развертывания можно просмотреть непосредственно в пользовательском интерфейсе обновления устройств.
Удаленный сбор журналов позволяет создавать операции с журналами, которые предписывают целевым устройствам отправлять журналы диагностики устройства в связанную учетную запись Хранилища BLOB-объектов Azure.
Проверка агента выполняет проверочные проверки на устройствах, зарегистрированных в экземпляре Обновления устройств, с целью диагностики устройств, которые зарегистрированы в подключенном Центр Интернета вещей, но не отображаются в обновлении устройств.
Коды ошибок развертывания в пользовательском интерфейсе
Когда устройство сообщает в службу "Обновление устройств" об ошибке развертывания, пользовательский интерфейс этой службы отображает переданные устройством значения resultCode и extendedResultCode. Чтобы просмотреть этом код, выполните следующие действия:
Найдите нужный Центр Интернета вещей на портале Azure.
Выберите Обновления и перейдите на вкладку Группы и развертывания.
Щелкните имя группы с активным развертыванием, чтобы перейти на страницу Сведения о группе.
Выберите какое-нибудь имя устройства в списке устройств, чтобы открыть панель сведений об устройстве. Здесь можно просмотреть код результата, переданный устройством.
Эталонный агент Обновления устройств действует согласно стандартному соглашению о кодах состояния HTTP для поля кода результата (например, "200" означает успешное выполнение). Дополнительные сведения о том, как анализировать коды результатов, см. на странице Коды ошибок клиента Обновлений устройств.
Примечание
Если вы изменили агент Обновления устройств для выдачи настраиваемых кодов результатов, числовые коды будут по-прежнему передаваться в пользовательский интерфейс Обновления устройств. Вы можете обратиться к любой документации, посвященной анализу этих числовых кодов.
Удаленный сбор журналов
Если для диагностики и устранения ошибок требуется дополнительная информация с устройства, можно использовать функцию сбора журналов, чтобы велеть целевым устройствам передавать журналы диагностики устройств в связанную учетную запись Хранилища BLOB-объектов Azure. Вы можете начать использовать эту функцию, следуя инструкциям в разделе Удаленный сбор журналов диагностики с устройств.
Удаленный сбор журналов в службе Обновления устройств — это управляемая службой функция, основанная на операциях. Чтобы воспользоваться преимуществами сбора журналов, устройство должно иметь возможность реализовать интерфейс диагностики и файл конфигурации, а также отправлять файлы в хранилище BLOB-объектов Azure с помощью пакета SDK.
В общих чертах эта функция работает следующим образом:
Пользователь создает операцию с журналом с помощью пользовательского интерфейса Обновления устройств или интерфейсов API, при этом в качестве целевых устройств выступают до 100 устройств, реализовавших интерфейс диагностики.
Служба "Обновление устройств" отправляет сообщение о запуске сбора журналов на целевые устройства с помощью интерфейса диагностики. Это сообщение о запуске содержит идентификатор операции с журналом и маркер SAS для отправки в связанную учетную запись хранения Azure.
После получения сообщения о запуске агент Обновления устройств целевого устройства пытается собрать и отправить файлы по предварительно определенным путям, указанным в файле конфигурации агента устройства. Эталонный агент Обновления устройств настроен для отправки журнала диагностики агента Обновления устройств (
aduc.log) и журнала диагностики агента DO (do-agent.log) по умолчанию.Затем агент Обновления устройств сообщает о состоянии операции (Успешно или Сбой) обратно в службу, указав идентификатор операции с журналом, ResultCode и ExtendedResultCode. Если агенту Обновления устройств не удается выполнить операцию с журналом, он автоматически попытается повторить попытку три раза, сообщая обратно в службу только конечное состояние.
После того как все целевые устройства передали окончательное состояние обратно в службу "Обновление устройств", она помечает операцию с журналом как Успешно или Сбой. Успешная операция с журналом обозначает, что все целевые устройства успешно завершили операцию с журналом. Сбой операции с журналом обозначает, что по меньшей мере одному целевому устройству не удалось выполнить операцию с журналом.
Примечание
Так как операция с журналом выполняется целевыми устройствами параллельно, возможно, что некоторые целевые устройства успешно загрузили журналы, но общая операция журнала помечена как неудачная. Вы можете увидеть, с какими устройствами операции выполнены успешно, а с какими завершились сбоем, ознакомившись со сведениями об операциях с журналом с помощью пользовательского интерфейса или API.
Проверка агента
Если устройство зарегистрировано в Центр Интернета вещей но не отображается в экземпляре обновления устройства, можно использовать функцию проверки агента для выполнения предварительно выполненных проверок, которые помогут диагностировать базовую проблему. Вы можете начать использовать эту функцию, следуя этим инструкциям по проверке агента.
На высоком уровне функция проверки агента работает следующим образом:
Пользователь регистрирует устройство с помощью Центр Интернета вещей. Если устройство сообщает идентификатор модели, соответствующий идентификаторам, совместимым с Обновлением устройств для Центр Интернета вещей, подключенный экземпляр обновления устройств пользователя автоматически зарегистрирует устройство в службе "Обновление устройства".
Для правильного управления устройством с помощью Обновления устройств оно должно соответствовать определенным критериям, которые можно проверить с помощью предварительно выполненных проверок проверки агента. Дополнительные сведения об этих критериях можно найти здесь.
Если устройство не соответствует всем этим критериям, оно не может правильно управляться обновлением устройств и не будет отображаться в интерфейсе обновления устройства или ответах API. Пользователи могут использовать проверку агента, чтобы найти это устройство и попытаться определить, какие критерии не выполняются с помощью проверки агента.
После того как пользователь определил, какие условия не выполняются, он может исправить проблему, и устройство должно правильно отображаться в интерфейсе обновления устройства.
Дальнейшие действия
Узнайте, как использовать функции удаленного сбора журналов обновления устройств и проверки агента: