Analyzing a detector model (Amazon CLI) - Amazon IoT Events
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Analyzing a detector model (Amazon CLI)

The following steps use the Amazon CLI to analyze a detector model.

  1. Run the following command to start an analysis.

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

    Replace file-name with the name of the file that contains the detector model definition.

    Example Detector model definition
    {
    "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"
    }
}

    If you use the Amazon CLI to analyze an existing detector model, choose one of the following to retrieve the detector model definition:

    • If you want to use the Amazon IoT Events console, do the following:

      1. In navigation pane, choose Detector models.

      2. Under Detector models, choose the target detector model.

      3. Choose Export detector model from Action to download the detector model. The detector model is saved in JSON.

      4. Open the detector model JSON file.

      5. You only need the detectorModelDefinition object. Remove the following:

        • The first curly bracket ({) at the top of the page

        • The detectorModel line

        • The detectorModelConfiguration object

        • The last curly bracket (}) at the bottom of the page

      6. Save the file.

    • If you want to use the Amazon CLI, do the following:

      1. Run the following command in a terminal.

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

      2. Replace detector-model-name with the name of your detector model.

      3. Copy the detectorModelDefinition object to a text editor.

      4. Add curly brackets ({}) outside of the detectorModelDefinition.

      5. Save the file in JSON.

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

  2. Copy the analysis ID from the output.

  3. Run the following command to retrieve the status of the analysis.

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

    Replace analysis-id with the analysis ID that you copied.

    Example response
    {
    "status": "COMPLETE"
}

    The status can be one of the following values:

    • RUNNING – Amazon IoT Events is analyzing your detector model. This process can take up to one minute to complete.

    • COMPLETE – Amazon IoT Events finished analyzing your detector model.

    • FAILED – Amazon IoT Events couldn't analyze your detector model. Try again later.

  4. Run the following command to retrieve one or more analysis results of the detector model.

    Note

    Replace analysis-id with the analysis ID that you copied.

    aws iotevents get-detector-model-analysis-results --analysis-id "analysis-id"
    Example response
    {
    "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]"
                }
            ]
        }
    ]
}
Note

After Amazon IoT Events starts analyzing your detector model, you have up to 24 hours to retrieve the analysis results.