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

CloudWatch 指标

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

Requirements

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

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

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

Parameters

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

metricName

CloudWatch 指标名称。

支持替换模板:是

metricNamespace

CloudWatch 指标命名空间名称。

支持替换模板:是

metricUnit

CloudWatch 支持的指标单位。

支持替换模板:是

metricValue

包含 CloudWatch 指标值的字符串。

支持替换模板:是

metricTimestamp

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

支持替换模板:是

roleArn

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

支持替换模板:否

Examples

下面的 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" } } ] } }

另请参阅