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 Journaux

L'action CloudWatch Logs (cloudwatchLogs) envoie des données à Amazon CloudWatch Logs. Vous pouvez l'utiliser batchMode pour télécharger et horodater plusieurs enregistrements du journal de l'appareil dans un seul message. Vous pouvez spécifier le groupe de journaux auquel l'action envoie des données.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

MQTTexigences relatives au format des messages pour batchMode

Si vous utilisez l'action Règle de CloudWatch journalisation alors que vous êtes batchMode désactivée, aucune exigence de formatage des MQTT messages n'est requise. (Remarque : la valeur par défaut du paramètre batchMode est false.) Toutefois, si vous utilisez l'action Règle CloudWatch Logs en activant batchMode (la valeur du paramètre esttrue), les MQTT messages contenant des journaux côté appareil doivent être formatés pour contenir un horodatage et une charge utile de message. Remarque : timestamp représente l'heure à laquelle l'événement s'est produit et est exprimée en millisecondes après le 1er janvier 1970 00:00:00 UTC

Voici un exemple de format de publication :

[
  {"timestamp": 1673520691093, "message": "Test message 1"}, 
  {"timestamp": 1673520692879, "message": "Test message 2"}, 
  {"timestamp": 1673520693442, "message": "Test message 3"}
]

Selon la façon dont les journaux côté appareil sont générés, il peut être nécessaire de les filtrer et de les reformater avant d'être envoyés afin de respecter cette exigence. Pour plus d'informations, consultez la section Charge utile des MQTT messages.

Quel que soit le batchMode paramètre, message le contenu doit respecter les limites de taille des AWS IoT messages. Pour plus d’informations, consultez Points de terminaison et quotas AWS IoT Core.

Paramètres

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

Exemples

L'JSONexemple suivant définit une action CloudWatch Logs dans une AWS IoT règle.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "cloudwatchLogs": {
                    "logGroupName": "IotLogs",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw",
                    "batchMode": false                    
                }
            }
        ]
    }
}

Consultez aussi