자산 전반의 센서에서 이상 탐지 활성화 - AWS IoT SiteWise
계산 모델 생성(AWS CLI)ExecuteAction API 페이로드 준비훈련 AWS CLI추론 시작 및 중지(AWS CLI)

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

자산 전반의 센서에서 이상 탐지 활성화

계산 모델 생성(AWS CLI)

계산 모델을 생성하려면 AWS 명령줄 인터페이스(AWS CLI)를 사용합니다. 계산 모델을 정의한 후 여러 자산에서 이상 탐지를 수행하도록 모델을 훈련하고 추론을 예약합니다 AWS IoT SiteWise.

다음 단계에서는이 프로세스를 설명합니다.

  1. 이상 탐지를 설정하려면 UpdateAssetModel(AWS CLI)을 사용하고 다음 요구 사항을 충족합니다.

    1. DOUBLE 또는 INTEGER 데이터 형식의 입력 속성이 하나 이상 있습니다. 측정 또는 변환 속성이며 모델을 훈련하는 데 사용됩니다.

    2. STRING 데이터 형식의 결과 속성입니다. 측정 속성이어야 하며 이상 탐지 결과를 저장합니다.

  2. 다음 콘텐츠anomaly-detection-computation-model-payload.json가 포함된 파일을 생성합니다.

    참고

    를 데이터 소스assetProperty로 직접 제공하여 계산 모델을 생성합니다.

    {
    "computationModelName": "name of ComputationModel",
    "computationModelConfiguration": {
        "anomalyDetection": {
            "inputProperties": "${properties}",
            "resultProperty": "${p3}"
        }
    },
    "computationModelDataBinding": {
        "properties": {
            "list": [
                {
                    "assetProperty": { 
                        "assetId": "asset-id",
                        "propertyId": "input-property-id-1"
                    }
                },
                {
                    "assetProperty": { 
                        "assetId": "asset-id",
                        "propertyId": "input-property-id-2"
                    }
                }
            ]
        },
        "p3": {
            "assetProperty": { 
                "assetId": "asset-id",
                "propertyId": "results-property-id"
            }
        }
    }
}

  3. 다음 명령을 실행하여 계산 모델을 생성합니다.

    aws iotsitewise create-computation-model \
    --cli-input-json file://anomaly-detection-computation-model-payload.json

ExecuteAction API 페이로드 준비

훈련 및 추론을 실행하는 다음 단계는 ExecuteAction API를 사용하여 수행됩니다. 훈련과 추론 모두 JSON 작업 페이로드 구성으로 구성됩니다. ExecuteAction API를 호출할 때 작업 페이로드를 stringValue페이로드와 함께 값으로 제공해야 합니다.

페이로드는 API 요구 사항을 엄격하게 준수해야 합니다. 특히 값은 제어 문자가 없는 플랫 문자열이어야 합니다(예: 줄 바꿈, 탭 또는 캐리지 리턴). 다음 옵션은 유효한 작업 페이로드를 제공하는 두 가지 신뢰할 수 있는 방법을 제공합니다.

옵션 1: 클린 페이로드 파일 사용

다음 절차에서는 클린 페이로드 파일의 단계를 설명합니다.

  1. 파일을 정리하여 제어 문자를 제거합니다.

    tr -d '\n\r\t' < original-action-payload.json > training-or-inference-action-payload.json

  2. 파일을 사용하여 작업을 실행합니다@=file://....

    aws iotsitewise execute-action \
    --target-resource computationModelId=<MODEL_ID> \
    --action-definition-id <ACTION_DEFINITION_ID> \
    --action-payload stringValue@=file://training-or-inference-action-payload.json

옵션 2: 이스케이프된 따옴표가 있는 인라인 문자열

