CloudWatch Registri AWS IoT voci di registro - AWS IoT Core
Voci di registro del broker messaggivoci di OCSP registro dei certificati 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 Registri AWS IoT voci di registro

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. Questa sezione descrive le voci di registro generate da quanto segue AWS IoT componenti.

Voci di registro del broker messaggi

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

Connetti voce di registro

Il AWS IoT message broker genera una voce di registro con un eventType di Connect quando un MQTT client 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 AWS IoT message broker genera una voce di registro con un eventType di Disconnect quando un MQTT client 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 AWS IoT message broker genera una voce di registro con un eventType di GetRetainedMessage quando GetRetainedMessageviene chiamato.

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:

lastModifiedDate

Data e 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 voce di registro

Il AWS IoT message broker genera una voce di registro con un eventType di ListRetainedMessage quando ListRetainedMessagesviene chiamato.

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 AWS IoT il broker di messaggi riceve un MQTT messaggio, genera una voce di registro con un eventType diPublish-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 RETAIN flag impostato con un valore diTrue. Se il messaggio non ha il RETAIN flag impostato, 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 MQTT messaggio, genera una voce di registro con un eventType 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'MQTTargomento.

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 MQTT messaggi memorizza i messaggi del dispositivo e AWS IoT genera voci di registro con un eventType di. Queued Per ulteriori informazioni sulle sessioni MQTT persistenti, vedereSessioni 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 AWS IoT message broker genera una voce di registro con l'indicazione eventType di Subscribe quando un MQTT client sottoscrive un argomento.

MQTT3. Esempio di immissione del log di iscrizione

{
    "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. Il valore sarà sempre 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.

MQTT5 Esempio di inserimento nel registro di sottoscrizione

{
	"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 MQTT 5 operazioni di sottoscrizione, oltre ai MQTT3 attributi di immissione di registro di sottoscrizione, MQTT 5 voci di Subscribe registro contengono il seguente attributo: attributi Common CloudWatch Logs

sottoscrizioni

Un elenco di mappature tra gli argomenti richiesti nella richiesta di iscrizione e il codice individuale dei MQTT 5 motivi. Per ulteriori informazioni, consulta i codici dei MQTTmotivi.

Annulla l'iscrizione al registro

Il AWS IoT message broker genera una voce di registro con un eventType di Unsubscribe quando un MQTT client annulla l'iscrizione a un argomento. MQTT

MQTTesempio di inserimento nel registro di annullamento dell'iscrizione

{
    "timestamp": "2024-08-20 22:53:32.844",
    "logLevel": "INFO",
    "traceId": "db6bd09a-2c3f-1cd2-27cc-fd6b1ce03b58",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Unsubscribe",
    "protocol": "MQTT",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

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

protocol

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

clientId

ID del client da cui proviene la richiesta.

principalId

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

sourceIp

Indirizzo IP da cui ha avuto origine la richiesta.

sourcePort

Porta da cui ha avuto origine la richiesta.

voci di OCSP registro dei certificati del server

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

R Inserimento del registro etrieveOCSPStaple dati

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

R Esempi di immissione di log di etrieveOCSPStaple dati

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

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

domainConfigName

Il nome della configurazione del dominio.

connectionDetails

Una breve spiegazione dei dettagli della connessione.

  • httpStatusCode

    HTTPcodici di stato restituiti dal OCSP risponditore in risposta alla richiesta del client inoltrata al server.

  • ocspResponderUri

    Il OCSP URI risponditore che AWS IoT Core recupera dal certificato del server.

  • sourceIp

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

  • targetIp

    L'indirizzo IP di destinazione del OCSP risponditore.

ocspRequestDetails

Dettagli della OCSP richiesta.

  • requesterName

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

  • requestCertId

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

ocspResponseDetails

Dettagli della OCSP risposta.

  • responseCertId

    L'ID del certificato della OCSP risposta.

  • ocspResponseStatus

    Lo stato della OCSP risposta.

  • certStatus

    Stato del certificato.

  • signature

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

  • thisUpdateTime

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

  • nextUpdateTime

    L'ora o prima della quale saranno disponibili informazioni più recenti sullo stato del certificato.

  • producedAtTime

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

  • stapledDataPayloadDimensioni

    La dimensione del payload dei dati graffati.

Voci del registro Device Shadow

Il AWS IoT Il servizio 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:

deviceShadowName

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 voce di 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:

deviceShadowName

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 voce di 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:

deviceShadowName

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 AWS IoT il motore delle regole genera i log per i seguenti eventi:

FunctionExecution voce di registro

Il motore delle regole genera una voce di registro con un eventType di FunctionExecution quando la SQL query di una regola chiama una funzione esterna. Una funzione esterna viene chiamata quando l'azione di una regola effettua una HTTP richiesta a AWS IoT o un altro servizio Web (ad esempio, chiamata 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 AWS IoT rules engine 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 AWS IoT il motore di 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 registro

{
    "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, AWS IoT rules engine 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 AWS IoT rules engine 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 AWS IoT rules engine 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 AWS IoT Job service genera voci di registro per i seguenti eventi. Le voci di registro vengono generate quando viene ricevuta una HTTP richiesta MQTT or dal dispositivo.

DescribeJobExecution voce di registro

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

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 AWS IoT Il servizio 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 AWS IoT Il servizio Jobs genera una voce di registro con entryType l'indicazione di ReportFinalJobExecutionCount quando un lavoro è completato.

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 lavoro in sospeso, AWS IoT Il servizio Jobs genera una voce di registro con un eventType diStartNextPendingJobExecution.

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 AWS IoT Il servizio 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 AWS IoT Il servizio Device Provisioning genera registri per i seguenti eventi.

GetDeviceCredentials voce di registro

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

GetDeviceCredentialsesempio 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" : "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.

deviceCertificateId

L'ID del certificato del dispositivo.

ProvisionDevice voce di registro

Il AWS IoT Il servizio 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.

deviceCertificateId

L'ID del certificato del dispositivo.

provisioningTemplateName

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 AWS IoT non è stato in grado di aggiungere alcun 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:

dynamicThingGroupNomi

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

Il UTC timestamp leggibile dall'uomo di quando il client si è connesso al AWS IoT broker di messaggi.

traceId

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