错误处理（错误操作） - AWS IoT Core
错误操作消息格式错误操作示例

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

错误处理（错误操作）

当 AWS IoT 收到来自设备的消息时，规则引擎会检查该消息是否符合规则。如果匹配，将评估规则的查询语句，并激活规则的操作，同时传递查询语句的结果。

如果在激活操作时出现问题，则在为规则指定了错误操作的情况下，规则引擎将激活该错误操作。这可能在以下情况下发生：

  • 规则没有权限访问 Amazon S3 存储桶。

  • 用户错误导致超过 DynamoDB 预置吞吐量。

注意

本主题中介绍的错误处理适用于规则操作。要调试SQL问题，包括外部函数，可以设置 AWS IoT 日志记录。有关更多信息，请参阅 配置 AWS IoT 日志。

错误操作消息格式

对于每个规则和每条消息，会生成一条消息。例如，如果同一个规则中的两个规则操作失败，则错误操作将收到包含这两项错误的一条消息。

错误操作消息示例如下所示。

{
  "ruleName": "TestAction",
  "topic": "testme/action",
  "cloudwatchTraceId": "7e146a2c-95b5-6caf-98b9-50e3969734c7",
  "clientId": "iotconsole-1511213971966-0",
  "base64OriginalPayload": "ewogICJtZXNzYWdlIjogIkhlbGxvIHZyb20gQVdTIElvVCBjb25zb2xlIgp9",
  "failures": [
    {
      "failedAction": "S3Action",
      "failedResource": "us-east-1-s3-verify-user",
      "errorMessage": "Failed to put S3 object. The error received was The specified bucket does not exist (Service: Amazon S3; Status Code: 404; Error Code: NoSuchBucket; Request ID: 9DF5416B9B47B9AF; S3 Extended Request ID: yMah1cwPhqTH267QLPhTKeVPKJB8BO5ndBHzOmWtxLTM6uAvwYYuqieAKyb6qRPTxP1tHXCoR4Y=). Message arrived on: error/action, Action: s3, Bucket: us-east-1-s3-verify-user, Key: \"aaa\". Value of x-amz-id-2: yMah1cwPhqTH267QLPhTKeVPKJB8BO5ndBHzOmWtxLTM6uAvwYYuqieAKyb6qRPTxP1tHXCoR4Y="
    }
  ]
}
ruleName

触发错误操作的规则的名称。

topic

收到原始消息的主题。

cloudwatchTraceId

引用错误的唯一标识登录 CloudWatch。

clientId

消息发布程序的客户端 ID。

base64 OriginalPayload

Base64 编码的原始消息负载。

failures
failedAction

无法完成的操作的名称（例如，“S3Action”）。

failedResource

资源的名称（例如 S3 存储桶的名称）。

errorMessage

错误的描述和说明。

错误操作示例

下面是一个具有添加的错误操作的规则示例。以下规则具有将消息数据写入 DynamoDB 表的操作，以及将数据写入 Amazon S3 存储桶的错误操作：

{
    "sql" : "SELECT * FROM ..."
    "actions" : [{ 
        "dynamoDB" : {
            "table" : "PoorlyConfiguredTable",
            "hashKeyField" : "AConstantString",
            "hashKeyValue" : "AHashKey"}}
    ],
    "errorAction" : { 
        "s3" : {
            "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3",
            "bucketName" : "message-processing-errors",
            "key" : "${replace(topic(), '/', '-') + '-' + timestamp() + '-' + newuuid()}"
        }
    }
}

您可以在错误操作的SQL语句中使用任何函数或替换模板，包括外部函数：aws_lambda()get_dynamodb()、get_thing_shadow()、get_secret()、machinelearning_predict()、和decode()。如果错误操作需要调用外部函数，则调用错误操作可能会导致产生针对外部函数的额外账单。

以下外部函数的计费方式等同于规则操作：aws_lambda、get_dynamodb() 和 get_thing_shadow()。仅当你将 P rotobuf 消息解码到时，你才需要为该decode()函数付费。JSON有关更多详细信息，请参考 AWS IoT Core 定价页面。

有关规则以及如何指定错误操作的更多信息，请参阅创建 AWS IoT 规则。

有关使用 CloudWatch 监控规则成功或失败的更多信息，请参阅AWS IoT 指标和维度。