Configura AWS IoT logging

1. In Select trusted entity (Seleziona un'entità attendibile), scegli AWS Service. Quindi scegli IoT in Use case (Caso d'uso). Se IoT non viene visualizzata, entra e cerca IoT dal menu a discesa Casi d'uso per altri servizi AWS :. Seleziona Avanti.

2. Nella pagina Add permissions (Aggiungi autorizzazioni), vengono visualizzate le policy che sono automaticamente collegate al ruolo di servizio. Scegli Next (Successivo).

3. Nella pagina Name, review, and create (Nomina, verifica e crea), immetti Role name (Nome ruolo) e Role description (Descrizione ruolo) per il ruolo, quindi scegli Create role (Crea ruolo).

Per configurare AWS IoT registrazione:

1. Accedi alla AWS IoT console. Per ulteriori informazioni, consulta Apri il AWS IoT console.

2. Nel riquadro di navigazione a sinistra, scegli Registri (in precedenza era una sezione in Impostazioni).

3. Configura la registrazione a livello di account: la registrazione a livello di account si applica a tutta la tua AWS IoT flotta (dispositivi o endpoint), a meno che non venga sostituita da impostazioni a livello di evento o specifiche delle risorse.

   1. Account-level Nella sezione Registrazione, seleziona Gestisci la registrazione a livello di account per effettuare gli aggiornamenti.

   2. Seleziona la casella di controllo «Abilita registrazione» per iniziare a inviare i log a. CloudWatch Se «Abilita registrazione» è deselezionata, non AWS IoT invierà alcun registro ai gruppi di log, indipendentemente dalle configurazioni di CloudWatch registrazione a livello di evento o di risorsa.

   3. In IAM log role, seleziona un ruolo esistente dall'elenco a discesa. Puoi visualizzare i dettagli del ruolo per controllare le autorizzazioni del ruolo. In alternativa, seleziona Crea nuovo ruolo per configurare un nuovo ruolo IAM. Il ruolo di registrazione fornisce politiche che consentono di AWS IoT inviare voci di registro per tuo CloudWatch conto. Se si configura la registrazione a livello di evento con un gruppo di CloudWatch log personalizzato, è necessario aggiornare la politica del ruolo per includere l'ARN per questo gruppo di log.

   4. Scegli il livello di registro predefinito che corrisponde al livello di dettaglio delle voci di registro che desideri visualizzare nei registri. CloudWatch Nota: il livello di registro «DEBUG» fornisce il maggior numero di dettagli ma aumenta CloudWatch i costi. CloudWatch le destinazioni dei gruppi di log non possono essere configurate a livello di account. Tuttavia, è possibile specificare gruppi di log personalizzati per singoli tipi di eventi come descritto nella sezione seguente.

   5. Scegli Aggiorna registrazione per salvare le modifiche.

4. Event-level la registrazione consente di acquisire selettivamente i registri degli eventi pertinenti e indirizzarli a gruppi di log dedicati CloudWatch . Ciò offre la flessibilità di organizzare i log per casi d'uso per una migliore rilevabilità, condividerli con destinatari diversi e ridurre CloudWatch i costi abilitando i log e impostando i livelli di log in base alla criticità degli eventi.

   Configura la registrazione a livello di evento: la registrazione a livello di evento acquisisce eventi specifici, come i tentativi di autenticazione del client. AWS IoT Queste impostazioni sostituiscono la registrazione. Account-Level

   1. Nella sezione Event-level registrazione, seleziona Gestisci la registrazione a livello di evento per effettuare gli aggiornamenti.

   2. Per impostazione predefinita, i tipi di eventi ereditano la configurazione di registrazione a livello di account. Nota: quando la registrazione specifica della risorsa è configurata, sostituisce le impostazioni a livello di account ed evento.

   3. Per modificare le impostazioni per singoli eventi, fai clic sul valore nella riga dell'evento corrispondente. È possibile regolare sia il livello di registro che la destinazione del gruppo di CloudWatch log. Quando si specifica una destinazione personalizzata per un gruppo di CloudWatch log, è necessario verificare che la policy del ruolo IAM includa le autorizzazioni per il nuovo gruppo di log. Il mancato aggiornamento della policy sui ruoli AWS IoT impedirà la scrittura dei log nel gruppo di log personalizzato. Dopo aver effettuato la selezione, fai clic sul segno di spunta per confermare la scelta. La colonna «È modificato» mostrerà «Sì» per indicare le modifiche in sospeso.

   4. Fai clic su Aggiorna registrazione per applicare le modifiche o scegli Annulla per annullare.

