ディテクターモデルの分析 (AWS CLI)

次のステップでは、AWS CLI を使用してディテクターモデルを分析します。

1. 次のコマンドを実行して、分析をスタートします。

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

   注記

   ファイル名を、ディテクターモデル定義を含むファイルの名前に置き換えます。

   例 ディテクターモデルの定義

   {
       "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"
       }
   }

   AWS CLI を使用して既存のディテクターモデルを分析する場合、 は次のいずれかを選択してディテクターモデルの定義を取得します。

   • AWS IoT Events コンソールを使用する場合は、次の手順を実行します。

     1. ナビゲーションペインで、ディテクターモデルを選択します。

     2. ディテクターモデルで、ターゲットディテクターモデルを選択します。

     3. アクションからディテクターモデルをエクスポートを選択して、ディテクターモデルをダウンロードします。ディテクターモデルは JSON で保存されます。

     4. ディテクターモデルの JSON ファイルを開きます。

     5. 必要なのは detectorModelDefinition オブジェクトだけです。以下を削除します。

        • ページ上部の最初の中括弧 ({)

        • detectorModel 線

        • detectorModelConfiguration オブジェクト

        • ページ下部の最後の中括弧 (})

     6. ファイルを保存します。

   • AWS CLI を使用する場合は、次のようにします。

     1. ターミナルで次のコマンドを実行します。

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

     2. ディテクターモデルの名前をディテクターモデルの名前に置き換えます。

     3. detectorModelDefinition オブジェクトをテキストエディタにコピーします。

     4. detectorModelDefinition の外側に中括弧 ({}) を追加します。

     5. ファイルを JSON で保存します。

   例 レスポンスの例

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

2. 出力から分析 ID をコピーします。

3. 次のコマンドを実行して、分析のステータスを取得します。

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

   注記

   analysis-id をコピーした分析 ID に置き換えます。

   例 レスポンスの例

   {
       "status": "COMPLETE"
   }

   ステータスは、次のいずれかの値になります。

   • RUNNING - AWS IoT Events ディテクターモデルを分析しています。このプロセスは、完了するまでに最大 1 分かかる場合があります。

   • COMPLETE - AWS IoT Events は、ディテクターモデルの分析を終了しました。

   • FAILED - AWS IoT Events は、ディテクターモデルを分析できませんでした。あとでもう一度試してみてください。

4. 次のコマンドを実行して、ディテクターモデルの 1 つ以上の分析結果を取得します。

   注記

   analysis-id をコピーした分析 ID に置き換えます。

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

   例 レスポンスの例

   {
       "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]"
                   }
               ]
           }
       ]
   }

注記

AWS IoT Events がディテクターモデルの分析をスタートしてから、分析結果を取得するのに最大 24 時間かかります。