Udostępnij za pośrednictwem

Device Update for IoT Hub Troubleshooting Guide (Przewodnik rozwiązywania problemów z aktualizacją urządzenia na potrzeby IoT Hub)

  • Artykuł

W tym dokumencie wymieniono niektóre typowe pytania i problemy zgłaszane przez użytkowników usługi Device Update. W miarę postępu aktualizacji urządzenia w publicznej wersji zapoznawczej ten przewodnik rozwiązywania problemów będzie okresowo aktualizowany przy użyciu nowych pytań i rozwiązań. Jeśli napotkasz problem, który nie występuje w tym przewodniku rozwiązywania problemów, zapoznaj się z sekcją Kontaktowanie pomoc techniczna firmy Microsoft, aby udokumentować twoją sytuację.

Importowanie aktualizacji

Pyt.: Mam problemy z połączeniem wystąpienia usługi Device Update z moim wystąpieniem IoT Hub.

Upewnij się, że trasy komunikatów IoT Hub są poprawnie skonfigurowane zgodnie z dokumentacją zasobów usługi Device Update.

Być może nie masz poprawnie skonfigurowanych uprawnień dostępu. Upewnij się, że prawidłowo skonfigurowano uprawnienia dostępu zgodnie z dokumentacją kontroli dostępu usługi Device Update .

Pyt.: Podczas importowania zawartości do usługi Device Update występuje błąd 500-type.

Kod błędu w zakresie 500 może wskazywać na problem z usługą Device Update. Poczekaj 5 minut, a następnie spróbuj ponownie. Jeśli ten sam błąd będzie się powtarzać, postępuj zgodnie z instrukcjami w sekcji Kontaktowanie się z pomoc techniczna firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Pyt.: Chcę zachować te same właściwości zgodności (dotyczy mojej aktualizacji tego samego typu urządzenia), ale zmień dostawcę lub nazwę w manifeście importu. Ale otrzymuję komunikat o błędzie "Niepowodzenie: błąd podczas importowania aktualizacji z powodu przekroczenia limitu", gdy to zrobię.

Nie można używać tego samego dokładnie zestawu właściwości zgodności z więcej niż jedną kombinacją dostawcy aktualizacji i nazwy. Dzięki temu usługa Device Update pozwala określić z pewnością, które aktualizacje powinny być dostępne do wdrożenia na danym urządzeniu. Jeśli musisz zaktualizować wiele składników lub partycji na jednym urządzeniu, funkcja aktualizacji serwera proxy zapewnia tę możliwość.

Pyt.: Podczas importowania zawartości pojawia się komunikat o błędzie i chcę dowiedzieć się więcej na ten temat.

Aby uzyskać bardziej szczegółowe informacje na temat komunikatów o błędach związanych z importowaniem, zapoznaj się z dokumentacją kodów błędów aktualizacji urządzenia .

Błędy urządzeń

Pyt.: Jak mogę upewnić się, że urządzenie jest połączone z usługą Device Update dla IoT Hub?

Możesz sprawdzić, czy urządzenie jest połączone z usługą Device Update, sprawdzając, czy jest ono wyświetlane w sekcji "Urządzenia niezgrupowane" w widoku zgodności Azure Portal.

Pyt.: Nie można zaktualizować co najmniej jednego urządzenia.

Istnieje wiele możliwych głównych przyczyn niepowodzenia aktualizacji urządzenia. Sprawdź, czy urządzenie jest: 1) połączone z wystąpieniem IoT Hub, 2) połączone z wystąpieniem usługi Device Update i 3) uruchomioną usługą optymalizacji dostarczania (DO). Jeśli wszystkie trzy są prawdziwe dla twojego urządzenia, postępuj zgodnie z instrukcjami w sekcji Kontaktowanie się z pomoc techniczna firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Wdrażanie aktualizacji

Pyt.: Wdrożono aktualizację na urządzeniach, ale stan zgodności wskazuje, że nie dotyczy najnowszej aktualizacji. Co mam zrobić?

Odświeżenie stanu zgodności urządzenia może potrwać do 5 minut. Czekaj, a następnie sprawdź ponownie.

