Analysieren Sie ein Detektormodell in AWS IoT Events (AWS CLI)

Die programmatische Analyse Ihrer AWS IoT Events Detektormodelle bietet wertvolle Einblicke in deren Struktur, Verhalten und Leistung. Dieser API basierte Ansatz ermöglicht eine automatisierte Analyse, die Integration in Ihre bestehenden Workflows und die Möglichkeit, Massenoperationen über mehrere Detektormodelle hinweg durchzuführen. Mithilfe der StartDetectorModelAnalysisAPIkönnen Sie eingehende Untersuchungen Ihrer Modelle einleiten, um potenzielle Probleme zu identifizieren, logische Abläufe zu optimieren und sicherzustellen, dass Ihre IoT-Ereignisverarbeitung Ihren Geschäftsanforderungen entspricht.

In den folgenden Schritten wird AWS CLI ein Detektormodell analysiert.

Um ein Detektormodell zu analysieren mit AWS CLI

1. Führen Sie den folgenden Befehl aus, um eine Analyse zu starten.

   aws iotevents start-detector-model-analysis --cli-input-json file://file-name.json

   Anmerkung

   Ersetzen file-name mit dem Namen der Datei, die die Definition des Detektormodells enthält.

   Beispiel Definition des Detektormodells

   {
       "detectorModelDefinition": {
           "states": [
               {
                   "stateName": "TemperatureCheck",
                   "onInput": {
                       "events": [
                           {
                               "eventName": "Temperature Received",
                               "condition": "isNull($input.TemperatureInput.sensorData.temperature)==false",
                               "actions": [
                                   {
                                       "iotTopicPublish": {
                                           "mqttTopic": "IoTEvents/Output"
                                       }
                                   }
                               ]
                           }
                       ],
                       "transitionEvents": []
                   },
                   "onEnter": {
                       "events": [
                           {
                               "eventName": "Init",
                               "condition": "true",
                               "actions": [
                                   {
                                       "setVariable": {
                                           "variableName": "temperatureChecked",
                                           "value": "0"
                                       }
                                   }
                               ]
                           }
                       ]
                   },
                   "onExit": {
                       "events": []
                   }
               }
           ],
           "initialStateName": "TemperatureCheck"
       }
   }

   Wenn Sie den verwenden AWS CLI , um ein vorhandenes Detektormodell zu analysieren, wählen Sie eine der folgenden Optionen, um die Definition des Detektormodells abzurufen:

   • Wenn Sie die AWS IoT Events Konsole verwenden möchten, gehen Sie wie folgt vor:

     1. Wählen Sie im Navigationsbereich die Option Detector models aus.

     2. Wählen Sie unter Detektormodelle das Zieldetektormodell aus.

     3. Wählen Sie unter Aktion die Option Detektormodell exportieren aus, um das Detektormodell herunterzuladen. Das Detektormodell ist in gespeichertJSON.

     4. Öffnen Sie die JSON Modelldatei des Detektors.

     5. Sie benötigen nur das detectorModelDefinition Objekt. Entfernen Sie Folgendes:

        • Die erste geschweifte Klammer ({) oben auf der Seite

        • Die Linie detectorModel

        • Das detectorModelConfiguration-Objekt

        • Die letzte geschweifte Klammer (}) unten auf der Seite

     6. Speichern Sie die Datei.

   • Wenn Sie den verwenden möchten AWS CLI, gehen Sie wie folgt vor:

     1. Führen Sie folgenden Befehl von einem Terminal aus.

        aws iotevents describe-detector-model --detector-model-name detector-model-name

     2. Ersetzen detector-model-name mit dem Namen Ihres Detektormodells.

     3. Kopieren Sie das detectorModelDefinition Objekt in einen Texteditor.

     4. Fügen Sie geschweifte Klammern ({}) außerhalb von hinzu. detectorModelDefinition

     5. Speichern Sie die Datei inJSON.

   Beispielantwort

   {
       "analysisId": "c1133390-14e3-4204-9a66-31efd92a4fed"
   }

2. Kopieren Sie die Analyse-ID aus der Ausgabe.

3. Führen Sie den folgenden Befehl aus, um den Status der Analyse abzurufen.

   aws iotevents describe-detector-model-analysis --analysis-id "analysis-id"

   Anmerkung

   Ersetzen analysis-id mit der Analyse-ID, die Sie kopiert haben.

   Beispielantwort

   {
       "status": "COMPLETE"
   }

   Der Status kann einer der folgenden Werte sein:

   • RUNNING— AWS IoT Events analysiert Ihr Detektormodell. Dieser Vorgang kann bis zu einer Minute dauern.

   • COMPLETE— die Analyse Ihres Detektormodells AWS IoT Events abgeschlossen.

   • FAILED— AWS IoT Events konnte Ihr Detektormodell nicht analysieren. Bitte versuchen Sie es später erneut.

4. Führen Sie den folgenden Befehl aus, um ein oder mehrere Analyseergebnisse des Detektormodells abzurufen.

   Anmerkung

   Ersetzen analysis-id mit der Analyse-ID, die Sie kopiert haben.

   aws iotevents get-detector-model-analysis-results --analysis-id "analysis-id"

   Beispielantwort

   {
       "analysisResults": [
           {
               "type": "data-type",
               "level": "INFO",
               "message": "Inferred data types [Integer] for $variable.temperatureChecked",
               "locations": []
           },
           {
               "type": "referenced-resource",
               "level": "ERROR",
               "message": "Detector Model Definition contains reference to Input 'TemperatureInput' that does not exist.",
               "locations": [
                   {
                       "path": "states[0].onInput.events[0]"
                   }
               ]
           }
       ]
   }

Anmerkung

Nachdem Sie AWS IoT Events mit der Analyse Ihres Detektormodells begonnen haben, haben Sie bis zu 24 Stunden Zeit, um die Analyseergebnisse abzurufen.