Удаленный сбор журналов диагностики с устройств с помощью Устройства Обновления для Центра Интернета вещей

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

Предпосылки

Доступ к Центру Интернета вещей с включенным обновлением устройств для Центра Интернета вещей.
Устройство Интернета вещей (или симулятор), подготовленное для обновления устройств в Центре Интернета вещей и реализация интерфейса диагностики.
Учетная запись хранения BLOB-объектов Azure под той же подпиской, что и учетная запись обновления устройства для IoT Hub.

Замечание

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

Портал Azure
Azure CLI

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

Microsoft Edge
Google Chrome

Среда Azure CLI:

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

Подсказка

Команды Azure CLI в этой статье используют символ обратной косой черты \ для продолжения строки, чтобы аргументы команд были проще читать. Этот синтаксис работает в средах Bash. Если вы выполняете эти команды в PowerShell, замените каждую обратную косую черту обратной чертой "", или удалите их полностью.

Подключите ваш аккаунт Azure Blob Storage к экземпляру обновления устройства

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

Портал Azure
Azure CLI

На портале Azure перейдите к учетной записи центра Интернета вещей с обновлением устройств.
Выберите экземпляры в разделе Управление экземплярами области навигации.
Выберите экземпляр обновления устройства из списка, а затем настройте диагностику.
Перейдите на вкладку "Диагностика клиентов ", а затем выберите учетную запись хранения Azure.
Выберите нужную учетную запись хранения из списка и нажмите кнопку "Сохранить".
Вернувшись в список экземпляров, периодически выберите "Обновить" , пока состояние подготовки экземпляра не отображается "Успешно". Обычно этот процесс занимает 2–3 минуты.

Используйте команду az iot du instance create , чтобы настроить диагностику для экземпляра обновления устройства.

Подсказка

Вы можете использовать команду az iot du instance create на существующем экземпляре обновления устройств, и она настроит экземпляр с обновленными параметрами.

Замените следующие заполнители собственными сведениями:

< >account_name: имя учетной записи обновления устройства.
< >instance_name: имя экземпляра обновления устройства.
< >storage_id. Идентификатор ресурса учетной записи хранения, в которой будут храниться журналы диагностики. Идентификатор ресурса можно получить с помощью команды az storage show и запроса для значения идентификатора: az storage account show -n <storage_name> --query id

az iot du instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

Настройка сбора журналов

Агент обновления устройства ссылается на файл конфигурации на устройстве, расположенный по адресу /etc/adu/du-diagnostics-config.json в эталонном агенте.

Пути к файлу сбора журналов

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

В файле конфигурации каждый файл журнала для сбора и отправки представлен как logComponent объект со свойствами componentName и logPath. Эту конфигурацию можно изменить по желанию.

Максимальный размер файла журнала

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

Соответствующий параметр maxKilobytesToUploadPerLogPath применяется к каждому объекту logComponent и может быть изменен по желанию.

Создать операцию журнала

Операции журнала — это действие, управляемое службой, которое можно указать устройствам Интернета вещей выполнять через службу обновления устройств. Более подробное описание функции операций журналов см. в разделе диагностики обновления устройств.

Портал Azure
Azure CLI

Перейдите в Центр Интернета вещей и выберите вкладку "Обновления" в разделе "Управление устройствами " области навигации.
Выберите вкладку "Диагностика " в пользовательском интерфейсе. Если вы не видите вкладку диагностики, убедитесь, что вы используете последнюю версию пользовательского интерфейса Центра Интернета вещей. Если вы видите сообщение «Для этого экземпляра обновления устройств должна быть включена диагностика», убедитесь, что вы связали учетную запись хранилища объектов Blob Azure с экземпляром обновления устройств.
Выберите "Добавить операцию отправки журнала" , чтобы перейти на страницу создания операции журнала.
Введите имя (идентификатор) и описание для новой операции журнала, а затем выберите " Добавить устройства ", чтобы выбрать устройства Интернета вещей, из которых требуется собирать журналы диагностики.
Нажмите кнопку "Добавить".
Вернувшись на вкладку "Диагностика", выберите "Обновить ", пока не увидите операцию журнала, указанную в таблице операций.
После успешного выполнения операции или сбоя выберите имя операции, чтобы просмотреть его сведения. Операция будет помечена как "Успешно выполнена" только в том случае, если все целевые устройства успешно завершили отправку журнала. Если некоторые целевые устройства завершились успешно, а некоторые — сбоем, операция в журнале будет помечена как "Сбой". Вы можете использовать страницу сведений об операции журнала, чтобы узнать, какие устройства завершились успешно, а какие — сбоем.
В сведениях об операции журнала можно просмотреть состояние конкретного устройства и просмотреть путь к расположению журнала. Этот путь соответствует пути виртуального каталога в учетной записи хранения блобов Azure, куда были загружены журналы диагностики.

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

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

--account: имя учетной записи обновления устройства.
--instance: имя экземпляра обновления устройства.
--log-collection-id: имя операции сбора журналов.
--agent-id: пары key=value, определяющие целевой агент обновления устройств для этой операции сбора журналов. Используйте deviceId=<device name>, если агент имеет идентификатор устройства. Используйте deviceId=<device name> moduleId=<module name>, если агент имеет идентификацию модуля. Параметр можно использовать --agent-id несколько раз для назначения нескольких устройств.

Рассмотрим пример.

az iot du device log collect \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name} \
    --agent-id deviceId=<device name> \
    --agent-id deviceId=<device name> moduleId=<module name>

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

az iot du device log show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name>

Просмотр и экспорт собранных журналов диагностики

После успешной операции записи перейдите к учетной записи хранилища Blob в Azure.
Выберите контейнеры в разделе хранилища данных области навигации.
Выберите контейнер с тем же именем, что и экземпляр обновления устройства.
Используйте путь расположения журнала из сведений о журнале операции, чтобы перейти в нужный каталог, содержащий журналы. По умолчанию функция удаленного сбора журналов предписывает целевым устройствам отправлять журналы диагностики с помощью следующей модели пути к каталогу: контейнер хранилища BLOB-объектов/идентификатор целевого устройства/идентификатор операции журнала/путь журнала на устройстве
Если компонент диагностики агента обновления устройства не изменен, устройство будет реагировать на любую операцию журнала, пытаясь отправить два файла журнала с открытым текстом: журнал диагностики агента обновления устройства ("aduc.log"), а также журнал диагностики агента DO ("do-agent.log"). Вы можете узнать больше о том, какие файлы журналов собирает справочный агент по обновлению устройств, прочитав страницу концепции диагностики обновлений устройств.
Содержимое файла журнала можно просмотреть, выбрав имя файла, а затем выберите элемент меню (многоточие) и нажмите кнопку "Вид или изменить". Вы также можете скачать или удалить файл журнала, выбрав соответствующие параметры.

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-05-29