

Hinweis zum Ende des Supports: Am 20. Mai 2026 AWS endet der Support für AWS IoT Events. Nach dem 20. Mai 2026 können Sie nicht mehr auf die AWS IoT Events Konsole oder AWS IoT Events die Ressourcen zugreifen. Weitere Informationen finden Sie unter [AWS IoT Events Ende des Supports](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Analysieren Sie ein Detektormodell in AWS IoT Events (AWS CLI)
<a name="analyze-api-api"></a>

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. Durch die Nutzung der [StartDetectorModelAnalysis](https://docs.aws.amazon.com/iotevents/latest/apireference/API_StartDetectorModelAnalysis.html)API können Sie eingehende Untersuchungen Ihrer Modelle einleiten und so potenzielle Probleme identifizieren, logische Abläufe optimieren und sicherstellen, 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**  
*file-name*Ersetzen Sie es durch den Namen der Datei, die die Definition des Detektormodells enthält.  
**Example 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.

     1. Wählen Sie unter **Detektormodelle** das Zieldetektormodell aus.

     1. Wählen Sie **unter **Aktion** die Option Detektormodell exportieren** aus, um das Detektormodell herunterzuladen. Das Detektormodell wird in JSON gespeichert.

     1. Öffnen Sie die JSON-Datei für das Detektormodell.

     1. 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

     1. 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
        ```

     1. *detector-model-name*Ersetzen Sie es durch den Namen Ihres Meldermodells.

     1. Kopieren Sie das `detectorModelDefinition` Objekt in einen Texteditor.

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

     1. Speichern Sie die Datei in JSON.  
**Example Beispielantwort**  

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

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

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

   ```
   aws iotevents describe-detector-model-analysis --analysis-id "analysis-id"
   ```
**Anmerkung**  
*analysis-id*Ersetzen Sie durch die Analyse-ID, die Sie kopiert haben.  
**Example 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.

1. Führen Sie den folgenden Befehl aus, um ein oder mehrere Analyseergebnisse des Detektormodells abzurufen.
**Anmerkung**  
*analysis-id*Ersetzen Sie es durch die Analyse-ID, die Sie kopiert haben.

   ```
   aws iotevents get-detector-model-analysis-results --analysis-id "analysis-id"
   ```  
**Example 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.