Teilen über

Überwachen von IoT Edge-Bereitstellungen

  • Artikel

Gilt für: Häkchen für IoT Edge 1.5 IoT Edge 1.5 IoT Edge 1.4 Häkchen IoT Edge 1.4

Wichtig

IoT Edge 1.5 LTS und IoT Edge 1.4 LTS sind unterstützte Releases. Das Ende der Lebensdauer von IoT Edge 1.4 LTS wird am 12. November 2024 erreicht. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Mit den Berichterstellungsfunktionen von Azure IoT Edge können Sie die Echtzeitinformationen der Module überwachen, die auf Ihren IoT Edge-Geräten bereitgestellt wurden. Der IoT Hub-Dienst ruft den Status von den Geräten ab und macht diese für den Operator verfügbar. Die Überwachung ist auch für umfangreiche Bereitstellungen wichtig, wie z. B. automatische und mehrstufige Bereitstellungen.

Geräte und Module verfügen über ähnliche Daten (beispielsweise für die Konnektivität). Aus diesem Grund werden die Werte basierend auf der Geräte-ID oder der Modul-ID erfasst.

Der IoT Hub-Dienst erfasst die von Geräte- und Modulzwillingen gemeldeten Daten und gibt die Anzahl der unterschiedlichen Status an, die Geräte aufweisen können. Diese Daten werden vom IoT Hub-Dienst in vier Gruppen von Metriken eingeteilt:

Typ Beschreibung
Ziel- Zeigt die IoT Edge-Geräte an, die den Zielbedingungen für die Bereitstellung entsprechen.
Übernommen Zeigt die IoT Edge-Zielgeräte an, für die keine andere Bereitstellung mit höherer Priorität vorhanden ist.
Erfolg gemeldet Zeigt die IoT Edge-Geräte an, die gemeldet haben, dass die Module erfolgreich bereitgestellt wurden.
Fehler gemeldet Zeigt die IoT Edge-Geräte an, die gemeldet haben, dass ein oder mehrere Module nicht erfolgreich bereitgestellt wurden. Stellen Sie zum weiteren Untersuchen des Fehlers eine Remoteverbindung mit diesen Geräten her, und zeigen Sie die Protokolldateien an.

Der IoT Hub-Dienst stellt diese Daten zur Überwachung im Azure-Portal und über die Azure CLI zur Verfügung.

Überwachen einer Bereitstellung im Azure-Portal

So zeigen Sie ausführliche Informationen zu einer Bereitstellung an und überwachen die Geräte, die diese ausführen:

  1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrer IoT Hub-Instanz.

  2. Wählen Sie Konfigurationen + Bereitstellungen im Menü Geräteverwaltung aus.

  3. Prüfen Sie die Bereitstellungsliste. Für jede Bereitstellung können Sie die folgenden Details anzeigen:

    Spalte Beschreibung
    Kennung Der Name der Bereitstellung
    type Der Typ der Bereitstellung – entweder Bereitstellung oder Mehrstufige Bereitstellung.
    Zielbedingung Das Tag zur Definition von Zielgeräten.
    Priorität Die Prioritätsnummer, die der Bereitstellung zugewiesen wurde.
    Systemmetriken Die Anzahl von Gerätezwillingen in IoT Hub, die die Zielbedingung erfüllen. Applied gibt die Anzahl von Geräten an, auf deren Modulzwillinge in IoT Hub die Bereitstellungsinhalte angewendet wurden.
    Gerätemetriken Die Anzahl von IoT Edge-Geräten, für die von der IoT Edge-Clientruntime eine Erfolgs- oder Fehlermeldung ausgegeben wurde.
    Benutzerdefinierte Metriken Die Anzahl von IoT Edge-Geräten, die Daten für in der Bereitstellung definierte Metriken melden.
    Erstellt Der Zeitstempel der Bereitstellungserstellung. Dieser Zeitstempel wird zur Konfliktlösung verwendet, wenn zwei Bereitstellungen dieselbe Priorität haben.

  4. Wählen Sie die Bereitstellung aus, die Sie überwachen möchten.

  5. Führen Sie auf der Seite Bereitstellungsdetails einen Bildlauf zum unteren Abschnitt durch, und wählen Sie die Registerkarte Zielbedingung aus. Wählen Sie Anzeigen aus, um eine Liste mit Geräten anzuzeigen, die der Zielbedingung entsprechen. Sie können die Bedingung ändern und auch die Priorität festlegen. Wählen Sie Speichern aus, wenn Sie Änderungen vorgenommen haben.

    Screenshot: Zielgerät einer Bereitstellung

  6. Wählen Sie die Registerkarte Metriken aus. Wenn Sie eine Metrik im Dropdownmenü Metrik auswählen ausgewählt haben, wird eine Schaltfläche Anzeigen angezeigt, über die Sie auf die Ergebnisse zugreifen können. Sie können auch Metriken bearbeiten auswählen, um die Kriterien für benutzerdefinierte Metriken anzupassen, die Sie definiert haben. Wählen Sie Speichern aus, wenn Sie Änderungen vorgenommen haben.

    Screenshot: Metriken für eine Bereitstellung

