Come posso configurare le impostazioni di registrazione predefinite per AWS IoT Core?

Breve descrizione

**Nota:**Questo articolo si riferisce solo alla seconda parte dei log di AWS IoT Core.

È consigliabile impostare la registrazione predefinita su un livello di verbosità basso per AWS IoT Core e configurare la registrazione specifica delle risorse su un livello di verbosità più elevato. I livelli di verbosità del registro includono DISABLED (il più basso), ERROR, WARN, INFO e DEBUG (il più alto).

**Importante:**A seconda delle dimensioni della flotta di AWS IoT Core, l'attivazione di livelli di log più dettagliati può comportare costi elevati e rendere più difficile la risoluzione dei problemi. L'attivazione di livelli di registro più dettagliati crea anche un traffico di dati più elevato. È consigliabile utilizzare INFO o DEBUG solo come misura temporanea durante la risoluzione dei problemi. Una volta completata la risoluzione dei problemi, ripristina i livelli di registrazione a un'impostazione meno dettagliata.

Risoluzione

Prerequisito

Assicurati di avere l'interfaccia a riga di comando AWS (AWS CLI) installata localmente con le credenziali di autorizzazione dell'amministratore IoT. La regione AWS predefinita per l'interfaccia a riga di comando di AWS deve puntare verso la regione AWS di destinazione. Devi avere client connessi e che interagiscono con i tuoi endpoint AWS IoT Core, come oggetti IoT registrati o non registrati.

**Nota:**Se ricevi errori durante l'esecuzione dei comandi dell'interfaccia a riga di comando di AWS, assicurati di utilizzare la versione più recente dell'interfaccia a riga di comando di AWS.

Imposta i livelli di registrazione predefiniti

Impostando il livello di registrazione predefinito per i log di AWS IoT su ERROR o WARN, puoi esaminare gli errori o gli avvisi di registro quando si verificano.

**Nota:**Se richiedi assistenza ad AWS Support, devi fornire i log di AWS IoT Core per la risoluzione dei problemi. Queste informazioni sono considerate dati dei clienti e non sono accessibili da AWS Support.

1. Esegui il comando AWS CLI** list-v2-logging-levels** per trovare le configurazioni dei livelli di registrazione attualmente applicate:

aws iot list-v2-logging-levels

Riceverai un errore NotConfiguredException se i log di AWS IoT non sono configurati perché non è stato impostato alcun livello di registrazione.

Se i log di AWS IoT Core sono configurati ma disattivati, riceverai un output simile al seguente:

{
 "logTargetConfigurations": [
 {
 "logTarget": {
 "targetType": "DEFAULT"
 },
 "logLevel": "DISABLED"
 }
 ]
}

2. Esegui il seguente comando per confermare il ruolo AWS Identity and Access Management (IAM) attualmente configurato per i log di AWS IoT Core:

aws iot get-v2-logging-options

Riceverai un output simile al seguente se è configurato un ruolo IAM:

{
"roleArn": "arn:aws:iam::123456789012:role/service-role/iot-log-role",
"defaultLogLevel": "DISABLED",
"disableAllLogs": false
}

**Nota:**Se non è configurato un ruolo IAM, AWS IoT Core non può inviare log ad Amazon CloudWatch e questa funzionalità non è disponibile per l'uso.

3. Imposta la registrazione predefinita di AWS IoT Core su uno dei livelli di registrazione meno dettagliati come ERROR o WARN. Questa operazione può essere eseguita utilizzando la console AWS IoT o l'interfaccia a riga di comando di AWS:

**Nota:**Se stai risolvendo un problema e non disponi di attributi client specifici, puoi impostare temporaneamente il livello di registrazione predefinito su DEBUG. L'impostazione del livello su DEBUG genera costi e traffico di dati significativi, a seconda delle dimensioni della flotta e della durata impiegata a questo livello.

Console AWS IoT

1. Accedi alla console AWS IoT. **Nota:**Assicurati di scegliere la regione AWS che desideri configurare.

2. Nel pannello di navigazione, scegli** Impostazioni**.

3. In** Registri**, scegli** Gestisci registri**.

4. In** Registra ruolo**, scegli** Crea ruolo**. Inserisci un nome per il ruolo, quindi scegli** Crea**.

5. In Livello di registro, scegli uno dei livelli di registrazione meno dettagliati (ERROR o WARN).

6. Scegli** Aggiorna**.

7. Apri la console IAM.

8. Nel riquadro di navigazione, scegli** Ruoli**.

9. Inserisci il nome del ruolo di registro che hai creato nella casella di ricerca, quindi seleziona il ruolo.

10. In** Riepilogo**, annota l'ARN del ruolo di registro. Sarà simile aarn:aws:iam::123456789012:role/service-role/iot-log-role.

RIGA DI COMANDO AWS

1. Crea un ruolo IAM con una policy IAM specifica da utilizzare per il tuo servizio di log di AWS IoT Core.

2. Esegui il comando seguente per impostare il livello di registrazione predefinito su WARN:

aws iot set-v2-logging-options \
 --role-arn arn:aws:iam::123456789012:role/service-role/iot-log-role \
 --default-log-level WARN

Nota:In questo esempio, sostituisci\ --role-arn con l'ARN del ruolo IAM che hai creato. Sostituisci** WARN** con il livello di registrazione che desideri impostare come livello predefinito.

3. Esegui il comando seguente per confermare che le modifiche si riflettano nei livelli di registrazione:

aws iot list-v2-logging levels

L'output è simile al seguente messaggio:

{
 "logTargetConfigurations": [
 {
 "logTarget": {
 "targetType": "DEFAULT"
 },
 "logLevel": "WARN"
 }
 ]
}

4. Esegui il comando seguente per confermare che le modifiche si riflettano sulle opzioni di registrazione:

aws iot list-v2-logging-options

L'output è simile al seguente messaggio:

{
 "roleArn": "arn:aws:iam::123456789012:role/service-role/iot-log-role",
 "defaultLogLevel": "WARN",
 "disableAllLogs": false
}

Monitora i log generati

È consigliabile monitorare i log IoT per individuare eventuali problemi o problemi. Puoi utilizzare la console Amazon CloudWatch Logs o l'interfaccia a riga di comando di AWS per monitorare i log di AWS IoT Core. Per ulteriori informazioni, consulta la sezione «Monitoraggio delle voci di registro» di Come posso gestire al meglio i livelli di registrazione dei miei log AWS IoT in AWS IoT Core?

Informazioni correlate

Monitoraggio AWS IoT

Come posso configurare i livelli di registrazione in modo dinamico per risorse specifiche in AWS IoT Core?

Come posso configurare manualmente i livelli di registrazione per risorse specifiche in AWS IoT Core?