CloudWatch Registra le voci di registro AWS IoT - AWS IoT Core
Voci di registro del broker messaggiVoci di registro OCSP del certificato del serverVoci del registro Device ShadowVoci di registro del motore delle regoleVoci del registro processiVoci del registro di provisioning dei dispositiviVoci del registro del gruppo di oggetti dinamiciVoci di registro di indicizzazione del parco istanzeattributi Common CloudWatch Logs

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CloudWatch Registra le voci di registro AWS IoT

Ogni componente di AWS IoT genera le proprie voci di registro. Ogni voce di registro ha un eventType che specifica l'operazione che ha causato la generazione della voce di registro. In questa sezione vengono descritti le voci di registro generate dai seguenti componenti di AWS IoT .

Voci di registro del broker messaggi

Il broker di AWS IoT messaggi genera voci di registro per i seguenti eventi:

Connetti voce di registro

Il broker di AWS IoT messaggi genera una voce di registro con un eventType di Connect quando un client MQTT si connette.

Esempio di voce di registro di connessione

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

Oltre a attributi Common CloudWatch Logs, le voci di registro Connect contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

principalId

ID dell'entità principale da cui proviene la richiesta.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

sourceIp

Indirizzo IP da cui ha avuto origine la richiesta.

sourcePort

Porta da cui ha avuto origine la richiesta.

Disconnetti voce registro

Il broker di AWS IoT messaggi genera una voce di registro con un eventType di Disconnect quando un client MQTT si disconnette.

Esempio di voce di registro di disconnessione

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

Oltre a attributi Common CloudWatch Logs, le voci di registro Disconnect contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

principalId

ID dell'entità principale da cui proviene la richiesta.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

sourceIp

Indirizzo IP da cui ha avuto origine la richiesta.

sourcePort

Porta da cui ha avuto origine la richiesta.

motivo

Il motivo per cui il client viene disconnesso.

details

Una breve spiegazione dell'errore.

disconnectReason

Il motivo per cui il client viene disconnesso.

GetRetainedMessage voce di registro

Il broker di AWS IoT messaggi genera una voce di registro con una chiamata eventType GetRetainedMessagedi GetRetainedMessage quando.

GetRetainedMessage esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro GetRetainedMessage contengono i seguenti attributi:

ultimo ModifiedDate

La data e l'ora dell'epoca, in millisecondi, in cui il messaggio conservato è stato archiviato da. AWS IoT

protocol

Il protocollo usato per effettuare la richiesta. Valore valido: HTTP.

qos

Il livello di qualità del servizio (QoS) utilizzato nella richiesta di pubblicazione. I valori validi sono 0 e 1.

topicName

Nome dell'argomento sottoscritto.

ListRetainedMessage registrazione del registro

Il broker di AWS IoT messaggi genera una voce di registro con una chiamata eventType ListRetainedMessagesdi ListRetainedMessage quando.

ListRetainedMessage esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro ListRetainedMessage contengono i seguenti attributi:

protocol

Il protocollo usato per effettuare la richiesta. Valore valido: HTTP.

Voce di registro di pubblicazione

Quando il broker di AWS IoT messaggi riceve un messaggio MQTT, genera una voce di registro con un eventType ofPublish-In.

Esempio di voce di registro di pubblicazione

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

Oltre a attributi Common CloudWatch Logs, le voci di registro Publish-In contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

principalId

ID dell'entità principale da cui proviene la richiesta.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

retain

L'attributo utilizzato quando un messaggio ha il flag RETAIN impostato con un valore di True. Se nel messaggio non è impostato il flag RETAIN, questo attributo non viene visualizzato nella voce di registro. Per ulteriori informazioni, consulta Messaggi conservati da MQTT.

sourceIp

Indirizzo IP da cui ha avuto origine la richiesta.

sourcePort

Porta da cui ha avuto origine la richiesta.

topicName

Nome dell'argomento sottoscritto.

Voce di registro di pubblicazione

Quando il broker di messaggi pubblica un messaggio MQTT, genera un log eventType di Publish-Out.

Esempio di voce di registro di pubblicazione

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

Oltre a attributi Common CloudWatch Logs, le voci di registro Publish-Out contengono i seguenti attributi:

clientId

L'ID del client sottoscritto che riceve messaggi su quell'argomento MQTT.

principalId

ID dell'entità principale da cui proviene la richiesta.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

sourceIp

Indirizzo IP da cui ha avuto origine la richiesta.

sourcePort

Porta da cui ha avuto origine la richiesta.

topicName

Nome dell'argomento sottoscritto.

Voce di log Queued

