CloudWatch 度量

指 CloudWatch 標 (cloudwatchMetric) 動作會擷取 Amazon CloudWatch 指標。您可以指定指標命名空間、名稱、值、單位、時間戳記。

要求

此規則動作具有下列需求：

• AWS IoT 可假設執行cloudwatch:PutMetricData作業的 IAM 角色。如需詳細資訊，請參閱 授與 AWS IoT 規則所需的存取權。

  在 AWS IoT 主控台中，您可以選擇或建立允許 AWS IoT 執行此規則動作的角色。

參數

使用此動作建立 AWS IoT 規則時，必須指定下列資訊：

metricName

CloudWatch 測量結果名稱。

支援替代範本：是

metricNamespace

CloudWatch 測量結果命名空間名稱。

支援替代範本：是

metricUnit

支援的公制單位 CloudWatch。

支援替代範本：是

metricValue

包含 CloudWatch 測量結果值的字串。

支援替代範本：是

metricTimestamp

(選用) 包含 Unix epoch 時間中時間戳記 (以秒為單位來表達) 的字串。預設為目前的 Unix epoch 時間。

支援替代範本：是

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

另請參閱

• 什麼是 Amazon CloudWatch？ 在 Amazon 用 CloudWatch 戶指南

• 在 Amazon 用戶指南中使 CloudWatch 用 Amazon 指 CloudWatch標