Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Usługa Device Update dla usługi IoT Hub ma kilka funkcji, które ułatwiają diagnozowanie i rozwiązywanie problemów z błędami po stronie urządzenia. Dostępne są trzy funkcje diagnostyczne:
Kody błędów wdrażania można wyświetlić bezpośrednio w interfejsie użytkownika usługi Device Update.
Zdalne zbieranie dzienników umożliwia tworzenie operacji dziennika, które instruują docelowe urządzenia do przekazywania dzienników diagnostycznych na urządzeniu do połączonego konta usługi Azure Blob Storage.
Weryfikacja agenta przeprowadza weryfikację poprawności urządzeń zarejestrowanych w wystąpieniu usługi Device Update w celu diagnozowania urządzeń zarejestrowanych w połączonym z IoT Hub, ale nie pojawiających się w usłudze Device Update.
Kody błędów wdrożenia w interfejsie użytkownika
Gdy urządzenie zgłasza błąd wdrożenia do usługi Device Update, interfejs użytkownika Device Update wyświetla zgłoszone elementy resultCode i extendedResultCode urządzenia w interfejsie użytkownika. Aby wyświetlić następujące kody, wykonaj następujące czynności:
W witrynie Azure Portal przejdź do centrum IoT Hub.
Wybierz pozycję Aktualizacje , a następnie przejdź do karty Grupy i wdrożenia .
Wybierz nazwę grupy z aktywnym wdrożeniem, aby przejść do strony Szczegóły grupy .
Wybierz dowolną nazwę urządzenia na liście Urządzenia , aby otworzyć panel szczegółów urządzenia. W tym miejscu można zobaczyć kod wyniku zgłoszony przez urządzenie.
Agent referencyjny usługi Device Update jest zgodny ze standardową konwencją kodu stanu HTTP dla pola kodu wynikowego (na przykład "200" wskazuje powodzenie). Aby uzyskać więcej informacji na temat analizowania kodów wyników, zobacz Kody błędów klienta usługi Device Update.
Uwaga / Notatka
Jeśli agent usługi Device Update został zmodyfikowany w celu raportowania dostosowanych kodów wyników, kody liczbowe są nadal przekazywane do interfejsu użytkownika usługi Device Update. Następnie możesz zapoznać się z dowolną dokumentacją utworzoną w celu przeanalizowania tych kodów liczbowych.
Zdalne zbieranie dzienników
Jeśli do diagnozowania i rozwiązywania problemów z błędem konieczne jest więcej informacji z urządzenia, możesz użyć funkcji zbierania dzienników, aby poinstruować docelowe urządzenia do przekazania dzienników diagnostycznych na urządzeniu do połączonego konta usługi Azure Blob Storage. Możesz rozpocząć korzystanie z tej funkcji, postępując zgodnie z instrukcjami w temacie Zdalne zbieranie dzienników diagnostycznych z urządzeń.
Zdalne zbieranie dzienników przez usługę Device Update jest funkcją opartą na operacjach. Aby móc korzystać z zbierania dzienników, urządzenie musi mieć możliwość zaimplementowania interfejsu diagnostyki i pliku konfiguracji oraz przekazywania plików do usługi Azure Blob Storage za pośrednictwem zestawu SDK.
Na wysokim poziomie funkcja zbierania dzienników działa w następujący sposób:
Tworzysz nową operację logowania przy użyciu interfejsu użytkownika lub interfejsów API aktualizacji urządzenia, kierując ją do maksymalnie 100 urządzeń, które zaimplementowały interfejs diagnostyczny.
Usługa Device Update wysyła komunikat początkowy zbierania dzienników do urządzeń docelowych przy użyciu interfejsu diagnostyki. Ten komunikat początkowy zawiera identyfikator operacji dziennika i token SAS do przekazywania do skojarzonego konta usługi Azure Storage.
Po otrzymaniu komunikatu rozpoczęcia agent aktualizacji urządzenia docelowego próbuje zebrać i przekazać pliki znajdujące się w jednej lub więcej wstępnie zdefiniowanych ścieżkach plików określonych w pliku konfiguracji agenta urządzenia. Agent referencyjny aktualizacji urządzenia jest skonfigurowany do przekazywania dziennika diagnostycznego agenta aktualizacji urządzenia (
aduc.log) i dziennika diagnostycznego agenta DO ("do-agent.log").Agent usługi Device Update zgłasza następnie stan operacji ( powodzenie lub niepowodzenie) z powrotem do usługi, w tym identyfikator operacji dziennika, Kod wyniku i ExtendedResultCode. Jeśli agent aktualizacji urządzenia zakończy się niepowodzeniem operacji dziennika, automatycznie spróbuje ponowić próbę trzy razy, zgłaszając tylko stan końcowy z powrotem do usługi.
Gdy wszystkie docelowe urządzenia zgłosiły stan terminalu z powrotem do usługi Device Update, usługa Device Update oznacza operację dziennika jako Powodzenie lub Niepowodzenie. Pomyślne wykonanie operacji dziennika wskazuje, że wszystkie docelowe urządzenia zakończyły tę operację z sukcesem. Operacja dziennika, która zakończyła się niepowodzeniem, wskazuje, że co najmniej jedno z urządzeń docelowych nie zdołało jej przeprowadzić.
Uwaga / Notatka
Ponieważ operacja rejestrowania jest wykonywana równolegle przez urządzenia docelowe, możliwe jest, że niektóre z nich pomyślnie przesłały dzienniki, ale ogólna operacja rejestrowania zostaje uznana za nieudaną. Możesz zobaczyć, które urządzenia zakończyły operację pomyślnie, a które zakończyły operację niepowodzeniem, wyświetlając szczegóły operacji dziennika za pośrednictwem interfejsu użytkownika lub API.
Sprawdzanie agenta
Gdy urządzenie jest zarejestrowane w usłudze IoT Hub, ale nie jest wyświetlane w wystąpieniu usługi Device Update, możesz użyć funkcji Sprawdzania agenta, aby uruchomić wstępnie wykonane testy weryfikacyjne, aby ułatwić diagnozowanie podstawowego problemu. Aby rozpocząć korzystanie z tej funkcji, wykonaj następujące instrukcje dotyczące sprawdzania agenta.
Na wysokim poziomie funkcja sprawdzania agenta działa w następujący sposób:
- Rejestrujesz urządzenie w usłudze IoT Hub. Jeśli urządzenie zgłasza identyfikator modelu zgodny z usługą Device Update dla usługi IoT Hub, połączone wystąpienie usługi Device Update automatycznie rejestruje urządzenie w usłudze Device Update.
- Aby urządzenie było prawidłowo zarządzane przez usługę Device Update, musi spełniać określone kryteria, które można zweryfikować przy użyciu gotowych kontroli walidacyjnych Agent Check. Więcej informacji na temat tych kryteriów można znaleźć tutaj.
- Jeśli urządzenie nie spełnia wszystkich tych kryteriów, nie może być prawidłowo zarządzane przez usługę Device Update i nie jest wyświetlane w interfejsie usługi Device Update ani odpowiedziach interfejsu API. Możesz użyć funkcji Sprawdzania agenta, aby znaleźć to urządzenie i spróbować określić, które kryteria nie zostały spełnione przy użyciu sprawdzania agenta.
- Po zidentyfikowaniu, które kryteria nie są spełnione, możesz rozwiązać ten problem, a urządzenie powinno zostać prawidłowo wyświetlone w interfejsie usługi Device Update.
Dalsze kroki
Dowiedz się, jak używać funkcji „zdalne zbieranie dzienników” i funkcji „sprawdzanie agenta” usługi Device Update.