다음 단계에서는 페이로드를 인라인으로 제공하고 중간 파일을 피하는 단계를 설명합니다.

  • JSON 문자열 내에 이스케이프 처리된 큰따옴표(\")를 사용합니다.

  • 전체 StringValue=.. 표현식을 큰따옴표로 묶습니다.

예 이스케이프된 작업 페이로드의
aws iotsitewise execute-action \
    --target-resource computationModelId=<MODEL_ID> \
    --action-definition-id <ACTION_DEFINITION_ID> \
    --action-payload "stringValue={\"exportDataStartTime\":1717225200,\"exportDataEndTime\":1722789360,\"targetSamplingRate\":\"PT1M\"}"

훈련 AWS CLI

  1. 다음 명령을 실행하여 AWS/ANOMALY_DETECTION_TRAINING 작업의 actionDefinitionId를 찾습니다. 를 이전 단계에서 반환된 IDcomputation-model-id로 바꿉니다.

    aws iotsitewise describe-computation-model \
    --computation-model-id computation-model-id

  2. 라는 파일을 생성하고 다음 값을 anomaly-detection-training-payload.json 추가합니다.

    참고

    페이로드는를 준수해야 합니다옵션 1: 클린 페이로드 파일 사용.

    1. StartTime 에포크 초 단위로 제공되는 훈련 데이터의 시작과 함께 제공됩니다.

    2. EndTime 에포크 초 단위로 제공되는 훈련 데이터가 끝납니다.

    3. 선택적으로를 구성할 수 있습니다고급 추론 구성.

      1. (선택 사항) 및 데이터의 TargetSamplingRate 샘플링 속도.

      2. (선택 사항) 모델 훈련 개선을 위해 비정상적인 동작이 발생한 기간을 LabelInputConfiguration 지정합니다.

      3. (선택 사항) 훈련ModelEvaluationConfiguration이 완료된 후 지정된 시간 범위에서 추론을 실행하여 모델 성능을 평가합니다.

    {
  "exportDataStartTime": StartTime,
  "exportDataEndTime": EndTime
}
    예 훈련 페이로드의 예:
    {
  "exportDataStartTime": 1717225200,
  "exportDataEndTime": 1722789360
}

  3. 다음 명령을 실행하여 훈련을 시작합니다(자산을 대상 리소스로 제공하지 않음). 명령에서 다음 파라미터를 교체합니다.

    aws iotsitewise execute-action \
    --target-resource computationModelId=computation-model-id \
    --action-definition-id training-action-definition-id \
    --action-payload stringValue@=file://anomaly-detection-training-payload.json

  4. 다음 명령을 실행하여 모델 훈련 프로세스의 상태를 확인합니다. 최신 실행 요약에는 실행 상태(RUNNING/COMPLETED/FAILED)가 표시됩니다.

    aws iotsitewise list-executions \
    --target-resource-type COMPUTATION_MODEL \
    --target-resource-id computation-model-id

  5. 다음 명령을 실행하여 훈련된 최신 모델의 구성을 확인합니다. 이 명령은 하나 이상의 모델이 훈련을 성공적으로 완료한 경우에만 출력을 생성합니다.

    aws iotsitewise describe-computation-model-execution-summary \
    --computation-model-id computation-model-id

추론 시작 및 중지(AWS CLI)

모델을 훈련한 후에 AWS IoT SiteWise 산업 자산의 이상 모니터링을 시작하도록 지시하는 추론을 시작합니다.

추론 시작

  1. 다음 명령을 실행하여 AWS/ANOMALY_DETECTION_INFERENCE 작업의 actionDefinitionId를 찾습니다. 를 이전에 생성한 계산 모델의 실제 IDcomputation-model-id로 바꿉니다.

    aws iotsitewise describe-computation-model \
    --computation-model-id computation-model-id

  2. 파일을 anomaly-detection-start-inference-payload.json 생성하고 다음 코드를 추가합니다. 설명된 대로 다음 파라미터를 바꿉니다.

    참고

    페이로드는를 준수해야 합니다옵션 1: 클린 페이로드 파일 사용.

    1. DataUploadFrequency: 이상 탐지를 수행하기 위해 추론 일정이 실행되는 빈도를 구성합니다. 허용되는 값은 PT5M, PT10M, PT15M, PT30M, PT1H, PT2H..PT12H, PT1D입니다.

      "inferenceMode": "START",
"dataUploadFrequency": "DataUploadFrequency"

    2. (선택 사항) 지연 오프셋을 분 단위로 DataDelayOffsetInMinutes 표시합니다. 이 값을 0~60분으로 설정합니다.

    3. (선택 사항)를 활성화할 모델 버전과 TargetModelVersion 함께 사용합니다.

    4. (선택 사항) 교대 근무 구성weeklyOperatingWindow으로를 구성합니다.

    5. 선택적으로를 구성할 수 있습니다고급 추론 구성.

      1. 고주파 추론(5분~1시간).

      2. 낮은 빈도의 추론(2시간~1일).

      3. 유연한 예약.

  3. 다음 명령을 실행하여 추론을 시작합니다. 페이로드 파일에서 다음 파라미터를 바꿉니다.

    1. computation-model-id를 대상 계산 모델의 ID로 바꿉니다.

    2. inference-action-definition-id를 1단계의 AWS/ANOMALY_DETECTION_INFERENCE 작업 ID로 바꿉니다.

    aws iotsitewise execute-action \
    --target-resource computationModelId=computation-model-id \
    --action-definition-id inference-action-definition-id \
    --action-payload stringValue@=file://anomaly-detection-inference-payload.json

  4. 다음 명령을 실행하여 추론이 아직 실행 중인지 확인합니다. 추론이 활성화TRUE되면 inferenceTimerActive 필드가 로 설정됩니다.

    aws iotsitewise describe-computation-model-execution-summary \
    --computation-model-id computation-model-id

  5. 다음 명령은 모든 추론 실행을 나열합니다.

    aws iotsitewise list-executions \
    --target-resource-type COMPUTATION_MODEL \
    --target-resource-id computation-model-id

  6. 다음 명령을 실행하여 개별 실행을 설명합니다. 를 이전 5단계의 IDexecution-id로 바꿉니다.

    aws iotsitewise describe-execution \
    --execution-id execution-id

추론 중지

  1. 다음 명령을 실행하여 AWS/ANOMALY_DETECTION_INFERENCE 작업의 actionDefinitionId를 찾습니다. 를 이전에 생성한 계산 모델의 실제 IDcomputation-model-id로 바꿉니다.

    aws iotsitewise describe-computation-model \
    --computation-model-id computation-model-id

  2. 파일을 anomaly-detection-stop-inference-payload.json 생성하고 다음 코드를 추가합니다.

    {
    "inferenceMode": "STOP"
}
    참고

    페이로드는를 준수해야 합니다옵션 1: 클린 페이로드 파일 사용.

  3. 다음 명령을 실행하여 추론을 중지합니다. 페이로드 파일에서 다음 파라미터를 바꿉니다.

    1. computation-model-id를 대상 계산 모델의 ID로 바꿉니다.

    2. inference-action-definition-id를 1단계의 AWS/ANOMALY_DETECTION_INFERENCE 작업 ID로 바꿉니다.

    예 추론 중지 명령의 :
    aws iotsitewise execute-action \
--target-resource computationModelId=computation-model-id \
--action-definition-id inference-action-definition-id \
--action-payload stringValue@=file://anomaly-detection-stop-inference-payload.json