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à.
Configura i CloudWatch registri per gli aggiornamenti OTA
Il servizio OTA Update supporta la registrazione con Amazon CloudWatch. Puoi utilizzare la AWS IoT console per abilitare e configurare la CloudWatch registrazione di Amazon per gli OTA aggiornamenti. Per ulteriori informazioni, consulta Cloudwatch Logs.
Per abilitare la registrazione, devi creare un IAM ruolo e configurare la registrazione degli OTA aggiornamenti.
Nota
Prima di abilitare la registrazione degli OTA aggiornamenti, assicurati di aver compreso le autorizzazioni di CloudWatch accesso ai registri. Gli utenti con accesso ai CloudWatch registri possono visualizzare le informazioni di debug. Per informazioni, consulta Autenticazione e controllo degli accessi per Amazon CloudWatch Logs.
Creare un ruolo di logging e abilitare il logging
Usa la console AWS IoT
-
Nel riquadro di navigazione scegliere Impostazioni.
-
Under Log scegliere Modifica.
-
In Livello di dettaglio scegliere Debug.
-
In Imposta ruolo, scegli Crea nuovo per creare un IAM ruolo per la registrazione.
-
In Nome immettere un nome univoco per il ruolo. Il ruolo verrà creato con tutte le autorizzazioni necessarie.
-
Scegli Aggiorna.
OTAaggiorna i registri
Il servizio di OTA aggiornamento pubblica i registri sull'account quando si verifica una delle seguenti condizioni:
-
Viene creato un OTA aggiornamento.
-
L'OTAaggiornamento è completato.
-
Viene creato un processo di firma del codice.
-
Viene completato un processo di firma del codice.
-
Viene creato un AWS IoT lavoro.
-
Un AWS IoT lavoro è completato.
-
Viene creato un flusso.
È possibile visualizzare i log nella CloudWatch console
Per visualizzare un OTA aggiornamento in Logs CloudWatch
-
Nel riquadro di navigazione scegliere Log.
-
In Gruppi di log, scegli AWSIoTLogsV2.
OTAi registri di aggiornamento possono contenere le seguenti proprietà:
- accountId
-
L'ID AWS dell'account in cui è stato generato il registro.
- actionType
-
L'operazione che ha generato il log. Può essere uno dei seguenti valori:
-
CreateOTAUpdate
: è stato creato un OTA aggiornamento. -
DeleteOTAUpdate
: è stato eliminato un OTA aggiornamento. -
StartCodeSigning
: un processo di firma del codice è stato avviato. -
CreateAWSJob
: è stato creato un AWS IoT lavoro. -
CreateStream
: un flusso è stato creato. -
GetStream
: è stata inviata una richiesta di streaming alla funzionalità di distribuzione dei file AWS IoT MQTT basata. -
DescribeStream
: è stata inviata una richiesta di informazioni su uno stream alla funzionalità di distribuzione dei file AWS IoT MQTT basata.
-
- awsJobId
-
L'ID del AWS IoT lavoro che ha generato il registro.
- clientId
-
L'ID MQTT del client che ha effettuato la richiesta che ha generato il registro.
- clientToken
-
Il token del client associato alla richiesta che ha generato il log.
- details
-
Informazioni aggiuntive sull'operazione che ha generato il log.
- logLevel
-
Il livello di registrazione del log. Per i registri degli OTA aggiornamenti, questo valore è sempre impostato
DEBUG
su. - otaUpdateId
-
L'ID dell'OTAaggiornamento che ha generato il registro.
- protocol
-
Il protocollo utilizzato per effettuare la richiesta che ha generato il log.
- status
-
Lo stato dell'operazione che ha generato il log. I valori validi sono:
-
Riuscito
-
Errore
-
- streamId
-
L'ID dello AWS IoT stream che ha generato il log.
- timestamp
-
L'orario in cui è stato generato il log.
- topicName
-
Un MQTT argomento utilizzato per effettuare la richiesta che ha generato il log.
Log di esempio
Di seguito è riportato un esempio di log generato quando viene avviato un processo di firma del codice:
{
"timestamp": "2018-07-23 22:59:44.955",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "StartCodeSigning",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "Start code signing job. The request status is SUCCESS."
}
Di seguito è riportato un esempio di log generato quando viene creato un AWS IoT lavoro:
{
"timestamp": "2018-07-23 22:59:45.363",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateAWSJob",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"awsJobId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "Create AWS Job The request status is SUCCESS."
}
Di seguito è riportato un esempio di log generato quando viene creato un OTA aggiornamento:
{
"timestamp": "2018-07-23 22:59:45.413",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateOTAUpdate",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "OTAUpdate creation complete. The request status is SUCCESS."
}
Di seguito è riportato un esempio di log generato quando viene creato un flusso:
{
"timestamp": "2018-07-23 23:00:26.391",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateStream",
"otaUpdateId": "3d3dc5f7-3d6d-47ac-9252-45821ac7cfb0",
"streamId": "6be2303d-3637-48f0-ace9-0b87b1b9a824",
"details": "Create stream. The request status is SUCCESS."
}
Di seguito è riportato un esempio di log generato quando viene eliminato un OTA aggiornamento:
{
"timestamp": "2018-07-23 23:03:09.505",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "DeleteOTAUpdate",
"otaUpdateId": "9bdd78fb-f113-4001-9675-1b595982292f",
"details": "Delete OTA Update. The request status is SUCCESS."
}
Di seguito è riportato un esempio di log generato quando un dispositivo richiede uno stream dalla funzionalità MQTT basata sulla distribuzione dei file:
{
"timestamp": "2018-07-25 22:09:02.678",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "GetStream",
"protocol": "MQTT",
"clientId": "b9d2e49c-94fe-4ed1-9b07-286afed7e4c8",
"topicName": "$aws/things/b9d2e49c-94fe-4ed1-9b07-286afed7e4c8/streams/1e51e9a8-9a4c-4c50-b005-d38452a956af/get/json",
"streamId": "1e51e9a8-9a4c-4c50-b005-d38452a956af",
"details": "The request status is SUCCESS."
}
Di seguito è riportato un esempio di log generato quando un dispositivo chiama DescribeStream
API:
{
"timestamp": "2018-07-25 22:10:12.690",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "DescribeStream",
"protocol": "MQTT",
"clientId": "581075e0-4639-48ee-8b94-2cf304168e43",
"topicName": "$aws/things/581075e0-4639-48ee-8b94-2cf304168e43/streams/71c101a8-bcc5-4929-9fe2-af563af0c139/describe/json",
"streamId": "71c101a8-bcc5-4929-9fe2-af563af0c139",
"clientToken": "clientToken",
"details": "The request status is SUCCESS."
}