Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
La acción CloudWatch metric (cloudwatchMetric) captura una CloudWatch métrica de Amazon. Puede especificar el espacio de nombres, el nombre, el valor, la unidad y la marca de tiempo de la métrica.
Requisitos
Esta regla tiene los siguientes requisitos:
-
Un IAM rol que AWS IoT se puede asumir al realizar la
cloudwatch:PutMetricDataoperación. Para obtener más información, consulte Otorgar a una AWS IoT regla el acceso que requiere.En la AWS IoT consola, puede elegir o crear un rol que permita AWS IoT realizar esta acción de regla.
Parámetros
Al crear una AWS IoT regla con esta acción, debe especificar la siguiente información:
metricName-
El nombre de la CloudWatch métrica.
Admite plantillas de sustitución: Sí
metricNamespace-
El nombre del espacio de nombres de la CloudWatch métrica.
Admite plantillas de sustitución: Sí
metricUnit-
La unidad métrica admitida por. CloudWatch
Admite plantillas de sustitución: Sí
metricValue-
Cadena que contiene el valor CloudWatch métrico.
Admite plantillas de sustitución: Sí
metricTimestamp-
(Opcional) Una cadena que contiene la marca de tiempo, expresada en segundos en tiempo de época Unix. El valor predeterminado es la época actual de Unix.
Admite plantillas de sustitución: Sí
roleArn-
El IAM rol que permite el acceso a la CloudWatch métrica. Para obtener más información, consulte Requisitos.
Admite plantillas de sustitución: No
Ejemplos
El siguiente JSON ejemplo define una acción CloudWatch métrica en una AWS IoT regla.
{
"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"
}
}
]
}
}En el siguiente JSON ejemplo, se define una acción CloudWatch métrica con plantillas de sustitución en una AWS IoT regla.
{
"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"
}
}
]
}
}Véase también
-
¿Qué es Amazon CloudWatch? en la Guía del CloudWatch usuario de Amazon
-
Uso de CloudWatch las métricas de Amazon en la Guía del CloudWatch usuario de Amazon
