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

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

• Microsoft Edge
• Google Chrome

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

• Используйте среду 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 и убедитесь, что используется последняя версия расширения.

1. На портале Azure перейдите к учетной записи Обновления устройств для Центра Интернета вещей.

2. Выберите Экземпляры в разделе Управление экземплярами области навигации.

3. Выберите из списка экземпляр Обновления устройства, а затем — Настроить диагностику.

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

5. Выберите нужную учетную запись хранения в списке и нажмите кнопку Сохранить.

6. Вернувшись в список экземпляров, нажимайте Обновить, пока состояние подготовки экземпляра не отобразится как "Выполнено". Обычно это занимает 2–3 минуты.

Используйте команду 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>

1. Перейдите в Центр Интернета вещей и выберите вкладку Обновления в разделе Управление устройствами области навигации.

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

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

4. Введите имя (идентификатор) и описание для новой операции с журналом, а затем выберите Добавить устройства, чтобы выбрать устройства Интернета вещей, из которых требуется сбор журналов диагностики.

5. Выберите Добавить.

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

7. После успешной или неудачной операции выберите имя операции, чтобы просмотреть подробные сведения о ней. Операция будет помечена как "успешная", только если все целевые устройства успешно выполнили отправку журнала. Если некоторые целевые устройства выполнили действие успешно, и некоторые завершились сбоем, операция журнала будет отмечена как "неудачная". На странице сведений об операции в журнале можно узнать, какие устройства завершились успешно, а какие — нет.

8. В разделе сведений об операции с журналом можно просмотреть состояние конкретного устройства и просмотреть путь к расположению журнала. Этот путь соответствует пути к виртуальному каталогу в учетной записи хранилища BLOB-объектов 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>