CloudWatch 指标 - Amazon IoT Core
要求参数示例另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

CloudWatch 指标

CloudWatch 指标 (cloudwatchMetric) 操作捕获亚马逊 CloudWatch指标。您可以指定指标命名空间、名称、值、单位和时间戳。

要求

此规则操作具有以下要求：

  • Amazon IoT 可以承担以执行 cloudwatch:PutMetricData 操作的 IAM 角色。有关更多信息，请参阅向 Amazon IoT 规则授予所需的访问权限：

    在 Amazon IoT 控制台中，您可以选择或创建一个角色以允许 Amazon IoT 执行此规则操作。

参数

使用此操作创建 Amazon IoT 规则时，您必须指定以下信息：

metricName

CloudWatch 指标名称。

支持替换模板：是

metricNamespace

CloudWatch 指标命名空间名称。

支持替换模板：是

metricUnit

支持的公制单位 CloudWatch。

支持替换模板：是

metricValue

包含 CloudWatch 指标值的字符串。

支持替换模板：是

metricTimestamp

（可选）包含用 Unix 纪元时间表示的 timestamp（以秒为单位）的字符串。默认为当前 Unix 纪元时间。

支持替换模板：是

roleArn

允许访问 CloudWatch 指标的 IM 角色。有关更多信息，请参阅要求：

支持替换模板：否

示例

下面的 JSON 示例定义了Amazon IoT规则中的 CloudWatch 指标操作。

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "cloudwatchMetric": {
                    "metricName": "IotMetric",
                    "metricNamespace": "IotNamespace", 
                    "metricUnit": "Count",
                    "metricValue": "1",
                    "metricTimestamp": "1456821314",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw"
                }
            }
        ]
    }
}

下面的 JSON 示例定义了一个在Amazon IoT规则中带有替代模板的 CloudWatch 指标操作。

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "cloudwatchMetric": {
                    "metricName": "${topic()}",
                    "metricNamespace": "${namespace}",
                    "metricUnit": "${unit}",
                    "metricValue": "${value}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw"
                }
            }
        ]
    }
}

另请参阅