Monitorowanie wdrożeń IoT Edge

Dotyczy: IoT Edge 1.5 IoT Edge 1.4

Ważne

Obsługiwane są wersje usługi IoT Edge 1.5 LTS i IoT Edge 1.4 LTS. Usługa IoT Edge 1.4 LTS kończy się 12 listopada 2024 r. Jeśli korzystasz z wcześniejszej wersji, zobacz aktualizację Azure IoT Edge.

Usługa Azure IoT Edge udostępnia raportowanie, które umożliwia monitorowanie informacji w czasie rzeczywistym na modułach wdrożonych na urządzeniach usługi IoT Edge. Usługa IoT Hub pobiera stan z urządzeń i udostępnia je operatorowi. Monitorowanie jest również ważne w przypadku wdrożeń na dużą skalę , które obejmują wdrożenia automatyczne i wdrożenia warstwowe.

Oba urządzenia i moduły mają podobne dane, takie jak łączność, więc wartości są uzyskiwane zgodnie z identyfikatorem urządzenia lub identyfikatorem modułu.

Usługa IoT Hub zbiera dane zgłaszane przez bliźniacze reprezentacje urządzeń i modułów oraz udostępnia liczbę różnych stanów, które mogą mieć urządzenia. Usługa IoT Hub organizuje te dane w cztery grupy metryk:

Type	Opis
Wartość docelowa	Przedstawia urządzenia usługi IoT Edge zgodne z warunkiem określania wartości docelowej wdrożenia.
Applied	Przedstawia docelowe urządzenia usługi IoT Edge, które nie są objęte innym wdrożeniem o wyższym priorytcie.
Powodzenie raportowania	Przedstawia urządzenia usługi IoT Edge, które zgłosiły, że moduły zostały pomyślnie wdrożone.
Raportowanie błędu	Przedstawia urządzenia usługi IoT Edge, które zgłosiły, że co najmniej jeden moduł nie został pomyślnie wdrożony. Aby dokładniej zbadać błąd, połącz się zdalnie z tymi urządzeniami i wyświetl pliki dziennika.

Usługa IoT Hub udostępnia te dane do monitorowania w witrynie Azure Portal i w interfejsie wiersza polecenia platformy Azure.

Monitorowanie wdrożenia w witrynie Azure Portal

Aby wyświetlić szczegóły wdrożenia i monitorować uruchomione urządzenia, wykonaj następujące kroki:

1. Zaloguj się do witryny Azure Portal i przejdź do usługi IoT Hub.

2. Wybierz pozycję Konfiguracje i wdrożenia w menu Zarządzanie urządzeniami .

3. Sprawdź listę wdrożeń. Dla każdego wdrożenia można wyświetlić następujące szczegóły:

   Kolumna	opis
   ID	Nazwa wdrożenia.
   Typ	Typ wdrożenia, wdrożenie lub wdrożenie warstwowe.
   Warunek docelowy	Tag używany do definiowania urządzeń docelowych.
   Priorytet	Numer priorytetu przypisany do wdrożenia.
   Metryki systemowe	Liczba bliźniaczych reprezentacji urządzeń w usłudze IoT Hub, które są zgodne z warunkiem określania wartości docelowej. Zastosowano określa liczbę urządzeń, na których zastosowano zawartość wdrożenia do bliźniaczych reprezentacji modułów w usłudze IoT Hub.
   Metryki urządzeń	Liczba urządzeń usługi IoT Edge raportujących powodzenie lub błędy ze środowiska uruchomieniowego klienta usługi IoT Edge.
   Metryki niestandardowe	Liczba urządzeń usługi IoT Edge raportujących dane dotyczące wszystkich metryk zdefiniowanych dla wdrożenia.
   Utworzone	Sygnatura czasowa od momentu utworzenia wdrożenia. Ten znacznik czasu służy do przerywania więzi, gdy dwa wdrożenia mają ten sam priorytet.

4. Wybierz wdrożenie, które chcesz monitorować.

5. Na stronie Szczegóły wdrożenia przewiń w dół do dolnej sekcji i wybierz kartę Warunek docelowy. Wybierz pozycję Widok, aby wyświetlić listę urządzeń pasujących do warunku docelowego. Można zmienić warunek, a także priorytet. Wybierz pozycję Zapisz , jeśli wprowadzono zmiany.

   

6. Wybierz kartę Metryki . Jeśli wybierzesz metrykę z listy rozwijanej Wybierz metrykę , zostanie wyświetlony przycisk Wyświetl , aby wyświetlić wyniki. Możesz również wybrać pozycję Edytuj metryki , aby dostosować kryteria dla dowolnych zdefiniowanych metryk niestandardowych. Wybierz pozycję Zapisz , jeśli wprowadzono zmiany.

   

Aby wprowadzić zmiany we wdrożeniu, zobacz Modyfikowanie wdrożenia.

Monitorowanie wdrożenia przy użyciu interfejsu wiersza polecenia platformy Azure

Użyj polecenia az iot edge deployment show, aby wyświetlić szczegóły pojedynczego wdrożenia:

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

Polecenie deployment show przyjmuje następujące parametry:

• --deployment-id — nazwa wdrożenia, które istnieje w centrum IoT Hub. Wymagany parametr interfejsu .
• --hub-name — nazwa centrum IoT, w którym istnieje wdrożenie. Centrum musi znajdować się w bieżącej subskrypcji. Przełącz się do żądanej subskrypcji za pomocą polecenia az account set -s [subscription name]

Sprawdź wdrożenie w oknie polecenia. Właściwość metrics wyświetla liczbę dla każdej metryki , która jest oceniana przez każde centrum:

• targetedCount — metryka systemu określająca liczbę bliźniaczych reprezentacji urządzeń w usłudze IoT Hub, która jest zgodna z warunkiem określania wartości docelowej.
• appliedCount — metryka systemowa określa liczbę urządzeń, na których zastosowano zawartość wdrożenia do bliźniaczych reprezentacji modułów w usłudze IoT Hub.
• reportedSuccessfulCount — metryka urządzenia określająca liczbę urządzeń usługi IoT Edge w pomyślnym raportowaniu wdrożenia ze środowiska uruchomieniowego klienta usługi IoT Edge.
• reportedFailedCount — metryka urządzenia określająca liczbę urządzeń usługi IoT Edge w błędzie raportowania wdrożenia ze środowiska uruchomieniowego klienta usługi IoT Edge.

Możesz wyświetlić listę identyfikatorów urządzeń lub obiektów dla każdej z metryk za pomocą polecenia az iot edge deployment show-metric :

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

Polecenie show-metric wdrożenia przyjmuje następujące parametry:

• --deployment-id — nazwa wdrożenia, które istnieje w centrum IoT Hub.
• --metric-id — nazwa metryki, dla której chcesz wyświetlić listę identyfikatorów urządzeń, na przykład reportedFailedCount.
• --hub-name — nazwa centrum IoT, w którym istnieje wdrożenie. Centrum musi znajdować się w bieżącej subskrypcji. Przejdź do żądanej subskrypcji za pomocą polecenia az account set -s [subscription name].

Aby wprowadzić zmiany we wdrożeniu, zobacz Modyfikowanie wdrożenia.

Następne kroki

Dowiedz się, jak monitorować bliźniacze reprezentacje modułów, głównie agenta usługi IoT Edge i modułów środowiska uruchomieniowego usługi IoT Edge na potrzeby łączności i kondycji wdrożeń usługi IoT Edge.