Informationen zum Durchführen von Änderungen an Ihrer Bereitstellung finden Sie unter Ändern einer Bereitstellung.

Überwachen einer Bereitstellung über die Azure-Befehlszeilenschnittstelle

Mit dem Befehl az iot edge deployment show können Sie die Details einer einzelnen Bereitstellung anzeigen:

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

Für diesen Befehl werden die folgenden Parameter verwendet:

  • --deployment-id: Der Name der Bereitstellung, die im IoT-Hub vorhanden ist Erforderlicher Parameter.
  • --hub-name – Name des IoT Hub, in dem die Bereitstellung vorhanden ist. Der Hub muss aus dem aktuellen Abonnement stammen. Wechseln Sie mit dem Befehl az account set -s [subscription name] zum gewünschten Abonnement.

Überprüfen Sie die Bereitstellung im Befehlsfenster. Die Eigenschaft metrics enthält eine Anzahl für jede Metrik, die von den einzelnen Hubs ausgewertet wird:

  • targetedCount – eine Systemmetrik, die die Anzahl der Gerätezwillinge in IoT Hub angibt, die die Zielbedingung erfüllen.
  • appliedCount: Eine Systemmetrik, die die Anzahl von Geräten angibt, auf deren Modulzwillinge in IoT Hub die Bereitstellungsinhalte angewendet wurden.
  • reportedSuccessfulCount: Eine Gerätemetrik, die die Anzahl von IoT Edge-Geräten in der Bereitstellung angibt, für die von der IoT Edge-Clientruntime eine Erfolgsmeldung ausgegeben wurde.
  • reportedFailedCount: Eine Gerätemetrik, die die Anzahl von IoT -Geräten in der Bereitstellung angibt, für die von der IoT Edge-Clientruntime eine Fehlermeldung ausgegeben wurde.

Sie können mit dem Befehl az iot edge deployment show-metric eine Liste der Geräte-IDs oder Objekte für jede der Metriken anzeigen:

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

Für diesen Befehl werden die folgenden Parameter verwendet:

  • --deployment-id: Der Name der Bereitstellung, die im IoT-Hub vorhanden ist
  • --metric-id: Der Name der Metrik, für die Sie eine Liste der Geräte-IDs anzeigen möchten, z. B. reportedFailedCount.
  • --hub-name – Name des IoT Hub, in dem die Bereitstellung vorhanden ist. Der Hub muss aus dem aktuellen Abonnement stammen. Wechseln Sie mit dem Befehl az account set -s [subscription name] zum gewünschten Abonnement.

Informationen zum Durchführen von Änderungen an Ihrer Bereitstellung finden Sie unter Ändern einer Bereitstellung.

Nächste Schritte

Erfahren Sie, wie Sie Modulzwillinge überwachen (primär die IoT Edge-Agent- und IoT Edge-Hub-Runtimemodule), um die Konnektivität und Integrität Ihrer IoT Edge-Bereitstellungen zu gewährleisten.