지원 종료 알림: 2026년 5월 20일에 AWS 에 대한 지원이 종료됩니다 AWS IoT Events. 2026년 5월 20일 이후에는 AWS IoT Events 콘솔 또는 AWS IoT Events 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은 [AWS IoT Events 지원 종료를 참조하세요](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS IoT Events (AWS CLI)에서 감지기 모델 분석
<a name="analyze-api-api"></a>

 AWS IoT Events 감지기 모델을 프로그래밍 방식으로 분석하면 구조, 동작 및 성능에 대한 귀중한 인사이트를 얻을 수 있습니다. 이 API 기반 접근 방식을 사용하면 자동화된 분석, 기존 워크플로와의 통합, 여러 감지기 모델에서 대량 작업을 수행할 수 있습니다. [StartDetectorModelAnalysis](https://docs.aws.amazon.com/iotevents/latest/apireference/API_StartDetectorModelAnalysis.html) API를 활용하면 모델에 대한 심층 검사를 시작하여 잠재적 문제를 식별하고, 로직 흐름을 최적화하고, IoT 이벤트 처리가 비즈니스 요구 사항에 부합하는지 확인할 수 있습니다.

다음 단계에서는 AWS CLI 를 사용하여 감지기 모델을 분석합니다.

**를 사용하여 감지기 모델을 분석하려면 AWS CLI**

1. 다음 명령을 실행해 분석을 시작합니다.

   ```
   aws iotevents start-detector-model-analysis --cli-input-json file://file-name.json
   ```
**참고**  
*file-name*을 감지기 모델 정의가 포함된 파일의 이름으로 대체합니다.  
**Example 감지기 모델 정의**  

   ```
   {
       "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. 탐색 창에서 **감지기 모델**을 선택합니다.

     1. **감지기 모델**에서 대상 감지기 모델을 선택합니다.

     1. **작업**에서 **감지기 모델 내보내기**를 선택하여 감지기 모델을 다운로드합니다. 감지기 모델은 JSON으로 저장됩니다.

     1. 감지기 모델 JSON 파일을 엽니다.

     1. `detectorModelDefinition` 객체만 있으면 됩니다. 다음을 제거하십시오.
        + 페이지 상단의 첫 번째 중괄호(`{`)
        + `detectorModel` 라인
        + `detectorModelConfiguration` 객체
        + 페이지 하단의 마지막 중괄호(`}`)

     1. 파일을 저장합니다.
   + 를 사용하려면 다음을 AWS CLI수행합니다.

     1. 터미널에서 다음 명령을 실행하십시오.

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

     1. *detector-model-name*을 감지기 모델 이름으로 바꾸십시오.

     1. `detectorModelDefinition` 개체를 텍스트 편집기에 복사합니다.

     1. `detectorModelDefinition` 외부에 중괄호(`{}`)를 추가합니다.

     1. 파일을 JSON으로 저장합니다.  
**Example 응답의 예**  

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

1. 출력에서 분석 ID를 복사합니다.

1. 다음 명령을 실행하여 분석 상태를 검색합니다.

   ```
   aws iotevents describe-detector-model-analysis --analysis-id "analysis-id"
   ```
**참고**  
*analysis-id*를 복사한 분석 ID로 바꾸십시오.  
**Example 응답의 예**  

   ```
   {
       "status": "COMPLETE"
   }
   ```

   상태는 다음 값 중 하나일 수 있습니다.
   + `RUNNING` - 감지 AWS IoT Events 기 모델을 분석합니다. 이 프로세스가 완료되는 데 최대 1분이 걸릴 수 있습니다.
   + `COMPLETE` - 감지기 모델 분석을 AWS IoT Events 완료했습니다.
   + `FAILED` –감지기 모델을 분석할 수 AWS IoT Events 없습니다. 나중에 다시 시도해 주세요.

1. 다음 명령을 실행하여 감지기 모델의 분석 결과를 하나 이상 검색합니다.
**참고**  
*analysis-id*를 복사한 분석 ID로 바꾸십시오.

   ```
   aws iotevents get-detector-model-analysis-results --analysis-id "analysis-id"
   ```  
**Example 응답의 예**  

   ```
   {
       "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시간 동안 분석 결과를 검색할 수 있습니다.