CloudWatch 指标

PDF

聚焦模式

CloudWatch 指标 - AWS IoT Core

要求参数示例另请参阅

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

要求

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

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

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

参数

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

metricName

CloudWatch 指标名称。

支持替换模板：是

metricNamespace

CloudWatch 指标命名空间名称。

支持替换模板：是

metricUnit

支持的公制单位 CloudWatch。

支持替换模板：是

metricValue

包含 CloudWatch 指标值的字符串。

支持替换模板：是

metricTimestamp

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

支持替换模板：是

roleArn

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

支持替换模板：否

示例

以下JSON示例定义了 AWS 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示例定义了在 AWS 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"
                }
            }
        ]
    }
}