Weiterleiten von Messwerten nach Schweregrad

Senden Sie Messwerte mit hohem Schweregrad über einen Warnpfad, und führen Sie sie dann mit normalen Messwerten zusammen. Dieses Beispiel droppt zuerst die Lesungen mit temperature > 1000. Es fügt severity > 5 hinzu, wenn alert: true, und benennt Felder auf beiden Pfaden um.

Voraussetzungen

Dieses eigenständige Beispiel verwendet den vorhandenen MQTT-Endpunkt default, das Profil und den Registrierungsendpunkt default, telemetry/sensors als Eingabe und telemetry/processed als Ausgabe. Für Bereitstellungsvoraussetzungen, Bicep-Elternressourcen und Azure CLI-Umgebungsvariablen (AIO_INSTANCE_NAME und RESOURCE_GROUP) siehe Create a Data Flow Graph.

  • Eine Instanz von Azure IoT Einsatz, die in einem Kubernetes-Cluster bereitgestellt wird. Weitere Informationen finden Sie unter Deploy Azure IoT Einsatz.

Die Azure CLI-Beispiele in diesem Artikel verwenden Umgebungsvariablen, so dass Sie jeden Wert einmal festlegen und die Befehle dann unverändert kopieren und einfügen können. Wenn Sie die Azure IoT Einsatz Codespaces-Umgebung aus dem Quickstart verwenden, sind diese Variablen bereits für Sie festgelegt und Sie können diesen Schritt überspringen. Ansonsten setze die folgenden Umgebungsvariablen in deiner Shell, bevor du die Befehle ausführst.

Die folgenden Skripte legen die am häufigsten verwendeten Umweltvariablen fest:

Umgebungsvariable Description
SUBSCRIPTION_ID Die ID des Abonnements, das Ihre Azure IoT Einsatz-Instanz enthält.
RESOURCE_GROUP Der Name der Ressourcengruppe, die Ihre Azure IoT Einsatz-Instanz enthält.
AIO_INSTANCE_NAME Der Name Ihrer Azure IoT Einsatz Instanz. Um deine Instanzen aufzulisten, führe az iot ops list -o table aus.
CLUSTER_NAME Der Name des Azure Arc-fähigen Kubernetes-Clusters, der deine Instanz hostet.
LOCATION Die Azure-Region zur Nutzung für neue Ressourcen, zum Beispiel eastus.
SUBSCRIPTION_ID=<subscription-id>
RESOURCE_GROUP=<resource-group-name>
AIO_INSTANCE_NAME=<instance-name>
CLUSTER_NAME=<cluster-name>
LOCATION=<region>

Du musst nur die Variablen festlegen, die dieser Artikel verwendet. Dieser Artikel könnte zusätzliche Umgebungsvariablen für die von Ihnen gewählten Ressourcennamen verwenden. Der Artikel erklärt, wie man sie dort platziert, wo sie eingeführt werden.

Das Beispiel geht von numerischen temperature- und severity-Feldern sowie einem deviceId aus; es führt keine Schema-Validierung durch.

Konfigurieren der Schweregradrouten

Diagramm zeigt einen Filter, der die Temperaturen über 1000 verwirft, einen Zweig, der Schweregrad über 5 an eine Alert-Map sendet, andere Messwerte an eine Normal-Map, und Concatenate, die beide Pfade zur Telemetrie/Verarbeitung weiterleitet.

Concatenate leitet jede verarbeitete Nachricht unabhängig voneinander weiter; es führt keine Datensätze zusammen und garantiert keine Reihenfolge über Pfade hinweg. Das Beispiel benennt Felder um, wandelt aber keine Temperatureinheiten um.

Synthetische Eingabe auf telemetry/sensors Ausgabe auf telemetry/processed
{"deviceId":"sensor-01","temperature":20,"severity":2} {"id":"sensor-01","temp":20}
{"deviceId":"sensor-01","temperature":20,"severity":8} {"id":"sensor-01","temp":20,"alert":true}
{"deviceId":"sensor-01","temperature":1001,"severity":8} Dropped

Screenshot der Leinwand für das Betriebserlebnis, die eine Filter-, Verzweigungs-, Karten-, Verkettungs- und Zielpipeline zeigt.

So erstellen Sie diese Pipeline in der Einsatzumgebung:

  1. Erstellen Sie ein Datenflussdiagramm und fügen Sie eine Quelle hinzu, die aus telemetry/sensors gelesen wird.
  2. Fügen Sie eine Filtertransformation hinzu. Konfigurieren Sie eine Regel, die Nachrichten temperature > 1000dort abbricht.
  3. Fügen Sie eine Verzweigungstransformation hinzu. Konfigurieren Sie die Bedingung severity > 5 , um Nachrichten mit hohem Schweregrad an den tatsächlichen Pfad weiterzuleiten.
  4. Fügen Sie eine Kartentransformation auf dem wahren Pfad hinzu. Konfigurieren Sie Regeln zum Umbenennen von deviceId in id und von temperature in temp, und fügen Sie ein Feld alert hinzu, das auf true gesetzt wird.
  5. Fügen Sie eine Kartentransformation auf dem falschen Pfad hinzu. Konfigurieren Sie Regeln für die Umbenennung deviceId in id und temperature in temp.
  6. Fügen Sie eine verkettete Transformation hinzu, um beide Pfade zusammenzuführen.
  7. Fügen Sie ein Ziel hinzu, das an telemetry/processed sendet.
  8. Verbinden Sie die Elemente: Quelle → Filter → Verzweigung → (wahrer Pfad: Alarmkarte, falscher Pfad: normale Karte) → Verkettung → Ziel.