Amazon CloudWatch Events를 사용하여 모니터링 - AWS IoT Analytics

지원 종료 알림: 2025년 12월 15일에 AWS 에 대한 지원이 종료됩니다 AWS IoT Analytics. 2025년 12월 15일 이후에는 AWS IoT Analytics 콘솔 또는 AWS IoT Analytics 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은 AWS IoT Analytics 지원 종료를 참조하세요.

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

Amazon CloudWatch Events를 사용하여 모니터링

AWS IoT Analytics 는 AWS Lambda 활동 중에 런타임 오류가 발생하면 Amazon CloudWatch Events에 이벤트를 자동으로 게시합니다. 이 이벤트에는 자세한 오류 메시지와 처리되지 않은 채널 메시지를 저장하는 Amazon Simple Storage Service(S3) 객체의 키가 포함되어 있습니다. Amazon S3 키를 사용하여 처리되지 않은 채널 메시지를 재처리할 수 있습니다. 자세한 내용은 채널 메시지 재처리, AWS IoT Analytics API 참조의 StartPipelineReprocessing API, Amazon CloudWatch Events 사용 설명서의 Amazon CloudWatch Events는 무엇입니까?를 참조하십시오.

또한 Amazon CloudWatch Events가 알림을 보내거나 추가 조치를 취할 수 있도록 대상을 구성할 수 있습니다. 예를 들어 Amazon Simple Queue Service(Amazon SQS) 대기열에 알림을 보낸 다음 StartReprocessingMessage API를 간접 호출하여 Amazon S3 객체에 저장된 채널 메시지를 처리할 수 있습니다. Amazon CloudWatch Events는 다음과 같은 다양한 유형의 대상을 지원합니다.

  • Amazon Kinesis 스트림

  • AWS Lambda 함수

  • Amazon Simple Notification Service(Amazon SNS) 주제

  • Amazon Simple Queue Service(Amazon SQS) 대기열

지원되는 대상에 대한 자세한 정보는 Amazon EventBridge 사용 설명서의 Amazon EventBridge 대상을 참조하십시오.

CloudWatch Events 리소스와 관련 대상은 AWS IoT Analytics 리소스를 생성한 AWS 리전에 있어야 합니다. 자세한 내용은 AWS 일반 참조의 서비스 엔드포인트 및 할당량을 참조하십시오.

AWS Lambda 활동의 런타임 오류에 대해 Amazon CloudWatch Events로 전송되는 알림은 다음 형식을 사용합니다.

{
    "version": "version-id",
    "id": "event-id",
    "detail-type": "IoT Analytics Pipeline Failure Notification",
    "source": "aws.iotanalytics",
    "account": "aws-account",
    "time": "timestamp",
    "region": "aws-region",
    "resources": [
        "pipeline-arn"
    ],
    "detail": {
        "event-detail-version": "1.0",
        "pipeline-name": "pipeline-name",
        "error-code": "LAMBDA_FAILURE",
        "message": "error-message",
        "channel-messages": {
            "s3paths": [
                "s3-keys"
            ]
        },
        "activity-name": "lambda-activity-name",
        "lambda-function-arn": "lambda-function-arn"
    }
}

알림 예제:

{
    "version": "0",
    "id": "204e672e-ef12-09af-4cfd-de3b53673ec6",
    "detail-type": "IoT Analytics Pipeline Failure Notification",
    "source": "aws.iotanalytics",
    "account": "123456789012",
    "time": "2020-10-15T23:47:02Z",
    "region": "ap-southeast-2",
    "resources": [
        "arn:aws:iotanalytics:ap-southeast-2:123456789012:pipeline/test_pipeline_failure"
    ],
    "detail": {
        "event-detail-version": "1.0",
        "pipeline-name": "test_pipeline_failure",
        "error-code": "LAMBDA_FAILURE",
        "message": "Temp unavaliable",
        "channel-messages": {
        "s3paths": [
            "test_pipeline_failure/channel/cmr_channel/__dt=2020-10-15 00:00:00/1602805530000_1602805560000_123456789012_cmr_channel_0_257.0.json.gz"
        ]
    },
    "activity-name": "LambdaActivity_33",
    "lambda-function-arn": "arn:aws:lambda:ap-southeast-2:123456789012:function:lambda_activity"
    }
}