使用 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 (Amazon S3) 物件金鑰。您可以使用 Amazon S3 金鑰來重新處理未處理的頻道訊息。如需詳細資訊，請參閱 重新處理頻道訊息中的 StartPipelineReprocessing AWS IoT Analytics 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 Streams

  • AWS Lambda 函數

  • Amazon Simple Notification Service (Amazon SNS) 主題

  • Amazon Simple Queue Service (Amazon SQS) 佇列

如需支援的目標清單，請參閱《Amazon EventBridge 使用者指南》中的 Amazon EventBridge 目標。 EventBridge

您的 CloudWatch Events 資源和相關聯的目標必須位於您建立 AWS IoT Analytics 資源的 AWS 區域中。如需詳細資訊，請參閱《AWS 一般參考》中的服務端點和配額。

傳送至 Amazon CloudWatch Events 的 通知在 AWS Lambda 活動中出現執行時間錯誤，會使用下列格式。

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