CloudWatch Enregistre les entrées du AWS IoT journal - AWS IoT Core
Entrées du journal du courtier de messagesEntrées du journal OCSP du certificat de serveurEntrées de journal de shadow d'appareilEntrées de journal du moteur de règlesEntrées du journal des tâchesEntrées de journal de provisionnement des appareilsEntrées dynamiques du journal des groupes d'objetsEntrées du journal d'indexation de la flotteAttributs communs CloudWatch des journaux

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 Enregistre les entrées du AWS IoT journal

Chaque composant de AWS IoT génère ses propres entrées de journal. Chaque entrée de journal a un eventType qui spécifie l'opération ayant provoqué la génération de l'entrée de journal. Cette section décrit les entrées de journal générées par les AWS IoT composants suivants :

Entrées du journal du courtier de messages

Le courtier de AWS IoT messages génère des entrées de journal pour les événements suivants :

Connexion de l'entrée de journal

Le courtier de AWS IoT messages génère une entrée de journal avec un « eventType of » Connect lorsqu'un client MQTT se connecte.

Exemple d'entrée de journal de connexion

{
    "timestamp": "2017-08-10 15:37:23.476",
    "logLevel": "INFO",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Connect",
    "protocol": "MQTT",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal Connect contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

principalId

L'ID du mandataire formulant la demande.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

sourceIp

L'adresse IP d'origine de la demande.

sourcePort

Le port d'origine de la demande.

Déconnecter l'entrée du journal

Le courtier de AWS IoT messages génère une entrée de journal avec un « eventType of » Disconnect lorsqu'un client MQTT se déconnecte.

Exemple d'entrée de journal de déconnexion

{
    "timestamp": "2017-08-10 15:37:23.476",
    "logLevel": "INFO",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Disconnect",
    "protocol": "MQTT",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490,
    "reason": "DUPLICATE_CLIENT_ID",
    "details": "A new connection was established with the same client ID",
    "disconnectReason": "CLIENT_INITIATED_DISCONNECT"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal Disconnect contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

principalId

L'ID du mandataire formulant la demande.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

sourceIp

L'adresse IP d'origine de la demande.

sourcePort

Le port d'origine de la demande.

raison

La raison pour laquelle le client se déconnecte.

détails

Une brève explication de l'erreur.

disconnectReason

La raison pour laquelle le client se déconnecte.

GetRetainedMessage entrée dans le journal

Le courtier de AWS IoT messages génère une entrée de journal avec un eventType GetRetainedMessagede GetRetainedMessage when.

GetRetainedMessage exemple de saisie de journal

{
    "timestamp": "2017-08-07 18:47:56.664", 
    "logLevel": "INFO", 
    "traceId": "1a60d02e-15b9-605b-7096-a9f584a6ad3f", 
    "accountId": "123456789012", 
    "status": "Success", 
    "eventType": "GetRetainedMessage", 
    "protocol": "HTTP",
    "topicName": "a/b/c",
    "qos": "1",
    "lastModifiedDate": "2017-08-07 18:47:56.664"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal GetRetainedMessage contiennent les attributs suivants :

dernier ModifiedDate

Date et heure de l'époque, en millisecondes, auxquelles le message conservé a été stocké par. AWS IoT

protocole ;

Protocole utilisé pour effectuer la demande. Valeur valide : HTTP.

qos

Le niveau de Qualité de Service (QoS) utilisé dans la demande de publication. Les valeurs valides sont 0 ou 1.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

ListRetainedMessage entrée dans le journal

Le courtier de AWS IoT messages génère une entrée de journal avec un eventType ListRetainedMessagesde ListRetainedMessage when.

ListRetainedMessage exemple de saisie de journal

{
    "timestamp": "2017-08-07 18:47:56.664", 
    "logLevel": "INFO", 
    "traceId": "1a60d02e-15b9-605b-7096-a9f584a6ad3f", 
    "accountId": "123456789012", 
    "status": "Success", 
    "eventType": "ListRetainedMessage", 
    "protocol": "HTTP"
}

En plus de Attributs communs CloudWatch des journaux, ListRetainedMessage les entrées de journal contiennent les attributs suivants :

protocole ;

Protocole utilisé pour effectuer la demande. Valeur valide : HTTP.

Entrée de journal Publish-In

Lorsque le courtier de AWS IoT messages reçoit un message MQTT, il génère une entrée de journal avec un eventType dePublish-In.

Exemple d'entrée de journal Publish-In

{
        "timestamp": "2017-08-10 15:39:30.961",
        "logLevel": "INFO",
        "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
        "accountId": "123456789012",
        "status": "Success",
        "eventType": "Publish-In",
        "protocol": "MQTT",
        "topicName": "$aws/things/MyThing/shadow/get",
        "clientId": "abf27092886e49a8a5c1922749736453",
        "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
        "sourceIp": "205.251.233.181",
        "sourcePort": 13490,
        "retain": "True"
    }

En plus de Attributs communs CloudWatch des journaux, les entrées de journal Publish-In contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

principalId

L'ID du mandataire formulant la demande.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

retain

Attribut utilisé lorsque l'indicateur RETAIN est défini sur un message avec la valeur de True. Si l'indicateur RETAIN n'est pas activé sur le message, cet attribut n'apparaît pas dans l'entrée du journal. Pour plus d’informations, consultez MQTT a retenu les messages.

sourceIp

L'adresse IP d'origine de la demande.

sourcePort

Le port d'origine de la demande.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

Entrée du journal Publish-Out

Lorsque le courtier de messages publie un message MQTT, il génère une entrée de journal avec un eventType de Publish-Out

Exemple d'entrée de journal Publish-Out

{
    "timestamp": "2017-08-10 15:39:30.961",
    "logLevel": "INFO",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Publish-Out",
    "protocol": "MQTT",
    "topicName": "$aws/things/MyThing/shadow/get",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal Publish-Out contiennent les attributs suivants :

clientId

L'ID du client abonné qui reçoit des messages sur ce sujet MQTT.

principalId

L'ID du mandataire formulant la demande.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

sourceIp

L'adresse IP d'origine de la demande.

sourcePort

Le port d'origine de la demande.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

Entrée de journal en file d'attente

Lorsqu'un appareil doté d'une session persistante est déconnecté, le courtier de messages MQTT stocke les messages du périphérique et AWS IoT génère des entrées de journal avec un Queued EventType de. Pour de plus amples informations sur les session persistantes MQTT, veuillez consulter Sessions permanentes MQTT.

Exemple d'entrée dans le journal des erreurs d'un serveur en file d'attente

{
    "timestamp": "2022-08-10 15:39:30.961",
    "logLevel": "ERROR",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "topicName": "$aws/things/MyThing/get",
    "clientId": "123123123",
    "qos": "1",
    "protocol": "MQTT",
    "eventType": "Queued",
    "status": "Failure",
    "details": "Server Error"
}

En plus de Attributs communs CloudWatch des journaux, Queued les erreurs de serveur des entrées de journal contiennent les attributs suivants :

clientId

ID du client auquel le message est mis en file d'attente.

détails
Server Error

Une erreur du serveur a empêché le stockage du message.

protocole ;

Protocole utilisé pour effectuer la demande. Cette valeur sera toujours MQTT.

qos

Niveau de Qualité de Service (QoS) de la requête. La valeur sera toujours 1 car les messages dont le QoS est égal à 0 ne sont pas stockés.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

Exemple d'entrée dans le journal des succès en attente

{
    "timestamp": "2022-08-10 15:39:30.961",
    "logLevel": "INFO",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "topicName": "$aws/things/MyThing/get",
    "clientId": "123123123",
    "qos": "1",
    "protocol": "MQTT",
    "eventType": "Queued",
    "status": "Success"
}

En plus de Attributs communs CloudWatch des journaux, Queued les entrées de journal contiennent les attributs suivants :

clientId

ID du client auquel le message est mis en file d'attente.

protocole ;

Protocole utilisé pour effectuer la demande. Cette valeur sera toujours MQTT.

qos

Niveau de Qualité de Service (QoS) de la requête. La valeur sera toujours 1 car les messages dont le QoS est égal à 0 ne sont pas stockés.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

Exemple d'entrée de journal limitée en file d'attente

{
    "timestamp": "2022-08-10 15:39:30.961",
    "logLevel": "ERROR",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "topicName": "$aws/things/MyThing/get",
    "clientId": "123123123",
    "qos": "1",
    "protocol": "MQTT",
    "eventType": "Queued",
    "status": "Failure",
    "details": "Throttled while queueing offline message"
}

En plus de Attributs communs CloudWatch des journaux, Queued les entrées de journal limitées contiennent les attributs suivants :

clientId

ID du client auquel le message est mis en file d'attente.

détails
Throttled while queueing offline message

Le client a dépassé la Queued messages per second per account limite, le message n'a donc pas été enregistré.

protocole ;

Protocole utilisé pour effectuer la demande. Cette valeur sera toujours MQTT.

qos

Niveau de Qualité de Service (QoS) de la requête. La valeur sera toujours 1 car les messages dont le QoS est égal à 0 ne sont pas stockés.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

Souscrire l'entrée de journal

Le courtier de AWS IoT messages génère une entrée de journal avec un « eventType of » Subscribe lorsqu'un client MQTT s'abonne à un sujet.

Exemple d'entrée de journal d'abonnement MQTT 3

{
    "timestamp": "2017-08-10 15:39:04.413",
    "logLevel": "INFO",
    "traceId": "7aa5c38d-1b49-3753-15dc-513ce4ab9fa6",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Subscribe",
    "protocol": "MQTT",
    "topicName": "$aws/things/MyThing/shadow/#",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal Subscribe contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

principalId

L'ID du mandataire formulant la demande.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

sourceIp

L'adresse IP d'origine de la demande.

sourcePort

Le port d'origine de la demande.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

Exemple d'entrée de journal d'abonnement MQTT 5

{
	"timestamp": "2022-11-30 16:24:15.628",
	"logLevel": "INFO",
	"traceId": "7aa5c38d-1b49-3753-15dc-513ce4ab9fa6",
	"accountId": "123456789012",
	"status": "Success",
	"eventType": "Subscribe",
	"protocol": "MQTT",
	"topicName": "test/topic1,$invalid/reserved/topic",
	"subscriptions": [
		{
			"topicName": "test/topic1",
			"reasonCode": 1
		},
		{
			"topicName": "$invalid/reserved/topic",
			"reasonCode": 143
		}
	],
	"clientId": "abf27092886e49a8a5c1922749736453",
	"principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
	"sourceIp": "205.251.233.181",
	"sourcePort": 13490
}

Pour les opérations d'abonnement de MQTT 5, en plus desAttributs communs CloudWatch des journaux et des attributs d'entrée du journal d'abonnement et de MQTT 3, les entrées du Subscribe journal MQTT 5 contiennent l'attribut suivant :

abonnements

Une liste de correspondances entre les sujets demandés dans la demande d'abonnement et le code de motif individuel de MQTT 5. Pour plus d'informations, consultez code de motif MQTT.

Entrées du journal OCSP du certificat de serveur

AWS IoT Core génère des entrées de journal pour l'événement suivant :

Récupérez l'entrée du journal OCSP StapleData

AWS IoT Core génère une entrée de journal avec un eventType de RetrieveOCSPStapleData lorsque le serveur récupère les données de base OCSP.

Exemples d'entrées de journal RetrieveOCSP StapleData

Voici un exemple d'entrée de journal deSuccess.

{
	"timestamp": "2024-01-30 15:39:30.961",
	"logLevel": "INFO",
	"traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
	"accountId": "123456789012",
	"status": "Success",
	"eventType": "RetrieveOCSPStapleData",
	"domainConfigName": "test-domain-config-name",
	"connectionDetails": {
		"httpStatusCode": "200",
		"ocspResponderUri": "http://ocsp.example.com",
		"sourceIp": "205.251.233.181",
		"targetIp": "250.15.5.3"
	},
	"ocspRequestDetails": {
		"requesterName": "iot.amazonaws.com",
		"requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01"
	},
	"ocspResponseDetails": {
		"responseCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01",
		"ocspResponseStatus": "successful",
		"certStatus": "good",
		"signature": "4C:6F:63:61:6C:20:52:65:73:70:6F:6E:64:65:72:20:53:69:67:6E:61:74:75:72:65",
		"thisUpdateTime": "Jan 31 01:21:02 2024 UTC",
		"nextUpdateTime": "Feb 02 00:21:02 2024 UTC",
		"producedAtTime": "Jan 31 01:37:03 2024 UTC",
		"stapledDataPayloadSize": "XXX"
	}
}

Voici un exemple d'entrée de journal deFailure.

{
	"timestamp": "2024-01-30 15:39:30.961",
	"logLevel": "ERROR",
	"traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
	"accountId": "123456789012",
	"status": "Failure",
	"reason": "A non 2xx HTTP response was received from the OCSP responder.",
	"eventType": "RetrieveOCSPStapleData",
	"domainConfigName": "test-domain-config-name",
	"connectionDetails": {
		"httpStatusCode": "444",
		"ocspResponderUri": "http://ocsp.example.com",
		"sourceIp": "205.251.233.181",
		"targetIp": "250.15.5.3"
	},
	"ocspRequestDetails": {
		"requesterName": "iot.amazonaws.com",
		"requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01"
	}
}

Pour l'RetrieveOCSPStapleopération, outre leAttributs communs CloudWatch des journaux, les entrées du journal contiennent les attributs suivants :

raison

La raison pour laquelle l'opération échoue.

domaine ConfigName

Le nom de la configuration de votre domaine.

Détails de connexion

Brève explication des détails de connexion.

  • http StatusCode

    Codes d'état HTTP renvoyés par le répondeur OCSP en réponse à la demande du client adressée au serveur.

  • ocsp ResponderUri

    L'URI du répondeur OCSP qui AWS IoT Core extrait le certificat du serveur.

  • sourceIp

    Adresse IP source du AWS IoT Core serveur.

  • IP cible

    Adresse IP cible du répondeur OCSP.

ocsp RequestDetails

Détails de la demande OCSP.

  • Nom du demandeur

    Identifiant du AWS IoT Core serveur qui envoie une demande au répondeur OCSP.

  • demande CertId

    L'ID du certificat de la demande. Il s'agit de l'ID du certificat pour lequel la réponse OCSP est demandée.

ocsp ResponseDetails

Détails de la réponse de l'OCSP.

  • réponse CertId

    ID de certificat de la réponse OCSP.

  • ocsp ResponseStatus

    État de la réponse OCSP.

  • État du certificat

    État du certificat.

  • Signature

    Signature appliquée à la réponse par une entité de confiance.

  • ce UpdateTime

    Heure à laquelle le statut indiqué est connu pour être correct.

  • suivant UpdateTime

    Heure à laquelle ou avant laquelle les informations les plus récentes concernant le statut du certificat seront disponibles.

  • produit AtTime

    Heure à laquelle le répondeur OCSP a signé cette réponse.

  • Taille agrafée DataPayload

    La taille de la charge utile des données agrafées.

Entrées de journal de shadow d'appareil

Le service AWS IoT Device Shadow génère des entrées de journal pour les événements suivants :

DeleteThingShadow entrée dans le journal

Le service Device Shadow génère une entrée de journal avec un eventType de DeleteThingShadow en cas de réception d'une demande de suppression d'un shadow d'appareil.

DeleteThingShadow exemple de saisie de journal

{
    "timestamp": "2017-08-07 18:47:56.664",
    "logLevel": "INFO",
    "traceId": "1a60d02e-15b9-605b-7096-a9f584a6ad3f",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "DeleteThingShadow",
    "protocol": "MQTT",
    "deviceShadowName": "Jack",
    "topicName": "$aws/things/Jack/shadow/delete"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal DeleteThingShadow contiennent les attributs suivants :

appareil ShadowName

Nom du shadow à mettre à jour.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

topicName

Le nom de la rubrique sur laquelle la demande a été publiée.

GetThingShadow entrée dans le journal

Le service Device Shadow génère une entrée de journal avec un eventType de GetThingShadow en cas de réception d'une demande get pour un shadow.

GetThingShadow exemple de saisie de journal

{
    "timestamp": "2017-08-09 17:56:30.941",
    "logLevel": "INFO",
    "traceId": "b575f19a-97a2-cf72-0ed0-c64a783a2504",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "GetThingShadow",
    "protocol": "MQTT",
    "deviceShadowName": "MyThing",
    "topicName": "$aws/things/MyThing/shadow/get"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal GetThingShadow contiennent les attributs suivants :

appareil ShadowName

Le nom du shadow demandé.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

topicName

Le nom de la rubrique sur laquelle la demande a été publiée.

UpdateThingShadow entrée dans le journal

Le service Device Shadow génère une entrée de journal avec un eventType de UpdateThingShadow en cas de réception d'une demande de mise à jour d'un shadow d'appareil.

UpdateThingShadow exemple de saisie de journal

{
    "timestamp": "2017-08-07 18:43:59.436",
    "logLevel": "INFO",
    "traceId": "d0074ba8-0c4b-a400-69df-76326d414c28",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "UpdateThingShadow",
    "protocol": "MQTT",
    "deviceShadowName": "Jack",
    "topicName": "$aws/things/Jack/shadow/update"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal UpdateThingShadow contiennent les attributs suivants :

appareil ShadowName

Nom du shadow à mettre à jour.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

topicName

Le nom de la rubrique sur laquelle la demande a été publiée.

Entrées de journal du moteur de règles

Le moteur de AWS IoT règles génère des journaux pour les événements suivants :

FunctionExecution entrée dans le journal

Le moteur de règles génère une entrée de journal avec un eventType de FunctionExecution lorsque la requête SQL d'une règle appelle une fonction externe. Une fonction externe est appelée lorsque l'action d'une règle envoie une requête HTTP à AWS IoT un autre service Web (par exemple, en appelant get_thing_shadow oumachinelearning_predict).

FunctionExecution exemple de saisie de journal

{
    "timestamp": "2017-07-13 18:33:51.903",
    "logLevel": "DEBUG",
    "traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
    "status": "Success",
    "eventType": "FunctionExecution",
    "clientId": "N/A",
    "topicName":"rules/test",
    "ruleName": "ruleTestPredict",
    "ruleAction": "MachinelearningPredict",
    "resources": {
        "ModelId": "predict-model"
    },
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal FunctionExecution contiennent les attributs suivants :

clientId

N/A pour les journaux FunctionExecution.

principalId

L'ID du mandataire formulant la demande.

resources

Une collection des ressources utilisées par les actions de la règle.

ruleName

Le nom de la règle de correspondance.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

RuleExecution entrée dans le journal

Lorsque le moteur de AWS IoT règles déclenche l'action d'une règle, il génère une entrée de RuleExecution journal.

RuleExecution exemple de saisie de journal

{
    "timestamp": "2017-08-10 16:32:46.070",
    "logLevel": "INFO",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "RuleExecution",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "rules/test",
    "ruleName": "JSONLogsRule",
    "ruleAction": "RepublishAction",
    "resources": {
        "RepublishTopic": "rules/republish"
    },
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal RuleExecution contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

principalId

L'ID du mandataire formulant la demande.

resources

Une collection des ressources utilisées par les actions de la règle.

ruleAction

Le nom de l'action déclenchée.

ruleName

Le nom de la règle de correspondance.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

RuleMatch entrée dans le journal

Le moteur de AWS IoT règles génère une entrée de journal avec un eventType de RuleMatch lorsque le courtier de messages reçoit un message correspondant à une règle.

RuleMatch exemple de saisie de journal

{
    "timestamp": "2017-08-10 16:32:46.002",
    "logLevel": "INFO",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "RuleMatch",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "rules/test",
    "ruleName": "JSONLogsRule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal RuleMatch contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

principalId

L'ID du mandataire formulant la demande.

ruleName

Le nom de la règle de correspondance.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

RuleExecutionThrottled entrée dans le journal

Lorsqu'une exécution est limitée, le moteur de AWS IoT règles génère une entrée de journal avec un eventType de. RuleExecutionThrottled

RuleExecutionThrottled exemple de saisie de journal

{
    "timestamp": "2017-10-04 19:25:46.070",
    "logLevel": "ERROR",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "RuleMessageThrottled",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "$aws/rules/example_rule",
    "ruleName": "example_rule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "reason": "RuleExecutionThrottled",
    "details": "Exection of Rule example_rule throttled"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal RuleExecutionThrottled contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

détails

Une brève explication de l'erreur.

principalId

L'ID du mandataire formulant la demande.

raison

La chaîne « RuleExecution Throttled ».

ruleName

Le nom de la règle à déclencher.

topicName

Le nom de la rubrique qui a été publiée.

RuleNotFound entrée dans le journal

Lorsque le moteur de AWS IoT règles ne trouve pas de règle portant un nom donné, il génère une entrée de journal avec un eventType deRuleNotFound.

RuleNotFound exemple de saisie de journal

{
    "timestamp": "2017-10-04 19:25:46.070",
    "logLevel": "ERROR",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "RuleNotFound",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "$aws/rules/example_rule",
    "ruleName": "example_rule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "reason": "RuleNotFound",
    "details": "Rule example_rule not found"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal RuleNotFound contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

détails

Une brève explication de l'erreur.

principalId

L'ID du mandataire formulant la demande.

raison

La chaîne « RuleNot Found ».

ruleName

Nom de la règle qui est introuvable.

topicName

Le nom de la rubrique qui a été publiée.

StartingRuleExecution entrée dans le journal

Lorsque le moteur de AWS IoT règles commence à déclencher l'action d'une règle, il génère une entrée de journal avec un eventType deStartingRuleExecution.

StartingRuleExecution exemple de saisie de journal

{
    "timestamp": "2017-08-10 16:32:46.002",
    "logLevel": "DEBUG",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "StartingRuleExecution",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "rules/test",
    "ruleName": "JSONLogsRule",
    "ruleAction": "RepublishAction",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal rule- contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

principalId

L'ID du mandataire formulant la demande.

ruleAction

Le nom de l'action déclenchée.

ruleName

Le nom de la règle de correspondance.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

Entrées du journal des tâches

Le service AWS IoT Job génère des entrées de journal pour les événements suivants. Les entrées de journal sont générées lorsqu'une demande HTTP ou MQTT est reçue à partir de l'appareil.

DescribeJobExecution entrée dans le journal

Le service AWS IoT Jobs génère une entrée de journal avec un « eventType of » DescribeJobExecution lorsque le service reçoit une demande décrivant l'exécution d'une tâche.

DescribeJobExecution exemple de saisie de journal

{
    "timestamp": "2017-08-10 19:13:22.841",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "DescribeJobExecution",
    "protocol": "MQTT",
    "clientId": "thingOne",
    "jobId": "002",
    "topicName": "$aws/things/thingOne/jobs/002/get",
    "clientToken": "myToken",
    "details": "The request status is SUCCESS."
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal GetJobExecution contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

clientToken

Identifiant unique, sensible à la casse, afin de garantir l'idempotence de la demande. Pour de plus amples informations, veuillez consulter la section Comment garantir l'idempotence.

détails

Informations supplémentaires issues du service Jobs.

jobId

L'ID de tâche pour l'exécution du travail.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

topicName

La rubrique utilisée pour effectuer la demande.

GetPendingJobExecution entrée dans le journal

Le service AWS IoT Jobs génère une entrée de journal avec un « eventType of » GetPendingJobExecution lorsque le service reçoit une demande d'exécution de tâche.

GetPendingJobExecution exemple de saisie de journal

{
    "timestamp": "2018-06-13 17:45:17.197",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "GetPendingJobExecution",
    "protocol": "MQTT",
    "clientId": "299966ad-54de-40b4-99d3-4fc8b52da0c5",
    "topicName": "$aws/things/299966ad-54de-40b4-99d3-4fc8b52da0c5/jobs/get",
    "clientToken": "24b9a741-15a7-44fc-bd3c-1ff2e34e5e82",
    "details": "The request status is SUCCESS."
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal GetPendingJobExecution contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

clientToken

Identifiant unique, sensible à la casse, afin de garantir l'idempotence de la demande. Pour de plus amples informations, veuillez consulter la section Comment garantir l'idempotence.

détails

Informations supplémentaires issues du service Jobs.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

topicName

Le nom de la rubrique faisant l'objet de l'abonnement.

ReportFinalJobExecutionCount entrée dans le journal

Le service AWS IoT Jobs génère une entrée de journal avec un « entryType of » ReportFinalJobExecutionCount lorsqu'une tâche est terminée.

ReportFinalJobExecutionCount exemple de saisie de journal

{
    "timestamp": "2017-08-10 19:44:16.776",
    "logLevel": "INFO",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "ReportFinalJobExecutionCount",
    "jobId": "002",
    "details": "Job 002 completed. QUEUED job execution count: 0 IN_PROGRESS job execution count: 0 FAILED job execution count: 0 SUCCEEDED job execution count: 1 CANCELED job execution count: 0 REJECTED job execution count: 0 REMOVED job execution count: 0"
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal ReportFinalJobExecutionCount contiennent les attributs suivants :

détails

Informations supplémentaires issues du service Jobs.

jobId

L'ID de tâche pour l'exécution du travail.

StartNextPendingJobExecution entrée dans le journal

Lorsqu'il reçoit une demande pour démarrer la prochaine exécution de la tâche en attente, le service AWS IoT Jobs génère une entrée de journal avec un eventType deStartNextPendingJobExecution.

StartNextPendingJobExecution exemple de saisie de journal

{
    "timestamp": "2018-06-13 17:49:51.036",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "StartNextPendingJobExecution",
    "protocol": "MQTT",
    "clientId": "95c47808-b1ca-4794-bc68-a588d6d9216c",
    "topicName": "$aws/things/95c47808-b1ca-4794-bc68-a588d6d9216c/jobs/start-next",
    "clientToken": "bd7447c4-3a05-49f4-8517-dd89b2c68d94",
    "details": "The request status is SUCCESS."
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal StartNextPendingJobExecution contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

clientToken

Identifiant unique, sensible à la casse, afin de garantir l'idempotence de la demande. Pour de plus amples informations, veuillez consulter la section Comment garantir l'idempotence.

détails

Informations supplémentaires issues du service Jobs.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

topicName

La rubrique utilisée pour effectuer la demande.

UpdateJobExecution entrée dans le journal

Le service AWS IoT Jobs génère une entrée de journal avec un « eventType of » UpdateJobExecution lorsque le service reçoit une demande de mise à jour de l'exécution d'une tâche.

UpdateJobExecution exemple de saisie de journal

{
    "timestamp": "2017-08-10 19:25:14.758",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "UpdateJobExecution",
    "protocol": "MQTT",
    "clientId": "thingOne",
    "jobId": "002",
    "topicName": "$aws/things/thingOne/jobs/002/update",
    "clientToken": "myClientToken",
    "versionNumber": "1",
    "details": "The destination status is IN_PROGRESS. The request status is SUCCESS."
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal UpdateJobExecution contiennent les attributs suivants :

clientId

L'ID du client formulant la demande.

clientToken

Identifiant unique, sensible à la casse, afin de garantir l'idempotence de la demande. Pour de plus amples informations, veuillez consulter la section Comment garantir l'idempotence.

détails

Informations supplémentaires issues du service Jobs.

jobId

L'ID de tâche pour l'exécution du travail.

protocole ;

Protocole utilisé pour effectuer la demande. Les valeurs valides sont MQTT ou HTTP.

topicName

La rubrique utilisée pour effectuer la demande.

versionNumber

Version de l'exécution de tâche.

Entrées de journal de provisionnement des appareils

Le service AWS IoT Device Provisioning génère des journaux pour les événements suivants.

GetDeviceCredentials entrée dans le journal

Le service AWS IoT Device Provisioning génère une entrée de journal avec un « eventType of » GetDeviceCredential lorsqu'un client appelleGetDeviceCredential.

GetDeviceExemple de saisie du journal des informations d'identification

{
  "timestamp" : "2019-02-20 20:31:22.932",
  "logLevel" : "INFO",
  "traceId" : "8d9c016f-6cc7-441e-8909-7ee3d5563405",
  "accountId" : "123456789101",
  "status" : "Success",
  "eventType" : "GetDeviceCredentials",
  "deviceCertificateId" : "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "details" : "Additional details about this log."
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal GetDeviceCredentials contiennent les attributs suivants :

détails

Une brève explication de l'erreur.

appareil CertificateId

ID du certificat d'appareil.

ProvisionDevice entrée dans le journal

Le service AWS IoT Device Provisioning génère une entrée de journal avec un « eventType of » ProvisionDevice lorsqu'un client appelleProvisionDevice.

ProvisionDevice exemple de saisie de journal

{
  "timestamp" : "2019-02-20 20:31:22.932",
  "logLevel" : "INFO",
  "traceId" : "8d9c016f-6cc7-441e-8909-7ee3d5563405",
  "accountId" : "123456789101",
  "status" : "Success",
  "eventType" : "ProvisionDevice",
  "provisioningTemplateName" : "myTemplate",
  "deviceCertificateId" : "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "details" : "Additional details about this log."
 }

En plus de Attributs communs CloudWatch des journaux, les entrées de journal ProvisionDevice contiennent les attributs suivants :

détails

Une brève explication de l'erreur.

appareil CertificateId

ID du certificat d'appareil.

approvisionnement TemplateName

Nom du modèle de mise en service.

Entrées dynamiques du journal des groupes d'objets

AWS IoT Les groupes d'objets dynamiques génèrent des journaux pour l'événement suivant.

AddThingToDynamicThingGroupsFailed entrée dans le journal

Lorsqu' AWS IoT il n'est pas possible d'ajouter un élément aux groupes dynamiques spécifiés, il génère une entrée de journal avec un eventType deAddThingToDynamicThingGroupsFailed. Cela se produit lorsqu'un objet a répondu aux critères d'appartenance au groupe d’objets dynamiques. Toutefois, il n'a pas pu être ajouté au groupe dynamique ou il a été supprimé du groupe dynamique. Cela peut se produire pour les raisons suivantes :

  • L’objet appartient déjà au nombre maximal de groupes.

  • L'option --override-dynamic-groups a été utilisée pour ajouter l’objet à un groupe d’objets statiques. Il a été retiré d'un groupe d’objets dynamiques pour rendre cela possible.

Pour de plus amples informations, veuillez consulter Limitations et conflits de groupes d’objets dynamiques.

AddThingToDynamicThingGroupsFailed exemple de saisie de journal

Cet exemple montre une entrée de journal correspondant à une erreur AddThingToDynamicThingGroupsFailed. Dans cet exemple, il TestThingrépondait aux critères pour figurer dans les groupes d'objets dynamiques répertoriés dansdynamicThingGroupNames, mais n'a pas pu être ajouté à ces groupes dynamiques, comme décrit dansreason.

{
 "timestamp": "2020-03-16 22:24:43.804",
 "logLevel": "ERROR",
 "traceId": "70b1f2f5-d95e-f897-9dcc-31e68c3e1a30",
 "accountId": "57EXAMPLE833",
 "status": "Failure",
 "eventType": "AddThingToDynamicThingGroupsFailed",
 "thingName": "TestThing",
 "dynamicThingGroupNames": [
  "DynamicThingGroup11",
  "DynamicThingGroup12",
  "DynamicThingGroup13",
  "DynamicThingGroup14"
 ],
 "reason": "The thing failed to be added to the given dynamic thing group(s) because the thing already belongs to the maximum allowed number of groups."
}

En plus de Attributs communs CloudWatch des journaux, les entrées de journal AddThingToDynamicThingGroupsFailed contiennent les attributs suivants :

ThingGroupnoms dynamiques

Tableau des groupes d’objets dynamiques auquel l’objet n'a pas pu être ajouté.

raison

Raison pour laquelle l’objet n'a pas pu être ajouté aux groupes d’objets dynamiques.

thingName

Nom de l’objet qui n'a pas pu être ajouté à un groupe d’objets dynamiques.

Entrées du journal d'indexation de la flotte

AWS IoT l'indexation de la flotte génère des entrées de journal pour les événements suivants.

NamedShadowCountForDynamicGroupQueryLimitExceeded entrée dans le journal

Un maximum de 25 ombres nommées par objet sont traitées pour les termes de requête qui ne sont pas spécifiques à une source de données dans les groupes dynamiques. Lorsque cette limite est dépassée pour un objet, le type d'NamedShadowCountForDynamicGroupQueryLimitExceededévénement est émis.

NamedShadowCountForDynamicGroupQueryLimitExceeded exemple de saisie de journal

Cet exemple montre une entrée de journal correspondant à une NamedShadowCountForDynamicGroupQueryLimitExceeded erreur. Dans cet exemple, tous les DynamicGroup résultats basés sur toutes les valeurs peuvent être inexacts, comme décrit dans le reason champ.

{
"timestamp": "2020-03-16 22:24:43.804",
"logLevel": "ERROR",
"traceId": "70b1f2f5-d95e-f897-9dcc-31e68c3e1a30",
"accountId": "571032923833",
"status": "Failure",
"eventType": "NamedShadowCountForDynamicGroupQueryLimitExceeded",
"thingName": "TestThing",
"reason": "A maximum of 25 named shadows per thing are processed for non-data source specific query terms in dynamic groups."
}

Attributs communs CloudWatch des journaux

Toutes les entrées du journal CloudWatch Logs incluent les attributs suivants :

accountId

Votre Compte AWS carte d'identité.

eventType

Le type d'événement pour lequel le journal a été créé. La valeur du type d'événement dépend de l'événement qui a généré l'entrée de journal. Chaque description d'entrée de journal inclut la valeur de eventType pour cette entrée de journal.

logLevel

Le niveau de journalisation utilisé. Pour plus d’informations, consultez Niveaux de journalisation..

status

Le statut d'une demande.

timestamp

L'horodatage UTC lisible par l'homme du moment où le client s'est connecté à AWS IoT l’agent de messages.

traceId

Un identifiant généré de façon aléatoire qui peut être utilisé pour mettre en corrélation tous les journaux pour une demande spécifique.