Quando un dispositivo con una sessione persistente viene disconnesso, il broker di messaggi MQTT archivia i messaggi del dispositivo e AWS IoT genera voci di registro con un EventType di. Queued Per ulteriori informazioni sulle sessioni persistenti MQTT, consultare Sessioni persistenti MQTT.

Esempio di voce del log errori del server Queued

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

Oltre a attributi Common CloudWatch Logs, le voci del log errori del server Queued contengono i seguenti attributi:

clientId

L'ID del client in cui il messaggio viene accodato.

details
Server Error

Un errore del server ha impedito l'archiviazione del messaggio.

protocol

Il protocollo usato per effettuare la richiesta. Il valore sarà sempre MQTT.

qos

Il livello di qualità del servizio (QoS) della richiesta. Il valore sarà sempre 1 perché i messaggi con QoS pari a 0 non vengono archiviati.

topicName

Nome dell'argomento sottoscritto.

Esempio di voce di log delle operazioni riuscite Queued

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

Oltre a attributi Common CloudWatch Logs, le voci di log delle operazioni riuscite Queued contengono i seguenti attributi:

clientId

L'ID del client in cui il messaggio viene accodato.

protocol

Il protocollo usato per effettuare la richiesta. Il valore sarà sempre MQTT.

qos

Il livello di qualità del servizio (QoS) della richiesta. Il valore sarà sempre 1 perché i messaggi con QoS pari a 0 non vengono archiviati.

topicName

Nome dell'argomento sottoscritto.

Esempio di voce di log con limitazione (della larghezza di banda della rete) Queued

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

Oltre a attributi Common CloudWatch Logs, le voci di log con limitazione (della larghezza di banda della rete) Queued contengono i seguenti attributi:

clientId

L'ID del client in cui il messaggio viene accodato.

details
Throttled while queueing offline message

Il client ha superato il limite Queued messages per second per account, pertanto il messaggio non è stato archiviato.

protocol

Il protocollo usato per effettuare la richiesta. Il valore sarà sempre MQTT.

qos

Il livello di qualità del servizio (QoS) della richiesta. Il valore sarà sempre 1 perché i messaggi con QoS pari a 0 non vengono archiviati.

topicName

Nome dell'argomento sottoscritto.

Sottoscrivi voce di registro

Il broker di AWS IoT messaggi genera una voce di registro con un eventType di Subscribe quando un client MQTT sottoscrive un argomento.

Esempio di voce di log MQTT 3 Subscribe

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

Oltre a attributi Common CloudWatch Logs, le voci di registro Subscribe contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

principalId

ID dell'entità principale da cui proviene la richiesta.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

sourceIp

Indirizzo IP da cui ha avuto origine la richiesta.

sourcePort

Porta da cui ha avuto origine la richiesta.

topicName

Nome dell'argomento sottoscritto.

Esempio di voce di log MQTT 5 Subscribe

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

Per le operazioni MQTT 5 Subscribe, oltre a attributi Common CloudWatch Logs e Attributi voce di log MQTT 3 Subscribe, le voci di log MQTT 5 Subscribe contengono il seguente attributo:

sottoscrizioni

Un elenco di mappature tra gli argomenti richiesti nella richiesta Subscribe e il singolo codice motivo MQTT 5. Per ulteriori informazioni, consulta Codici motivo MQTT.

Voci di registro OCSP del certificato del server

AWS IoT Core genera voci di registro per il seguente evento:

Recupera la voce di registro OCSP StapleData

AWS IoT Core genera una voce di registro con un eventType di RetrieveOCSPStapleData quando il server recupera i dati di base OCSP.

Recupera esempi StapleData di voci di registro OCSP

Di seguito è riportato un esempio di immissione di registro di. Success

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

Di seguito è riportato un esempio di immissione di registro diFailure.

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

Per l'RetrieveOCSPStapleoperazione, oltre aattributi Common CloudWatch Logs, le voci di registro contengono i seguenti attributi:

motivo

Il motivo per cui l'operazione non riesce.

dominio ConfigName

Il nome della configurazione del tuo dominio.

Dettagli della connessione

Una breve spiegazione dei dettagli della connessione.

  • http StatusCode

    codici di stato HTTP restituiti dal risponditore OCSP in risposta alla richiesta del client effettuata al server.

  • ocsp ResponderUri

    L'URI del risponditore OCSP AWS IoT Core recuperato dal certificato del server.

  • sourceIp

    L'indirizzo IP di origine del server. AWS IoT Core

  • TargetIP

    L'indirizzo IP di destinazione del risponditore OCSP.

ocsp RequestDetails

