Udostępnij przez

Samouczek: monitorowanie urządzeń usługi IoT Edge

Dotyczy:Znacznik wyboru usługi IoT Edge 1.5 IoT Edge 1.5

Ważne

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

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

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

  • Dowiedz się, jakie metryki udostępniają urządzenia usługi IoT Edge i jak moduł zbierający metryki obsługuje je.
  • Wdróż moduł modułu zbierającego metryki na urządzeniu usługi IoT Edge.
  • Wyświetl wyselekcjonowane wizualizacje metryk zebranych z urządzenia.

Wymagania wstępne

Potrzebujesz urządzenia IoT Edge z zainstalowanym modułem symulowanego czujnika temperatury. Jeśli nie masz gotowego urządzenia, wykonaj kroki opisane w artykule Wdrażanie pierwszego modułu usługi IoT Edge na wirtualnym urządzeniu z systemem Linux, aby utworzyć urządzenie przy użyciu maszyny wirtualnej.

Omówienie metryk usługi IoT Edge

Każde urządzenie usługi IoT Edge opiera się na dwóch modułach nazywanych modułami środowiska uruchomieniowego, które zarządzają cyklem życia i komunikacją wszystkich pozostałych modułów na urządzeniu. Te moduły są agentem usługi IoT Edge i centrum usługi IoT Edge. Aby dowiedzieć się więcej na temat tych modułów, zobacz Omówienie środowiska uruchomieniowego usługi Azure IoT Edge i jego architektury.

Oba moduły środowiska uruchomieniowego tworzą metryki, które umożliwiają zdalne monitorowanie działania urządzenia usługi IoT Edge lub jego poszczególnych modułów. Agent usługi 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 usługi IoT Edge raportuje komunikację na urządzeniu, dzięki czemu 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 używana w tym samouczku wysyła metryki bezpośrednio do usługi Log Analytics. Druga opcja jest zalecana tylko wtedy, gdy zasady sieci wymagają tej opcji. Wysyła ona metryki za pośrednictwem usługi IoT Hub, a następnie konfiguruje trasę przekazywania komunikatów metryk do usługi Log Analytics. Tak czy inaczej, gdy metryki znajdują się w obszarze roboczym usługi Log Analytics, możesz je wyświetlić za pomocą skoroszytów usługi Azure Monitor.

Tworzenie obszaru roboczego usługi Log Analytics

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

  1. Zaloguj się w witrynie Azure Portal.

  2. Wyszukaj obszary robocze usługi 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 identyfikatora obszaru roboczego i klucza podstawowego pod Instrukcjami agenta usługi 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.

Pobieranie identyfikatora zasobu centrum IoT

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

  1. Na portalu Azure przejdź do swojego 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 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ł modułu zbierającego:

  1. Zaloguj się do witryny Azure Portal, a następnie przejdź do centrum IoT Hub.

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

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

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

  3. 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 Moduły usługi IoT Edge wybierz pozycję Dodaj, a następnie wybierz pozycję Moduł usługi IoT Edge.

    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 uruchomiono

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

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

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

  4. Dodaj i skonfiguruj moduł modułu modułu zbierającego metryki:

    1. Wybierz pozycję Dodaj, a następnie wybierz pozycję Moduł usługi IoT Edge.

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

    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 uruchomiono

    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 centrum IoT Hub pobrany w poprzedniej sekcji.
      UploadTarget AzureMonitor
      LogAnalyticsWorkspaceId Identyfikator obszaru roboczego usługi Log Analytics pobrany w poprzedniej sekcji.
      LogAnalyticsSharedKey Klucz usługi 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 usługi IoT Hub, dodaj trasę do przesyłania w górę podobną do FROM /messages/modules/< FROM_MODULE_NAME >/* INTO $upstream. W tym samouczku metryki są wysyłane bezpośrednio do usługi Log Analytics, więc ta trasa nie jest potrzebna.

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

  6. 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 chwil, aby wszystkie cztery moduły były wyświetlane jako Zgłaszane przez urządzenie, co oznacza, że zostały uruchomione i zgłosiły swój stan do usługi 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 wysyłanie komunikatów metryk do Log Analytics, gdzie są one zorganizowane w tabeli. Identyfikator zasobu usługi IoT Hub, który udostępniasz, łączy pozyskane metryki z poprawnym centrum. W związku z tym wyselekcjonowane skoroszyty usługi IoT Edge pobierają metryki, wysyłając zapytanie do tabeli metryk przy użyciu identyfikatora zasobu.

Usługa 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.

Eksplorowanie skoroszytów migawki widoku floty i kondycji

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 Hub w witrynie Azure Portal.

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

    Wybierz skoroszyty, aby otworzyć galerię skoroszytów usługi Azure Monitor.

  3. Wybierz skoroszyt Widok 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.

    Zrzut ekranu przedstawiający wybieranie i przeciąganie lub używanie ikon strzałek na dowolnym wykresie w celu zmiany zakresu 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. W przypadku tego urządzenia punkt końcowy wsteczny, który jest używany do routingu do usługi IoT Hub, odbiera komunikaty z temperatureOutput wyjścia modułu symulowanego czujnika temperatury.

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

    Wybierz widok obsługi komunikatów, aby wyświetlić stan komunikacji na urządzeniu.

  3. Wybierz kartę grafów, 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.

    Wybierz widok grafu, aby wyświetlić interaktywny wykres tras urządzeń.

  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.

    Wybierz widok modułów, aby wyświetlić stan każdego modułu wdrożonego na urządzeniu.

  6. Wybierz widok hosta , aby wyświetlić informacje o urządzeniu hosta, w tym jego systemie operacyjnym, wersji demona usługi 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. Usługa IoT Edge zapewnia obsługę rozwiązywania problemów w witrynie Azure Portal z funkcją dziennika modułu na żywo.

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

    Wybierz przycisk Rozwiązywanie problemów na żywo w prawym górnym rogu skoroszytu szczegółów urządzenia.

  2. Zostanie otwarta strona rozwiązywania problemów z dziennikami edgeAgent z urządzenia usługi 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ł.

    Użyj menu rozwijanego, aby wyświetlić dzienniki różnych modułów i użyć przycisku ponownego uruchomienia, aby ponownie uruchomić moduły.

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

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.

Tworzenie modułów usługi Azure IoT Edge przy użyciu programu Visual Studio Code

  • Last updated on