Pyt.: Stan wdrożenia mojego urządzenia pokazuje niezgodność, co należy zrobić?

Właściwości producenta i modelu urządzenia docelowego mogły zostać zmienione po połączeniu urządzenia z IoT Hub, co spowodowało, że urządzenie jest teraz uznawane za niezgodne z zawartością aktualizacji bieżącego wdrożenia.

Sprawdź interfejs ADU Core Interface , aby zobaczyć, jaki producent i model urządzenia raportuje do usługi Device Update Service, i upewnij się, że jest on zgodny z producentem i modelem określonym w manifeście importu wdrażanej zawartości aktualizacji. Te właściwości dla danego urządzenia można zmienić przy użyciu pliku konfiguracji usługi Device Update.

Pyt.: Widzę, że wdrożenie znajduje się na etapie "Aktywne", ale żadne z moich urządzeń nie jest w toku wraz z aktualizacją. Co mam zrobić?

Upewnij się, że data rozpoczęcia wdrożenia nie jest ustawiona w przyszłości. Podczas tworzenia nowego wdrożenia data rozpoczęcia wdrożenia jest domyślnie ustawiona na następny dzień jako zabezpieczenie, chyba że jawnie zmienisz je. Możesz poczekać na nadejście daty rozpoczęcia wdrożenia lub anulować bieżące wdrożenie i utworzyć nowe z wymaganą datą rozpoczęcia.

Pyt.: Próbuję zgrupować moje urządzenia, ale nie widzę tagu na liście rozwijanej podczas tworzenia grupy.

Upewnij się, że trasy komunikatów w IoT Hub zostały prawidłowo skonfigurowane zgodnie z dokumentacją zasobów usługi Device Update. Po skonfigurowaniu trasy trzeba będzie ponownie oznaczyć urządzenie.

Inną główną przyczyną może być zastosowanie tagu przed połączeniem urządzenia z usługą Device Update dla IoT Hub. Upewnij się, że urządzenie jest już połączone z usługą Device Update. Możesz sprawdzić, czy urządzenie jest połączone z usługą Device Update dla IoT Hub, sprawdzając, czy jest ono wyświetlane w obszarze "Niezgrupowane" urządzenia w widoku zgodności. Tymczasowo dodaj tag innej wartości, a następnie ponownie dodaj zamierzony tag po nawiązaniu połączenia z urządzeniem.

Jeśli używasz usługi Device Provisioning Service (DPS), upewnij się, że urządzenia są tagowane po ich aprowizacji, a nie podczas procesu tworzenia urządzenia. Jeśli urządzenie zostało już otagowane podczas kroku tworzenia urządzenia, konieczne będzie tymczasowe oznaczanie urządzenia inną wartością po jego aprowizacji, a następnie ponowne dodanie zamierzonego tagu.

Pyt.: Moje wdrożenie zakończyło się pomyślnie, ale nie można zaktualizować niektórych urządzeń.

Może to być spowodowane przez błąd po stronie klienta na urządzeniach, które zakończyły się niepowodzeniem. Zapoznaj się z sekcją Device Failures (Błędy urządzeń) tego przewodnika rozwiązywania problemów.

Pyt.: Wystąpił błąd w środowisku użytkownika podczas próby zainicjowania wdrożenia.

Przyczyną może być usterka usługi/środowiska użytkownika lub problem z uprawnieniami interfejsu API. Postępuj zgodnie z instrukcjami w sekcji Kontaktowanie się z pomoc techniczna firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Pyt.: Rozpoczęto wdrożenie, ale nie osiąga ono stanu końcowego.

Może to być spowodowane problemem z wydajnością usługi, usterką usługi lub usterką klienta. Ponów próbę wdrożenia po 10 minutach. Jeśli wystąpi ten sam problem, pobierz dzienniki urządzenia i zapoznaj się z sekcją Błędy urządzeń w tym przewodniku rozwiązywania problemów. Jeśli ten sam problem będzie się powtarzać, postępuj zgodnie z instrukcjami w sekcji Kontaktowanie się z pomoc techniczna firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Pyt.: Przeprowadzono migrację z agenta na poziomie urządzenia w celu dodania agenta jako tożsamości modułu na urządzeniu, a moja aktualizacja jest wyświetlana jako "w toku", mimo że została zastosowana do urządzenia.