Dettagli della richiesta OCSP.

  • Nome del richiedente

    L'identificatore del AWS IoT Core server che invia una richiesta al risponditore OCSP.

  • richiesta CertId

    L'ID del certificato della richiesta. Questo è l'ID del certificato per il quale viene richiesta la risposta OCSP.

ocsp ResponseDetails

Dettagli della risposta OCSP.

  • risposta CertId

    L'ID del certificato della risposta OCSP.

  • ocsp ResponseStatus

    Lo stato della risposta OCSP.

  • CertStatus

    Stato del certificato.

  • signature

    La firma applicata alla risposta da un'entità attendibile.

  • questo UpdateTime

    L'ora in cui è noto che lo stato indicato è corretto.

  • successivo UpdateTime

    L'ora o prima della quale saranno disponibili nuove informazioni sullo stato del certificato.

  • prodotto AtTime

    L'ora in cui il risponditore OCSP ha firmato questa risposta.

  • dimensione pinzata DataPayload

    La dimensione del payload dei dati graffati.

Voci del registro Device Shadow

Il servizio AWS IoT Device Shadow genera voci di registro per i seguenti eventi:

DeleteThingShadow voce di registro

Il servizio Device Shadow genera una voce log con un eventType di DeleteThingShadow quando viene ricevuta una richiesta di eliminazione di una copia shadow di un dispositivo.

DeleteThingShadow esempio di immissione nel registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro DeleteThingShadow contengono i seguenti attributi:

dispositivo ShadowName

Nome della copia shadow da aggiornare.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

topicName

Nome dell'argomento in cui la richiesta è stata pubblicata.

GetThingShadow registrazione del registro

Il servizio Device Shadow genera una voce log eventType di GetThingShadow quando viene ricevuta una richiesta per una copia shadow.

GetThingShadow esempio di immissione nel registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro GetThingShadow contengono i seguenti attributi:

dispositivo ShadowName

Nome della copia shadow richiesta.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

topicName

Nome dell'argomento in cui la richiesta è stata pubblicata.

UpdateThingShadow registrazione del registro

Il servizio Device Shadow genera una voce log con un eventType di UpdateThingShadow quando viene ricevuta una richiesta di aggiornamento di una copia shadow di un dispositivo.

UpdateThingShadow esempio di immissione nel registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro UpdateThingShadow contengono i seguenti attributi:

dispositivo ShadowName

Nome della copia shadow da aggiornare.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

topicName

Nome dell'argomento in cui la richiesta è stata pubblicata.

Voci di registro del motore delle regole

Il motore AWS IoT delle regole genera i log per i seguenti eventi:

FunctionExecution voce di registro

Il motore di regole genera una voce log eventType di FunctionExecution quando una query SQL di una regola chiama una funzione esterna. Una funzione esterna viene chiamata quando l'azione di una regola effettua una richiesta HTTP a AWS IoT o a un altro servizio Web (ad esempio, chiamando get_thing_shadow omachinelearning_predict).

FunctionExecution esempio di immissione nel registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro FunctionExecution contengono i seguenti attributi:

clientId

N/A per i log FunctionExecution.

principalId

ID dell'entità principale da cui proviene la richiesta.

risorse

Raccolta di risorse usate dalle operazioni della regola.

ruleName

Nome della regola corrispondente.

topicName

Nome dell'argomento sottoscritto.

RuleExecution voce di registro

Quando il motore AWS IoT delle regole attiva l'azione di una regola, genera una voce di RuleExecution registro.

RuleExecution esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro RuleExecution contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

principalId

ID dell'entità principale da cui proviene la richiesta.

risorse

Raccolta di risorse usate dalle operazioni della regola.

ruleAction

Il nome dell'operazione attivata.

ruleName

Nome della regola corrispondente.

topicName

Nome dell'argomento sottoscritto.

RuleMatch voce di registro

Il motore AWS IoT delle regole genera una voce di registro con un eventType di RuleMatch quando il broker di messaggi riceve un messaggio che corrisponde a una regola.

RuleMatch esempio di immissione di log

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

Oltre a attributi Common CloudWatch Logs, le voci di registro RuleMatch contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

principalId

ID dell'entità principale da cui proviene la richiesta.

ruleName

Nome della regola corrispondente.

topicName

Nome dell'argomento sottoscritto.

RuleExecutionThrottled voce di registro

Quando un'esecuzione viene limitata, il motore delle AWS IoT regole genera una voce di registro con un eventType of. RuleExecutionThrottled

RuleExecutionThrottled esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro RuleExecutionThrottled contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

details

Una breve spiegazione dell'errore.

principalId

