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

Métricas de CloudWatch

La acción CloudWatch metric (cloudwatchMetric) captura una métrica de Amazon CloudWatch. 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 rol de IAM que AWS IoT puede asumir para realizar la operación cloudwatch:PutMetricData. Para obtener más información, consulte Otorgar a una regla AWS IoT el acceso que requiere.

    En la consola de AWS IoT, puede elegir o crear un rol que permita a AWS IoT realizar esta acción de regla.

Parámetros

Cuando cree una regla AWS IoT con esta acción, debe especificar la información siguiente:

metricName

El nombre de la métrica de CloudWatch.

Admite plantillas de sustitución: Sí

metricNamespace

El nombre del espacio de nombres de la métrica de CloudWatch.

Admite plantillas de sustitución: Sí

metricUnit

La unidad métrica compatible con CloudWatch.

Admite plantillas de sustitución: Sí

metricValue

Una cadena que contiene el valor de la métrica de CloudWatch.

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 rol de IAM que permite el acceso a la métrica de CloudWatch. Para obtener más información, consulte Requisitos.

Admite plantillas de sustitución: No

Ejemplos

El siguiente ejemplo JSON define una acción de métrica de CloudWatch en una regla 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"
                }
            }
        ]
    }
}

El siguiente ejemplo JSON define una acción métrica de CloudWatch con plantillas de sustitución en una regla AWS IoT.

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