_This mogły być spowodowane tym, że nie usunięto starszego agenta komunikującego się za pośrednictwem bliźniaczej reprezentacji urządzenia. Jeśli aprowizujesz agenta usługi Device Update jako moduł (zobacz , jak to zrobić) cała komunikacja między urządzeniem a usługą Device Update odbywa się za pośrednictwem bliźniaczej reprezentacji modułu, dlatego pamiętaj o tagowaniu bliźniaczej reprezentacji modułu urządzenia podczas tworzenia grup i całej komunikacji za pośrednictwem bliźniaczej reprezentacji modułu.

Pobieranie aktualizacji na urządzenia

Pyt.: Jak mogę wznowić pobieranie po ponownym połączeniu urządzenia po upływie okresu rozłączenia?

Pobieranie zostanie wznowione po przywróceniu łączności w ciągu 24 godzin. Po 24 godzinach pobieranie musi zostać ponownie zainicjowane przez użytkownika.

Korzystanie z usługi Microsoft Connected Cache (MCC)

Pyt.: Występuje problem podczas próby wdrożenia modułu MCC na moim urządzeniu IoT Edge.

Zapoznaj się z dokumentacją IoT Edge dotyczącą wdrażania modułów usługi Edge na urządzeniach IoT Edge. Możesz sprawdzić, czy moduł MCC działa pomyślnie na urządzeniu IoT Edge, przechodząc dohttp://localhost:5100/Summary.

Pyt.: Jedno z moich urządzeń IoT próbuje pobrać aktualizację za pośrednictwem mcc, ale kończy się niepowodzeniem.

Istnieje kilka problemów, które mogą powodować niepowodzenie połączenia urządzenia IoT z usługą MCC. Aby zdiagnozować problem, zbierz dzienniki klienta DO i serwera Nginx z urządzenia, które się nie powiodły (zobacz sekcję Kontaktowanie się z pomoc techniczna firmy Microsoft, aby uzyskać instrukcje dotyczące zbierania dzienników klientów).

Urządzenie może nie ściągnąć zawartości z Internetu, aby przekazać ją do modułu MCC, ponieważ adres URL, z którym korzysta, nie jest dozwolony. Aby określić, czy tak, należy sprawdzić IoT Edge zmiennych środowiskowych w Azure Portal.

Kontaktowanie się z pomocą techniczną firmy Microsoft

Jeśli napotkasz problemy, których nie można rozwiązać przy użyciu powyższych często zadawanych pytań, możesz zgłosić wniosek o pomoc techniczną z pomoc techniczna firmy Microsoft za pośrednictwem interfejsu Azure Portal. W zależności od kategorii, do której należy twój problem, może zostać wyświetlony monit o zebranie i udostępnienie dodatkowych danych w celu ułatwienia pomoc techniczna firmy Microsoft zbadania problemu.

Zapoznaj się z poniższymi instrukcjami dotyczącymi zbierania poszczególnych typów danych. Możesz użyć polecenia getDevices , aby sprawdzić dodatkowe informacje w odpowiedzi ładunku interfejsu API.

Ponadto następujące informacje mogą być przydatne do zawężania głównej przyczyny problemu:

  • Jakiego typu urządzenie próbujesz zaktualizować (Azure Percept, IoT Edge Gateway, inne)
  • Jakiego typu klienta usługi Device Update używasz (oparty na obrazach, opartych na pakietach, symulatorze)
  • Jaki system operacyjny jest uruchomiony na urządzeniu
  • Szczegóły dotyczące architektury urządzenia
  • Czy aktualizacja urządzenia została pomyślnie użyta do zaktualizowania urządzenia przed

Jeśli masz jakiekolwiek z powyższych informacji, dołącz je do opisu problemu.

Zbieranie dzienników klienta

  • Na urządzeniu Raspberry Pi znajdują się dwa zestawy dzienników:

    /adu/logs

    /var/cache/do-client-lite/log

  • W przypadku spakowanego klienta dzienniki znajdują się tutaj:

    /var/log/adu

    /var/cache/do-client-lite/log

  • W przypadku symulatora dzienniki znajdują się tutaj:

    /tmp/aduc-logs