5. Configura le Resource-specific sostituzioni: le Resource-specific sostituzioni applicano un'impostazione di registrazione alle risorse selezionate. Una risorsa può essere un gruppo di oggetti, un IP di origine, un ID client o un ID principale. Resource-specific la configurazione di registrazione sostituisce le impostazioni a livello di account e a livello di evento. Se abilitata, genera registri per tutti i tipi di eventi al livello di registrazione configurato per le risorse specificate. Ad esempio, è possibile impostare la registrazione a livello di debug per un oggetto specifico mantenendo la registrazione a livello di informazioni per tutti gli altri oggetti.

   1. Seleziona Aggiungi sostituzioni specifiche per le risorse nella sezione Sostituzioni. Resource-specific

   2. Scegli una destinazione del registro: gruppo di oggetti, IP di origine, ID client o ID principale.

   3. Immettete il valore di destinazione del log corrispondente per il tipo di destinazione selezionato.

   4. Seleziona il livello di registro desiderato dal menu a discesa nella sezione del livello di Resource-specific registro.

   5. Fai clic su Invia per aggiungere l'override o su Annulla per annullare le modifiche.

   6. Per modificare una sostituzione specifica per una risorsa esistente, seleziona la casella di controllo accanto alla risorsa e fai clic su «Rimuovi» per eliminare l'override o su «Modifica» per modificarla.

Per utilizzare la CLI per configurare la registrazione predefinita per AWS IoT

1. Usa il comando set-v2-logging-options per impostare le opzioni di logging per l'account.

   aws iot set-v2-logging-options \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

   dove:

   --role-arn

   Il ruolo ARN che concede l' AWS IoT autorizzazione a scrivere nei tuoi log in Logs. CloudWatch Role-arn la configurazione è necessaria per la configurazione iniziale.

   --default-log-level

   Il livello di log da usare. I valori validi sono: ERRORWARN,INFO,DEBUG, oDISABLED. Default-log-level la configurazione è richiesta per la configurazione iniziale.

   --no-disable-all-logs

   Un parametro opzionale che abilita tutte AWS IoT le registrazioni. Utilizzare questo parametro per abilitare la registrazione quando è attualmente disattivata.

   --disable-all-logs

   Un parametro opzionale che disabilita tutte le AWS IoT registrazioni. Utilizzare questo parametro per disabilitare la registrazione quando è attualmente abilitata.

   --event-configurations

   Questo parametro è opzionale e consente di personalizzare le impostazioni di registrazione per i singoli tipi di eventi:

   • eventType: il tipo di evento che sostituisce l'impostazione a livello di account

   • logLevel: sostituisci l'impostazione a livello di account con DEBUG, INFO, ERROR, WARN o DISABLED

   • logDestination: specifica un gruppo di log personalizzato per la consegna dei log CloudWatch

   È possibile configurare il livello di registrazione e la destinazione del registro in modo indipendente per ciascun tipo di evento. Se non specificato, gli eventi erediteranno le impostazioni a livello di account

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

2. Utilizzare il comando get-v2-logging-options per ottenere le opzioni di registrazione correnti.

   aws iot get-v2-logging-options \
       --verbose

   dove:

   --verbose

   Un parametro opzionale che consente di recuperare tutti gli EventTypes e le relative configurazioni.

Per utilizzare la CLI per configurare Resource-specific le sostituzioni per AWS IoT

1. Abilita la registrazione a livello di account prima di configurare la registrazione specifica della risorsa utilizzando il seguente comando: comando aws iot set-v2-logging-options

2. Usa set-v2-logging-level il comando Resource-specific per configurare le sostituzioni. Vedi l'esempio seguente per la configurazione del gruppo di oggetti:

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   Il tipo e il nome della risorsa per cui stai configurando il logging. Il valore targetType deve essere uno dei seguenti: THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID. Il valore del parametro log-target può essere testo, come illustrato nell'esempio di comando precedente, o una stringa JSON, ad esempio nell'esempio seguente.

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   Livello di logging usato durante la generazione di log per la risorsa specificata. I valori validi sono: DEBUG, INFO, ERROR, WARN e DISABLED.

3. Utilizzare il comando list-v2-logging-levels per elencare i livelli di registrazione attualmente configurati.

   aws iot list-v2-logging-levels

4. Utilizza il comando delete-v2-logging-level per eliminare un livello di registrazione specifico delle risorse, come negli esempi seguenti.

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --target-type

   Il valore target-type deve essere uno dei seguenti: THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID.

   --target-name

   Nome del gruppo di oggetti per il quale rimuovere il livello di registrazione.