Analisis model detektor di AWS IoT Events (AWS CLI)

Menganalisis model AWS IoT Events detektor Anda secara terprogram memberikan wawasan berharga tentang struktur, perilaku, dan kinerjanya. Pendekatan API berbasis ini memungkinkan analisis otomatis, integrasi dengan alur kerja Anda yang ada, dan kemampuan untuk melakukan operasi massal di beberapa model detektor. Dengan memanfaatkan StartDetectorModelAnalysisAPI, Anda dapat memulai pemeriksaan mendalam terhadap model Anda, membantu Anda mengidentifikasi potensi masalah, mengoptimalkan alur logika, dan memastikan bahwa pemrosesan peristiwa IoT Anda selaras dengan kebutuhan bisnis Anda.

Langkah-langkah berikut menggunakan AWS CLI untuk menganalisis model detektor.

Untuk menganalisis model detektor menggunakan AWS CLI

1. Jalankan perintah berikut untuk memulai analisis.

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

   catatan

   Ganti file-name dengan nama file yang berisi definisi model detektor.

   contoh Definisi model detektor

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

   Jika Anda menggunakan AWS CLI untuk menganalisis model detektor yang ada, pilih salah satu dari berikut ini untuk mengambil definisi model detektor:

   • Jika Anda ingin menggunakan AWS IoT Events konsol, lakukan hal berikut:

     1. Di panel navigasi, pilih Model detektor.

     2. Di bawah model Detektor, pilih model detektor target.

     3. Pilih Ekspor model detektor dari Tindakan untuk mengunduh model detektor. Model detektor disimpan diJSON.

     4. Buka JSON file model detektor.

     5. Anda hanya membutuhkan detectorModelDefinition objek. Hapus yang berikut ini:

        • Braket keriting pertama ({) di bagian atas halaman

        • detectorModelGaris

        • detectorModelConfigurationObjeknya

        • Braket keriting terakhir (}) di bagian bawah halaman

     6. Simpan file tersebut.

   • Jika Anda ingin menggunakan AWS CLI, lakukan hal berikut:

     1. Jalankan perintah berikut di terminal.

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

     2. Ganti detector-model-name dengan nama model detektor Anda.

     3. Salin detectorModelDefinition objek ke editor teks.

     4. Tambahkan kurung keriting ({}) di luar. detectorModelDefinition

     5. Simpan file diJSON.

   contoh Contoh tanggapan

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

2. Salin ID analisis dari output.

3. Jalankan perintah berikut untuk mengambil status analisis.

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

   catatan

   Ganti analysis-id dengan ID analisis yang Anda salin.

   contoh Contoh tanggapan

   {
       "status": "COMPLETE"
   }

   Nilai bisa jadi salah satu dari yang berikut:

   • RUNNING— AWS IoT Events Menganalisis model detektor Anda. Proses ini bisa memakan waktu hingga satu menit untuk menyelesaikannya.

   • COMPLETE— AWS IoT Events selesai menganalisis model detektor Anda.

   • FAILED— AWS IoT Events tidak dapat menganalisis model detektor Anda. Coba lagi nanti.

4. Jalankan perintah berikut untuk mengambil satu atau lebih hasil analisis model detektor.

   catatan

   Ganti analysis-id dengan ID analisis yang Anda salin.

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

   contoh Contoh tanggapan

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

catatan

Setelah AWS IoT Events mulai menganalisis model detektor Anda, Anda memiliki waktu hingga 24 jam untuk mengambil hasil analisis.