ID dell'entità principale da cui proviene la richiesta.

motivo

La stringa "RuleExecutionThrottled».

ruleName

Nome della regola da attivare.

topicName

Il nome dell'argomento che è stato pubblicato.

RuleNotFound voce di registro

Quando il motore AWS IoT delle regole non riesce a trovare una regola con un determinato nome, genera una voce di registro con un eventType ofRuleNotFound.

RuleNotFound esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro RuleNotFound contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

details

Una breve spiegazione dell'errore.

principalId

ID dell'entità principale da cui proviene la richiesta.

motivo

La stringa "RuleNotFound».

ruleName

Il nome della regola che non è stato possibile trovare.

topicName

Il nome dell'argomento che è stato pubblicato.

StartingRuleExecution voce di registro

Quando il motore AWS IoT delle regole inizia ad attivare l'azione di una regola, genera una voce di registro con un eventType ofStartingRuleExecution.

StartingRuleExecution esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro rule- contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

principalId

ID dell'entità principale da cui proviene la richiesta.

ruleAction

Il nome dell'operazione attivata.

ruleName

Nome della regola corrispondente.

topicName

Nome dell'argomento sottoscritto.

Voci del registro processi

Il servizio AWS IoT Job genera voci di registro per i seguenti eventi. I log vengono generati quando viene ricevuta una richiesta MQTT o HTTP dal dispositivo.

DescribeJobExecution voce di registro

Il servizio AWS IoT Jobs genera una voce di registro con un eventType di DescribeJobExecution quando il servizio riceve una richiesta per descrivere l'esecuzione di un processo.

DescribeJobExecution esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro GetJobExecution contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

clientToken

Identificatore univoco con distinzione tra maiuscole e minuscole per assicurare l'idempotenza della richiesta. Per ulteriori informazioni, consulta Come assicurare l'idempotenza.

details

Ulteriori informazioni dal servizio Jobs.

jobId

Job ID per l'esecuzione del processo.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

topicName

Argomento usato per effettuare la richiesta.

GetPendingJobExecution voce di registro

Il servizio AWS IoT Jobs genera una voce di registro con un eventType di GetPendingJobExecution quando il servizio riceve una richiesta di esecuzione del lavoro.

GetPendingJobExecution esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro GetPendingJobExecution contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

clientToken

Identificatore univoco con distinzione tra maiuscole e minuscole per assicurare l'idempotenza della richiesta. Per ulteriori informazioni, consulta Come assicurare l'idempotenza.

details

Ulteriori informazioni dal servizio Jobs.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

topicName

Nome dell'argomento sottoscritto.

ReportFinalJobExecutionCount voce di registro

Il servizio AWS IoT Jobs genera una voce di registro con entryType ReportFinalJobExecutionCount l'indicazione del completamento di un lavoro.

ReportFinalJobExecutionCount esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro ReportFinalJobExecutionCount contengono i seguenti attributi:

details

Ulteriori informazioni dal servizio Jobs.

jobId

Job ID per l'esecuzione del processo.

StartNextPendingJobExecution voce di registro

Quando riceve una richiesta per avviare la successiva esecuzione del processo in sospeso, il servizio AWS IoT Jobs genera una voce di registro con un eventType ofStartNextPendingJobExecution.

StartNextPendingJobExecution esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro StartNextPendingJobExecution contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

clientToken

Identificatore univoco con distinzione tra maiuscole e minuscole per assicurare l'idempotenza della richiesta. Per ulteriori informazioni, consulta Come assicurare l'idempotenza.

details

Ulteriori informazioni dal servizio Jobs.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

topicName

Argomento usato per effettuare la richiesta.

UpdateJobExecution voce di registro

Il servizio AWS IoT Jobs genera una voce di registro con un eventType di UpdateJobExecution quando il servizio riceve una richiesta di aggiornamento dell'esecuzione di un lavoro.

UpdateJobExecution esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro UpdateJobExecution contengono i seguenti attributi:

clientId

ID del client da cui proviene la richiesta.

clientToken

Identificatore univoco con distinzione tra maiuscole e minuscole per assicurare l'idempotenza della richiesta. Per ulteriori informazioni, consulta Come assicurare l'idempotenza.

details

Ulteriori informazioni dal servizio Jobs.

jobId

Job ID per l'esecuzione del processo.

protocol

Il protocollo usato per effettuare la richiesta. I valori validi sono MQTT e HTTP.

topicName

Argomento usato per effettuare la richiesta.

versionNumber

Versione dell'esecuzione del processo.

Voci del registro di provisioning dei dispositivi

Il servizio AWS IoT Device Provisioning genera registri per i seguenti eventi.

