Znajdowanie i naprawianie brakujących urządzeń w usłudze Device Update dla usługi IoT Hub przy użyciu sprawdzania agenta

Dowiedz się, jak używać funkcji sprawdzania agenta do znajdowania, diagnozowania i naprawiania brakujących urządzeń w wystąpieniu usługi IoT Hub w usłudze Device Update.

Wymagania wstępne

• Dostęp do usługi IoT Hub z włączoną aktualizacją urządzenia dla usługi IoT Hub.
• Urządzenie IoT (lub symulator) aprowidowane na potrzeby aktualizacji urządzeń i raportowanie zgodnego identyfikatora modelu Plug and Play (PnP).

Uwaga

Funkcja sprawdzania agenta może przeprowadzać kontrole poprawności tylko na urządzeniach z zainstalowanym agentem usługi Device Update i zgłasza identyfikator modelu PnP zgodny z usługą Device Update dla usługi IoT Hub.

Witryna Azure Portal

Obsługiwane przeglądarki:

• Microsoft Edge
• Google Chrome

Interfejs wiersza polecenia platformy Azure

Środowisko interfejsu wiersza polecenia platformy Azure:

• Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure

  1. Zaloguj się do interfejsu wiersza polecenia platformy Azure przy użyciu polecenia az login .
  2. Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
  3. Po wyświetleniu monitu zainstaluj rozszerzenia interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Polecenia w tym artykule używają rozszerzenia azure-iot . Uruchom polecenie az extension update --name azure-iot , aby upewnić się, że używasz najnowszej wersji rozszerzenia.

Sprawdzanie poprawności obsługiwane przez sprawdzanie agenta

Funkcja sprawdzania agenta wykonuje obecnie następujące kontrole poprawności na wszystkich urządzeniach spełniających powyższe wymagania wstępne.

Walidacja	Kryterium
Identyfikator modelu PnP	Identyfikator modelu PnP to ciąg zgłaszany przez agenta usługi Device Update do bliźniaczej reprezentacji urządzenia, który opisuje, który model PnP powinien być używany do komunikacji urządzenia/chmury. Ten ciąg musi być prawidłowym identyfikatorem modelu cyfrowej reprezentacji bliźniaczej (DTMI), który obsługuje interfejs usługi Device Update.
Identyfikator interfejsu	Identyfikator interfejsu to ciąg zgłaszany przez agenta usługi Device Update do bliźniaczej reprezentacji urządzenia, który opisuje wersję interfejsu usługi Device Update, która powinna być używana na potrzeby komunikacji urządzenia/chmury. Ten ciąg musi być prawidłowym dtMI obsługującym interfejs Device Update.
Nazwy właściwości zgodności	CompatPropertyNames to pole zgłaszane przez agenta usługi Device Update do bliźniaczej reprezentacji urządzenia, które opisuje pola, które deviceProperties powinny być używane do określenia zgodności urządzenia z danym wdrożeniem. Wartość tego pola musi być ciągiem nazw rozdzielanych przecinkami. Ciąg musi zawierać co najmniej jedną i nie więcej niż pięć nazw. Każda nazwa musi zawierać <32 znaki.
Wartości właściwości zgodności	Wartości właściwości zgodności to pary field:value określone przez compatPropertyNames pole i zgłaszane przez agenta usługi Device Update do bliźniaczej reprezentacji urządzenia jako deviceProperties. Każda nazwa zdefiniowana w nazwach właściwości zgodności musi mieć zgłoszoną odpowiednią parę field:value. Wartość każdej pary jest ograniczona do 64 znaków.
Grupa ADU	Tag grupy usługi ADU jest opcjonalnym tagiem zdefiniowanym w bliźniaczej reprezentacji urządzenia i określa grupę urządzeń, do której należy urządzenie. Jeśli zostanie określony, ciąg tagu jest ograniczony do 255 znaków i może zawierać tylko znaki alfanumeryczne i następujące znaki specjalne: "." "-" "_" "~"

Jeśli urządzenie ulegnie awarii dowolnego z tych kryteriów, może nie być poprawnie wyświetlane w usłudze Device Update. Poprawienie nieprawidłowej wartości spełniającej określone kryteria powinno spowodować prawidłowe wyświetlenie urządzenia w usłudze Device Update. Jeśli urządzenie nie jest wyświetlane w aktualizacji urządzenia ani w czeku agenta, może być konieczne uruchomienie synchronizacji urządzenia w celu rozwiązania problemu.

Wyświetlanie wyników sprawdzania agenta

Witryna Azure Portal

Wyniki sprawdzania agenta można znaleźć na karcie diagnostyki usługi Device Update.

1. W witrynie Azure Portal przejdź do centrum IoT Hub.
2. Wybierz Aktualizacje z menu nawigacji, a następnie wybierz kartę Diagnostyka.
3. Rozwiń sekcję Znajdowanie brakujących urządzeń .

Interfejs wiersza polecenia platformy Azure

Użyj polecenia az iot du device health list , aby wyświetlić kondycję urządzeń.

Polecenie device health list przyjmuje następujące argumenty:

• --account: nazwa konta usługi Device Update.
• --instance: nazwa wystąpienia usługi Device Update.
• --filter: filtr kondycji urządzenia, filtrujący stan urządzenia lub identyfikator urządzenia. Na przykład: .
  • Aby wyświetlić listę wszystkich urządzeń w dobrej kondycji, przefiltruj według state eq 'Healthy'
  • Aby wyświetlić listę wszystkich urządzeń w złej kondycji, przefiltruj według state eq 'Unhealthy'
  • Aby wyświetlić stan kondycji urządzenia docelowego, przefiltruj według deviceId eq '<device_name>' lub deviceId eq '<device_name>' and moduleId eq '<module_name>'

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

Inicjowanie operacji synchronizacji urządzenia

Synchronizacja urządzenia powinna być wyzwalana, jeśli urządzenie zostało zarejestrowane w centrum IoT Hub, ale nie jest wyświetlane w usłudze Device Update ani w wynikach sprawdzania agenta.

Tylko jedna operacja synchronizacji urządzenia może być aktywna jednocześnie dla każdego wystąpienia usługi Device Update.

Witryna Azure Portal

1. W witrynie Azure Portal przejdź do centrum IoT Hub.
2. Wybierz Aktualizacje z menu nawigacji, a następnie wybierz kartę Diagnostyka.
3. Rozwiń sekcję Wyświetlanie kondycji urządzenia.
4. Wybierz pozycję Rozpocznij synchronizację urządzenia.

Interfejs wiersza polecenia platformy Azure

Użyj polecenia az iot du device import , aby zaimportować urządzenia i moduły do wystąpienia usługi Device Update z połączonego centrum IoT.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

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ń