Zdalne zbieranie dzienników diagnostycznych z urządzeń przy użyciu usługi Device Update dla usługi IoT Hub

Dowiedz się, jak zainicjować operację rejestrowania aktualizacji urządzenia dla usługi IoT Hub i wyświetlić zebrane dzienniki w Azure Blob Storage.

Wymagania wstępne

Połącz swoje konto Azure Blob Storage z instancją Device Update

Aby móc korzystać z funkcji zbierania dzienników zdalnych, musisz najpierw połączyć konto usługi Azure Blob Storage z instancją usługi Device Update. To konto usługi Azure Blob Storage to miejsce, do którego urządzenia będą przekazywać dzienniki diagnostyczne.

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

Konfigurowanie zbierania dzienników

Agent aktualizacji urządzenia odwołuje się do pliku konfiguracji na urządzeniu znajdującego się w lokalizacji /etc/adu/du-diagnostics-config.json w agencie odniesienia.

Ścieżki plików do zbierania dzienników

Agent usługi Device Update na urządzeniu będzie zbierał pliki z określonych ścieżek plików na urządzeniu po odebraniu sygnału uruchomienia przekazywania dziennika z usługi Device Update. Te ścieżki plików są definiowane w pliku konfiguracji diagnostyki.

W pliku konfiguracyjnym każdy plik dziennika do zebrania i przekazania jest reprezentowany jako logComponent obiekt z właściwościami componentName i logPath. Tę konfigurację można zmodyfikować zgodnie z potrzebami.

Maksymalny rozmiar pliku dziennika

Agent usługi Device Update będzie zbierał tylko pliki dziennika o określonym rozmiarze. Ten maksymalny rozmiar pliku jest zdefiniowany w pliku konfiguracji diagnostyki.

Odpowiedni parametr "maxKilobytesToUploadPerLogPath" będzie stosowany do każdego obiektu logComponent i można go zmodyfikować zgodnie z potrzebami.

Tworzenie operacji logowania

Operacje logowania to działania oparte na usłudze, które można zlecić urządzeniom IoT do wykonania poprzez usługę Device Update. Aby uzyskać bardziej szczegółowe wyjaśnienie sposobu działania operacji dzienników, zobacz Diagnostyka aktualizacji urządzeń.

1. Przejdź do centrum IoT Hub i wybierz kartę Aktualizacje w sekcji Zarządzanie urządzeniami w okienku nawigacji.

2. Wybierz kartę Diagnostyka w interfejsie użytkownika. Jeśli nie widzisz karty Diagnostyka, upewnij się, że używasz najnowszej wersji interfejsu użytkownika usługi Device Update for IoT Hub. Jeśli widzisz komunikat "Diagnostyka musi być włączona dla tego wystąpienia aktualizacji urządzenia", upewnij się, że połączono konto usługi Azure Blob Storage z wystąpieniem usługi Device Update.

3. Wybierz Dodaj operację przesyłania logów, aby przejść do strony tworzenia operacji dziennika.

4. Wprowadź nazwę (identyfikator) i opis nowej operacji dziennika, a następnie wybierz pozycję Dodaj urządzenia , aby wybrać urządzenia IoT, z których chcesz zbierać dzienniki diagnostyczne.

5. Wybierz Dodaj.

6. Po powrocie na kartę Diagnostyka wybierz pozycję Odśwież , dopóki nie zostanie wyświetlona operacja dziennika wyświetlana w tabeli operacji.

7. Gdy stan operacji to Powodzenie lub Niepowodzenie, wybierz nazwę operacji, aby wyświetlić jej szczegóły. Operacja zostanie oznaczona jako "Powodzenie" tylko wtedy, gdy wszystkie docelowe urządzenia pomyślnie ukończyły przesłanie dziennika. Jeśli niektóre docelowe urządzenia zakończyły się pomyślnie i niektóre zakończyły się niepowodzeniem, operacja dziennika zostanie oznaczona jako "Niepowodzenie". Możesz użyć strony szczegółów operacji dziennika, aby zobaczyć, które urządzenia zakończyły się pomyślnie i które zakończyły się niepowodzeniem.

8. W szczegółach operacji dziennika można wyświetlić stan specyficzny dla urządzenia i wyświetlić ścieżkę lokalizacji dziennika. Ta ścieżka odpowiada ścieżce katalogu wirtualnego w koncie Azure Blob Storage, do którego zostały przesłane dzienniki diagnostyczne.

Wyświetlanie i eksportowanie zebranych dzienników diagnostycznych

1. Po zakończeniu operacji logowania przejdź do konta Azure Blob Storage.

2. Wybierz pozycję Kontenery w sekcji Magazyn danych w okienku nawigacji.

3. Wybierz kontener o takiej samej nazwie jak wystąpienie usługi Device Update.

4. Użyj ścieżki lokalizacji dziennika ze szczegółów operacji dziennika, aby przejść do poprawnego katalogu zawierającego dzienniki. Domyślnie funkcja zdalnego zbierania dzienników instruuje urządzenia docelowe do przesyłania dzienników diagnostycznych przy użyciu następującego modelu ścieżki katalogu: Kontener magazynu obiektów blob/Identyfikator urządzenia docelowego/Identyfikator operacji dziennika/Ścieżka dziennika na urządzeniu

5. Jeśli składnik diagnostyczny agenta DU nie został zmodyfikowany, urządzenie odpowie na dowolną operację dziennika, próbując przekazać dwa pliki dziennika w postaci zwykłego tekstu: dziennik diagnostyczny agenta DU ("aduc.log") i dziennik diagnostyczny agenta DO ("do-agent.log"). Aby dowiedzieć się więcej na temat plików dziennika zbieranych przez agenta referencyjnego DU, przeczytaj stronę opisującą diagnostykę aktualizacji urządzenia.

6. Zawartość pliku dziennika można wyświetlić, wybierając nazwę pliku, a następnie wybierając element menu (wielokropek), a następnie klikając pozycję Wyświetl/edytuj. Możesz również pobrać lub usunąć plik dziennika, wybierając odpowiednio oznaczone opcje.

   

Następne kroki

Aby dowiedzieć się więcej o możliwościach diagnostycznych usługi Device Update, zobacz Omówienie funkcji diagnostycznych aktualizacji urządzeń