GetDeviceCredentials voce di registro

Il servizio AWS IoT Device Provisioning genera una voce di registro con l'indicazione eventType di GetDeviceCredential quando un client chiamaGetDeviceCredential.

GetDeviceEsempio di immissione nel registro delle credenziali

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

Oltre a attributi Common CloudWatch Logs, le voci di registro GetDeviceCredentials contengono i seguenti attributi:

details

Una breve spiegazione dell'errore.

dispositivo CertificateId

L'ID del certificato del dispositivo.

ProvisionDevice registrazione del registro

Il servizio AWS IoT Device Provisioning genera una voce di registro con l'indicazione eventType di ProvisionDevice quando un client chiamaProvisionDevice.

ProvisionDevice esempio di immissione di registro

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

Oltre a attributi Common CloudWatch Logs, le voci di registro ProvisionDevice contengono i seguenti attributi:

details

Una breve spiegazione dell'errore.

dispositivo CertificateId

L'ID del certificato del dispositivo.

approvvigionamento TemplateName

Il nome del modello dell'artefatto di provisioning.

Voci del registro del gruppo di oggetti dinamici

AWS IoT I Dynamic Thing Groups generano log per il seguente evento.

AddThingToDynamicThingGroupsFailed voce di registro

Quando non AWS IoT è stato possibile aggiungere un elemento ai gruppi dinamici specificati, genera una voce di registro con un eventType ofAddThingToDynamicThingGroupsFailed. Questo accade se un oggetto soddisfaceva i criteri per essere inserito nel gruppo di oggetti dinamico; tuttavia, non è stato possibile aggiungerlo al gruppo dinamico o è stato rimosso dal gruppo dinamico. Questo può accadere perché:

  • L'oggetto appartiene già al numero massimo di gruppi.

  • L'opzione --override-dynamic-groups è stata utilizzata per aggiungere l'oggetto a un gruppo di oggetti statico. È stato rimosso da un gruppo di oggetti dinamico per rendere ciò possibile.

Per ulteriori informazioni, consulta Limitazioni e conflitti del gruppo di oggetti dinamico.

AddThingToDynamicThingGroupsFailed esempio di immissione di registro

Questo esempio mostra la voce di log di un errore AddThingToDynamicThingGroupsFailed. In questo esempio, TestThingsoddisfaceva i criteri per rientrare nei gruppi di oggetti dinamici elencati indynamicThingGroupNames, ma non poteva essere aggiunto a tali gruppi dinamici, come descritto inreason.

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

Oltre a attributi Common CloudWatch Logs, le voci di registro AddThingToDynamicThingGroupsFailed contengono i seguenti attributi:

ThingGroupNomi dinamici

Un array dei gruppi di oggetti dinamici a cui non è stato possibile aggiungere l'oggetto.

motivo

Il motivo per il quale non è stato possibile aggiungere l'oggetto ai gruppi di oggetti dinamici.

thingName

Il nome dell'oggetto che non è stato possibile aggiungere a un gruppo di oggetti dinamico.

Voci di registro di indicizzazione del parco istanze

AWS IoT l'indicizzazione della flotta genera voci di registro per i seguenti eventi.

NamedShadowCountForDynamicGroupQueryLimitExceeded voce di registro

Viene elaborato un massimo di 25 shadow denominate per oggetto per termini di query che non sono specifici dell'origine dei dati nei gruppi dinamici. Quando questo limite viene violato, il tipo di evento NamedShadowCountForDynamicGroupQueryLimitExceeded verrà emesso.

NamedShadowCountForDynamicGroupQueryLimitExceeded esempio di immissione nel registro

Questo esempio mostra la voce di registro per un errore NamedShadowCountForDynamicGroupQueryLimitExceeded. In questo esempio i risultati di DynamicGroup, basati su tuti i valori, possono essere imprecisi come descritto nel campo reason.

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

attributi Common CloudWatch Logs

Tutte le voci di registro CloudWatch di Logs includono i seguenti attributi:

accountId

Il tuo Account AWS ID.

eventType

Tipo di evento per cui il log è stato generato. Il valore del tipo di evento dipende dall'evento che ha generato la voce di registro. Ogni descrizione della voce di registro include il valore di eventType per tale voce di registro.

logLevel

Livello di log usato. Per ulteriori informazioni, consulta Livelli di log.

status

Stato della richiesta.

timestamp

Timestamp UTC leggibile relativo al momento in cui il client si è connesso al broker di messaggi AWS IoT .

traceId

Identificatore generato in modo casuale che può essere usato per correlare tutti i log per una richiesta specifica.