CloudWatch 지표 - AWS IoT Core
요구 사항파라미터예시다음 사항도 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CloudWatch 지표

CloudWatch 지표(cloudwatchMetric) 작업은 Amazon CloudWatch 지표를 캡처합니다. 지표 네임스페이스, 이름, 값 및 타임스탬프를 지정할 수 있습니다.

요구 사항

이 규칙 작업은 다음 요구 사항을 충족해야 합니다.

  • cloudwatch:PutMetricData 작업을 수행하기 위해 수임할 AWS IoT 수 있는 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 예제에서는 규칙에서 CloudWatch AWS IoT 지표 작업을 정의합니다.

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

다음 사항도 참조하세요.