Kody błędów

Może zostać wyświetlony monit o podanie kodów błędów podczas zgłaszania problemu związanego z importowaniem aktualizacji, awarią urządzenia lub wdrażaniem aktualizacji.

Kody błędów można uzyskać, patrząc na interfejs ADUCoreInterface . Zapoznaj się z dokumentacją kodów błędów usługi Device Update , aby uzyskać informacje na temat analizowania kodów błędów na potrzeby samodzielnej diagnostyki i rozwiązywania problemów.

Identyfikator śledzenia

Podczas raportowania problemu związanego z importowaniem lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie identyfikatora śledzenia.

Identyfikator śledzenia dla danej akcji użytkownika można znaleźć w odpowiedzi interfejsu API lub w sekcji Historia importu interfejsu użytkownika Azure Portal.

Obecnie identyfikatory śledzenia dla akcji wdrażania są dostępne tylko za pośrednictwem odpowiedzi interfejsu API.

Identyfikator wdrożenia

Podczas raportowania problemu związanego z wdrażaniem aktualizacji może zostać wyświetlony monit o podanie identyfikatora wdrożenia.

Identyfikator wdrożenia jest tworzony przez użytkownika podczas wywoływania interfejsu API w celu zainicjowania wdrożenia.

Obecnie identyfikatory wdrożeń inicjowane z interfejsu użytkownika Azure Portal są generowane automatycznie i nie są wyświetlane użytkownikowi.

nazwa wystąpienia IoT Hub

Podczas raportowania problemu związanego z awariami urządzeń lub wdrażania aktualizacji może zostać wyświetlony monit o podanie nazwy wystąpienia IoT Hub.

Nazwa IoT Hub jest wybierana przez użytkownika podczas pierwszej aprowizacji.

Nazwa konta usługi Device Update

Podczas raportowania problemu związanego z importowaniem aktualizacji lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie nazwy konta usługi Device Update.

Nazwa konta usługi Device Update jest wybierana przez użytkownika podczas pierwszego rejestrowania się w usłudze. Więcej informacji można znaleźć w dokumentacji zasobów usługi Device Update .

Nazwa wystąpienia usługi Device Update

Podczas raportowania problemu związanego z importowaniem aktualizacji aktualizacji lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie nazwy wystąpienia aktualizacji.

Nazwa wystąpienia usługi Device Update jest wybierana przez użytkownika podczas pierwszej aprowizacji. Więcej informacji można znaleźć w dokumentacji zasobów usługi Device Update .

Identyfikator urządzenia

Podczas zgłaszania problemu związanego z awariami urządzeń lub wdrażania aktualizacji może zostać wyświetlony monit o podanie identyfikatora urządzenia.

Identyfikator urządzenia jest definiowany przez klienta podczas pierwszej aprowizacji urządzenia. Można go również pobrać z bliźniaczej reprezentacji urządzenia.

Identyfikator aktualizacji

Podczas raportowania problemu związanego z wdrażaniem aktualizacji może zostać wyświetlony monit o podanie identyfikatora aktualizacji.

Identyfikator aktualizacji jest definiowany przez klienta podczas inicjowania wdrożenia.

Dzienniki serwera Nginx

Podczas raportowania problemu związanego z usługą Microsoft Connected Cache może zostać wyświetlony monit o podanie dzienników serwera Nginx.

ADU-conf.txt

Podczas raportowania problemu związanego z wdrażaniem aktualizacji aktualizacji może zostać wyświetlony monit o podanie pliku konfiguracji usługi Device Update ("adu-conf.txt").

Plik konfiguracji jest opcjonalny i tworzony przez użytkownika zgodnie z instrukcjami w dokumentacji konfiguracji usługi Device Update .

Importowanie manifestu

Podczas raportowania problemu związanego z importowaniem lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie pliku manifestu importu.

Manifest importu to plik utworzony przez klienta podczas importowania zawartości aktualizacji do usługi Device Update.

Następny krok: Dowiedz się więcej o kodach błędów aktualizacji urządzenia