CloudWatch métricas - AWS IoT Core
RequisitosParámetrosEjemplosVéase también

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.

CloudWatch métricas

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:

  • Una función de IAM que AWS IoT puede asumir para realizar la cloudwatch:PutMetricData operació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

La función de IAM 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 ejemplo de JSON 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"
                }
            }
        ]
    }
}

El siguiente ejemplo de JSON 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