Configuration des CloudWatch journaux pour les OTA mises à jour - Gratuit RTOS
Créer un rôle de journalisation et activer la journalisationOTAjournaux de mise à jour

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.

Configuration des CloudWatch journaux pour les OTA mises à jour

Le service OTA Update prend en charge la journalisation avec Amazon CloudWatch. Vous pouvez utiliser la AWS IoT console pour activer et configurer la CloudWatch journalisation Amazon pour les OTA mises à jour. Pour plus d'informations sur consultez Cloudwatch Logs.

Pour activer la journalisation, vous devez créer un IAM rôle et configurer la journalisation des OTA mises à jour.

Note

Avant d'activer la journalisation des OTA mises à jour, assurez-vous de bien comprendre les autorisations d'accès aux CloudWatch journaux. Les utilisateurs ayant accès aux CloudWatch journaux peuvent voir vos informations de débogage. Pour plus d'informations, consultez Authentification et contrôle d'accès pour Amazon CloudWatch Logs.

Créer un rôle de journalisation et activer la journalisation

Utilisez la console AWS IoT pour créer un rôle de journalisation et activer la journalisation.

  1. Choisissez Paramètres dans le volet de navigation.

  2. Sous Journaux, choisissez Modifier.

  3. Sous Niveau de détail, choisissez Déboguer.

  4. Sous Définir le rôle, choisissez Créer un nouveau rôle pour créer un IAM rôle pour la journalisation.

  5. Sous Nom, saisissez un nom unique pour votre rôle. Votre rôle sera créé avec toutes les autorisations requises.

  6. Choisissez Mettre à jour.

OTAjournaux de mise à jour

Le service de OTA mise à jour publie des journaux sur votre compte lorsque l'une des situations suivantes se produit :

  • Une OTA mise à jour est créée.

  • Une OTA mise à jour est terminée.

  • Une tâche de signature de code est créée.

  • Une tâche de signature de code est terminée.

  • Un AWS IoT emploi est créé.

  • Une AWS IoT tâche est terminée.

  • Un flux est créé.

Vous pouvez consulter vos journaux dans la CloudWatch console.

Pour consulter une OTA mise à jour dans CloudWatch Logs

  1. Dans le volet de navigation, choisissez Logs (Journaux).

  2. Dans Log Groups, sélectionnez AWSIoTLogsV2.

OTAles journaux de mise à jour peuvent contenir les propriétés suivantes :

accountId

L'identifiant du AWS compte sous lequel le journal a été généré.

actionType

L'action qui a généré le journal. Cette propriété peut avoir l'une des valeurs suivantes :

  • CreateOTAUpdate: Une OTA mise à jour a été créée.

  • DeleteOTAUpdate: une OTA mise à jour a été supprimée.

  • StartCodeSigning : une tâche de signature de code a été démarrée.

  • CreateAWSJob: Un AWS IoT emploi a été créé.

  • CreateStream : un flux a été créé.

  • GetStream: une demande de flux a été envoyée à la fonctionnalité de livraison de fichiers AWS IoT MQTT basée.

  • DescribeStream: une demande d'informations sur un flux a été envoyée à la fonctionnalité de livraison de fichiers AWS IoT MQTT basée.

awsJobId

ID de AWS IoT tâche qui a généré le journal.

clientId

L'ID du MQTT client à l'origine de la demande qui a généré le journal.

clientToken

Le jeton client associé à la demande ayant généré le journal.

détails

Informations supplémentaires sur l'opération ayant généré le journal.

logLevel

Niveau de journalisation du journal. Pour les journaux de OTA mise à jour, ce paramètre est toujours défini surDEBUG.

otaUpdateId

ID de la OTA mise à jour qui a généré le journal.

protocole ;

Protocole utilisé pour effectuer la demande ayant généré le journal.

status

Statut de l'opération ayant généré le journal. Les valeurs valides sont :

  • Réussite

  • Échec

streamId

L'ID du AWS IoT flux qui a généré le journal.

timestamp

Heure à laquelle le journal a été généré.

topicName

MQTTRubrique utilisée pour effectuer la demande qui a généré le journal.

Exemples de journaux

Voici un exemple de journal généré lorsqu'une tâche de signature de code est démarrée :

{ 
    "timestamp": "2018-07-23 22:59:44.955", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "StartCodeSigning", 
    "otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "details": "Start code signing job. The request status is SUCCESS." 
}

Voici un exemple de journal généré lors de la création AWS IoT d'une tâche :

{ 
    "timestamp": "2018-07-23 22:59:45.363", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "CreateAWSJob", 
    "otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "awsJobId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "details": "Create AWS Job The request status is SUCCESS." 
}

Voici un exemple de journal généré lors de la création d'une OTA mise à jour :

{ 
    "timestamp": "2018-07-23 22:59:45.413", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "CreateOTAUpdate", 
    "otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "details": "OTAUpdate creation complete. The request status is SUCCESS." 
}

Voici un exemple de journal généré lorsqu'un flux est créé :

{ 
    "timestamp": "2018-07-23 23:00:26.391", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "CreateStream", 
    "otaUpdateId": "3d3dc5f7-3d6d-47ac-9252-45821ac7cfb0", 
    "streamId": "6be2303d-3637-48f0-ace9-0b87b1b9a824", 
    "details": "Create stream. The request status is SUCCESS." 
}

Voici un exemple de journal généré lorsqu'une OTA mise à jour est supprimée :

{ 
    "timestamp": "2018-07-23 23:03:09.505", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "DeleteOTAUpdate", 
    "otaUpdateId": "9bdd78fb-f113-4001-9675-1b595982292f", 
    "details": "Delete OTA Update. The request status is SUCCESS." 
}

Voici un exemple de journal généré lorsqu'un appareil demande un flux à partir de la fonctionnalité de livraison de fichiers MQTT basée :

{ 
    "timestamp": "2018-07-25 22:09:02.678", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "GetStream", 
    "protocol": "MQTT", 
    "clientId": "b9d2e49c-94fe-4ed1-9b07-286afed7e4c8", 
    "topicName": "$aws/things/b9d2e49c-94fe-4ed1-9b07-286afed7e4c8/streams/1e51e9a8-9a4c-4c50-b005-d38452a956af/get/json", 
    "streamId": "1e51e9a8-9a4c-4c50-b005-d38452a956af", 
    "details": "The request status is SUCCESS." 
}

Voici un exemple de journal généré lorsqu'un appareil appelle le DescribeStream API :

{ 
    "timestamp": "2018-07-25 22:10:12.690", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "DescribeStream", 
    "protocol": "MQTT", 
    "clientId": "581075e0-4639-48ee-8b94-2cf304168e43", 
    "topicName": "$aws/things/581075e0-4639-48ee-8b94-2cf304168e43/streams/71c101a8-bcc5-4929-9fe2-af563af0c139/describe/json", 
    "streamId": "71c101a8-bcc5-4929-9fe2-af563af0c139", 
    "clientToken": "clientToken", 
    "details": "The request status is SUCCESS." 
}