CloudWatch métriques - AWS IoT Core
PrérequisParamètresExemplesConsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CloudWatch métriques

L'action CloudWatch metric (cloudwatchMetric) capture une CloudWatch métrique Amazon. Vous pouvez spécifier le namespace, le nom, la valeur, l'unité et l'horodatage de la métrique.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • Rôle IAM qui AWS IoT peut assumer la réalisation de l'cloudwatch:PutMetricDataopération. Pour plus d’informations, consultez Accorder à une AWS IoT règle l'accès dont elle a besoin.

    Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.

Paramètres

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

metricName

Le nom CloudWatch de la métrique.

Prend en charge les modèles de substitution : Oui

metricNamespace

Le nom de l'espace de noms de la CloudWatch métrique.

Prend en charge les modèles de substitution : Oui

metricUnit

L'unité métrique prise en charge par CloudWatch.

Prend en charge les modèles de substitution : Oui

metricValue

Chaîne contenant la valeur de la CloudWatch métrique.

Prend en charge les modèles de substitution : Oui

metricTimestamp

(Facultatif) Chaîne de caractères contenant l'horodatage, exprimé en secondes dans l'heure Unix. La valeur par défaut est l'époque Unix actuelle.

Prend en charge les modèles de substitution : Non

roleArn

Rôle IAM qui permet d'accéder à la CloudWatch métrique. Pour plus d’informations, consultez Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

L'exemple JSON suivant définit une action CloudWatch métrique dans une AWS IoT règle.

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

L'exemple JSON suivant définit une action CloudWatch métrique avec des modèles de substitution dans une AWS IoT règle.

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

Consultez aussi