Samouczek: monitorowanie urządzeń IoT Edge

Applies to: IoT Edge 1.5

Użyj Azure Monitor skoroszytów, aby monitorować kondycję i wydajność wdrożeń Azure IoT Edge.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

Wymagania wstępne

Potrzebujesz urządzenia IoT Edge z wdrożonym modułem symulowanego czujnika temperatury. Jeśli nie masz gotowego urządzenia, wykonaj kroki opisane w artykule Deployj swój pierwszy moduł IoT Edge na wirtualnym urządzeniu z systemem Linux aby utworzyć go przy użyciu maszyny wirtualnej.

Omówienie metryk IoT Edge

Każde urządzenie IoT Edge korzysta z dwóch modułów nazywanych modułami runtime, które zarządzają cyklem życia i komunikacją wszystkich innych modułów na urządzeniu. Te moduły to agent IoT Edge oraz hub IoT Edge. Aby dowiedzieć się więcej na temat tych modułów, zobacz Understand the Azure IoT Edge runtime and its architecture (Omówienie środowiska uruchomieniowego Azure IoT Edge i jego architektury.

Oba moduły środowiska uruchomieniowego tworzą metryki, które umożliwiają zdalne monitorowanie sposobu działania urządzenia IoT Edge lub poszczególnych modułów. Agent IoT Edge raportuje stan poszczególnych modułów i urządzenia hosta, dzięki czemu tworzy metryki, takie jak czas działania modułu, lub ilość pamięci RAM i procent użycia procesora CPU na urządzeniu. Centrum IoT Edge raportuje komunikację na urządzeniu, więc tworzy metryki takie jak łączna liczba wysłanych i odebranych komunikatów lub czas potrzebny na rozwiązanie metody bezpośredniej. Aby uzyskać pełną listę dostępnych metryk, zobacz Access built-in metrics (Uzyskiwanie dostępu do wbudowanych metryk).

Oba moduły automatycznie uwidaczniają te metryki, dzięki czemu możesz tworzyć własne rozwiązania umożliwiające dostęp do nich i raportowanie. Aby ułatwić ten proces, firma Microsoft udostępnia moduł azureiotedge-metrics-collector, który obsługuje ten proces, jeśli nie masz rozwiązania niestandardowego. Moduł modułu zbierającego metryki zbiera metryki z dwóch modułów środowiska uruchomieniowego i innych modułów, które chcesz monitorować, i wysyła je z urządzenia.

Moduł zbierający metryki wysyła metryki do chmury na jeden z dwóch sposobów. Pierwsza opcja, wykorzystana w tym samouczku, przesyła metryki bezpośrednio do Log Analytics. Druga opcja jest zalecana tylko wtedy, gdy zasady sieci wymagają tej opcji. Wysyła ona metryki za pośrednictwem IoT Hub, a następnie konfiguruje trasę, aby przekazać komunikaty metryk do Log Analytics. W każdym razie, gdy metryki znajdują się w obszarze roboczym Log Analytics, możesz je wyświetlić za pomocą skoroszytów Azure Monitor.

Tworzenie obszaru roboczego Log Analytics

Obszar roboczy Log Analytics jest niezbędny do zbierania danych metryk, używania języka zapytań i integracji z Azure Monitor, aby można było monitorować urządzenia.

1. Zaloguj się do portalu Azure.

2. Wyszukaj obszary robocze Log Analytics, a następnie wybierz je.

3. Wybierz pozycję Utwórz, a następnie postępuj zgodnie z monitami, aby utworzyć nowy obszar roboczy.

4. Gdy środowisko pracy będzie gotowe, wybierz Przejdź do zasobu.

5. W menu głównym w obszarze Ustawienia wybierz pozycję Agenci.

6. Skopiuj wartości Workspace ID i Primary key w sekcji instrukcje agenta Log Analytics. Te wartości są używane w dalszej części samouczka, aby skonfigurować moduł modułu zbierającego metryki w celu wysyłania metryk do tego obszaru roboczego.

Pobierz identyfikator zasobu centrum IoT

Podczas konfigurowania modułu zbierającego metryki należy wprowadzić identyfikator zasobu Azure Resource Manager dla centrum IoT. Pobierz ten identyfikator teraz.

1. W portalu Azure przejdź do centrum IoT Hub.

2. W obszarze Ustawienia wybierz pozycję Właściwości.

3. Skopiuj wartość identyfikatora zasobu. Format to jest /subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IoTHubs/<iot_hub_name>.

Wdrażanie modułu zbierającego metryki

Wdróż moduł zbierający metryki do każdego urządzenia, które chcesz monitorować. Działa on na urządzeniu, podobnie jak w przypadku każdego innego modułu i obserwuje przypisane punkty końcowe dla metryk w celu zbierania i wysyłania ich do chmury.

Wykonaj następujące kroki, aby wdrożyć i skonfigurować moduł zbierający:

1. Zaloguj się do portalu Azure, a następnie przejdź do centrum IoT.

2. W obszarze Zarządzanie urządzeniami wybierz pozycję Urządzenia.

3. Wybierz identyfikator urządzenia docelowego na liście urządzeń IoT Edge, aby otworzyć stronę szczegółów urządzenia.

4. Na pasku menu wybierz pozycję Ustaw moduły.

5. Pierwszym krokiem wdrażania modułów z portalu jest zadeklarowanie, które moduły znajdują się na urządzeniu. Jeśli używasz tego samego urządzenia, które utworzyłeś w przewodniku szybkiego startu, na liście jest już SimulatedTemperatureSensor. Jeśli nie, dodaj go teraz:

   1. W sekcji IoT Edge modules wybierz Add a następnie wybierz pozycję IoT Edge Module.

   2. Zaktualizuj następujące ustawienia modułu:

      Ustawienie	Wartość
      Nazwa modułu IoT	SimulatedTemperatureSensor
      Identyfikator URI obrazu	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
      Zasady ponownego uruchamiania	zawsze
      Żądany stan	działa

   3. Wybierz pozycję Dalej: trasy , aby kontynuować konfigurowanie tras.

   4. Dodaj trasę, która wysyła wszystkie komunikaty z modułu symulowanej temperatury do IoT Hub.

      Ustawienie	Wartość
      Nazwa/nazwisko	SimulatedTemperatureSensorToIoTHub
      Wartość	FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

6. Dodaj i skonfiguruj moduł zbierający metryki.

   1. Wybierz Dodaj a następnie wybierz pozycję IoT Edge Module.

   2. Wyszukaj i wybierz pozycję IoT Edge Moduł zbierający metryki.

   3. Zaktualizuj następujące ustawienia modułu:

      Ustawienie	Wartość
      Nazwa modułu IoT	IoTEdgeMetricsCollector
      Identyfikator URI obrazu	mcr.microsoft.com/azureiotedge-metrics-collector:latest
      Zasady ponownego uruchamiania	zawsze
      Żądany stan	działa

   Aby użyć innej wersji lub architektury modułu zbierającego metryki, znajdź dostępne obrazy w Microsoft Artifact Registry.

   1. Przejdź do karty Zmienne środowiskowe .

   2. Dodaj następujące zmienne środowiskowe typu tekstowego:

      Nazwa/nazwisko	Wartość
      Identyfikator zasobu	Identyfikator zasobu Twojego IoT hub, który pobrałeś w poprzedniej sekcji.
      UploadTarget	AzureMonitor
      LogAnalyticsWorkspaceId	Identyfikator obszaru roboczego Log Analytics pobrany w poprzedniej sekcji.
      LogAnalyticsSharedKey	Klucz Log Analytics pobrany w poprzedniej sekcji.

      Aby uzyskać więcej informacji na temat ustawień zmiennych środowiskowych, zobacz Konfiguracja modułu zbierającego metryki.

   3. Wybierz pozycję Zastosuj, aby zapisać zmiany.

   Uwaga

   Aby wysyłać metryki za pośrednictwem IoT Hub, dodaj trasę do przesyłu w górę podobną do FROM /messages/modules/< FROM_MODULE_NAME >/* INTO $upstream. W tym samouczku metryki są wysyłane bezpośrednio do Log Analytics, więc ta ścieżka nie jest potrzebna.

7. Wybierz pozycję Przejrzyj i utwórz , aby przejść do ostatniego kroku wdrażania modułów.

8. Wybierz pozycję Utwórz , aby zakończyć wdrażanie.

Po zakończeniu wdrażania modułów wróć do strony szczegółów urządzenia, na której zostaną wyświetlone cztery moduły wymienione jako Określone we wdrożeniu. Może upłynąć kilka minut, aby wszystkie cztery moduły były wyświetlane jako Raportowane przez urządzenie co oznacza, że zostały uruchomione i zgłosiły swój stan do IoT Hub. Odśwież stronę, aby wyświetlić najnowszy stan.

Monitorowanie kondycji urządzenia

Przygotowanie skoroszytów monitorowania Twojego urządzenia do wyświetlenia może potrwać do 15 minut. Po wdrożeniu modułu zbierającego metryki, rozpoczyna on wysyłanie komunikatów z metrykami do usługi Log Analytics, gdzie są one zorganizowane w tabeli. Identyfikator zasobu IoT Hub, który dostarczasz, łączy pozyskane metryki z właściwym koncentratorem. W rezultacie opracowane skoroszyty IoT Edge pobierają metryki, wykonując zapytanie do tabeli metryk za pomocą identyfikatora zasobu.

Azure Monitor udostępnia trzy domyślne szablony skoroszytów dla IoT:

• Skoroszyt Widok floty przedstawia kondycję urządzeń w wielu zasobach IoT. Widok umożliwia ustawienie progów kondycji urządzenia i wyświetlanie agregacji podstawowych metryk na urządzenie.
• W skoroszycie Szczegóły urządzenia przedstawiono wizualizacje komunikatów, modułów i hosta. Widok obsługi komunikatów wizualizuje trasy komunikatów dla urządzenia i raportuje ogólną kondycję systemu obsługi komunikatów. Widok modułów pokazuje, jak działają poszczególne moduły na urządzeniu. Widok urządzenia hostującego pokazuje informacje o urządzeniu hostującym, w tym informacje o wersji komponentów urządzenia hostującego i użyciu zasobów.
• Widok arkusza Alerty pokazuje alerty dotyczące urządzeń w wielu zasobach IoT.

Przeglądaj widok floty i migawkę kondycji w skoroszytach

Skoroszyt widoku floty pokazuje wszystkie urządzenia i umożliwia wybranie określonych urządzeń w celu wyświetlenia ich stanu zdrowia. Wykonaj następujące kroki, aby zapoznać się z wizualizacjami skoroszytu:

1. Przejdź do strony centrum IoT w portalu Azure.

2. W menu głównym przewiń w dół do kategorii Monitorowanie i wybierz pozycję Skoroszyty.

   

3. Wybierz skoroszyt Przegląd floty.

4. Zobaczysz urządzenie, na którym działa moduł zbierania metryk. Urządzenie jest wyświetlane jako w dobrej kondycji lub w złej kondycji.

5. Wybierz nazwę urządzenia, aby wyświetlić szczegółowe metryki.

6. Na dowolnym wykresie czasu użyj ikon strzałek pod osią X lub wybierz wykres i przeciągnij kursor, aby zmienić zakres czasu.

   

7. Zamknij skoroszyt migawki kondycji. W skoroszycie widoku floty wybierz pozycję Skoroszyty , aby powrócić do galerii skoroszytów.

Eksplorowanie skoroszytu szczegółów urządzenia

W skoroszycie szczegółów urządzenia są wyświetlane szczegóły wydajności poszczególnych urządzeń. Wykonaj następujące kroki, aby zapoznać się z wizualizacjami skoroszytu:

1. W galerii skoroszytów wybierz skoroszyt szczegóły urządzenia IoT Edge.

2. Pierwsza strona w skoroszycie szczegółów urządzenia to widok obsługi wiadomości z wybraną kartą routingu .

   Po lewej stronie tabela zawiera trasy na urządzeniu uporządkowane według punktu końcowego. Dla tego urządzenia punkt końcowy upstream, który jest terminem routingu do IoT Hub, odbiera komunikaty z modułu temperatureOutput danych wyjściowych symulowanego czujnika temperatury.

   Po prawej stronie wykres przedstawia liczbę połączonych klientów w czasie. Wybierz i przeciągnij wykres, aby zmienić zakres czasu.

   

3. Wybierz kartę wykresu, aby wyświetlić inną wizualizację tras. Na stronie grafu przeciągnij i upuść punkty końcowe, aby zmienić rozmieszczenie grafu. Ta funkcja ułatwia wizualizowanie wielu tras.

   

4. Na karcie Stan są wyświetlane wszelkie problemy w obsłudze komunikatów, takie jak porzucone komunikaty lub rozłączeni klienci.

5. Wybierz widok modułów , aby wyświetlić stan wszystkich modułów wdrożonych na urządzeniu. Wybierz moduł, aby wyświetlić szczegółowe informacje o użyciu procesora CPU i pamięci.

   

6. Wybierz widok host, aby wyświetlić informacje o urządzeniu hosta, w tym o jego systemie operacyjnym, wersji demona IoT Edge i użyciu zasobu.

Wyświetlanie dzienników modułów

Po wyświetleniu metryk dla urządzenia warto dokładniej zapoznać się z poszczególnymi modułami i zbadać je. IoT Edge zapewnia obsługę rozwiązywania problemów w portalu Azure z funkcją dziennika modułu na żywo.

1. W skoroszycie szczegółów urządzenia wybierz pozycję Rozwiązywanie problemów na żywo.

   

2. Strona rozwiązywania problemów otwiera się na dzienniki edgeAgent z urządzenia IoT Edge. Jeśli wybierzesz określony zakres czasu w skoroszycie szczegółów urządzenia, to ustawienie przejdzie do strony rozwiązywania problemów.

3. Użyj menu rozwijanego, aby przełączyć się do dzienników innych modułów uruchomionych na urządzeniu i użyć przycisku Uruchom ponownie , aby ponownie uruchomić moduł.

   

Dostęp do strony rozwiązywania problemów można również uzyskać na stronie szczegółów urządzenia IoT Edge. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z urządzeniami IoT Edge z poziomu portalu Azure.

Następne kroki

Zachowaj moduł zbierający metryki na twoich urządzeniach i wracaj do tych skoroszytów, aby zobaczyć, jak zmieniają się informacje podczas dodawania bardziej złożonych modułów i routingu w pozostałych samouczkach.

Przejdź do następnego samouczka, aby skonfigurować środowisko deweloperskie i rozpocząć wdrażanie modułów niestandardowych na urządzeniach.