Configurare la registrazione AWS IoT

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 AWS IoT configurare la registrazione:

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

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

3. Configura la registrazione a livello di account: la registrazione a livello di account si applica a tutto il tuo AWS IoT parco dispositivi (dispositivi o endpoint), a meno che non venga sostituita da impostazioni a livello di evento o di risorsa.

   1. In Registrazione a livello di account, seleziona Gestisci la registrazione a livello di account per effettuare gli aggiornamenti.

   2. Seleziona la casella di controllo «Abilita registrazione» a cui iniziare a inviare i log. CloudWatch Se l'opzione «Abilita registrazione» è deselezionata, non AWS IoT invierà alcun registro ai gruppi di CloudWatch log, indipendentemente dalle configurazioni di 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. Scegliete il livello di registro predefinito che corrisponde al livello di dettaglio delle voci di registro che desiderate 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. Scegliete Aggiorna registrazione per salvare le modifiche.

4. La registrazione a livello di evento consente di acquisire selettivamente i registri degli eventi pertinenti e di indirizzarli a gruppi di log dedicati. CloudWatch Ciò offre la flessibilità necessaria per organizzare i log in base ai casi d'uso per una migliore individuabilità, condividerli con diversi destinatari e ridurre i CloudWatch costi abilitando i log e impostando i livelli di registro 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 hanno la precedenza sulla registrazione a livello di account.

   1. Nella sezione Registrazione a livello di evento, seleziona Gestisci 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 è configurata la registrazione specifica per una risorsa, ha la precedenza sulle impostazioni a livello di account ed evento.

   3. Per modificare le impostazioni per i singoli eventi, fate 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 politica del ruolo AWS IoT impedirà la scrittura di 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 Update Logging per applicare le modifiche o scegli Annulla per eliminarle.

5. Configura le sostituzioni specifiche della risorsa: le sostituzioni specifiche della risorsa 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. La configurazione di registrazione specifica della risorsa ha la precedenza sulle impostazioni a livello di account e 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 della risorsa nella sezione Sostituzioni specifiche della risorsa.

   2. Scegliete una destinazione del log: Thing group, Source IP, Client ID o Principal ID.

   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 Livello di registro specifico della risorsa.

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

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

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 AWS IoT il permesso di scrivere nei log in Logs. CloudWatch La configurazione Role-ARN è richiesta per la configurazione iniziale.

   --default-log-level

   Il livello di log da usare. I valori validi sono:ERROR,, WARNINFO, DEBUG o. DISABLED Default-log-levella configurazione è richiesta per la configurazione iniziale.

   --no-disable-all-logs

   Un parametro opzionale che abilita tutte le AWS IoT 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 è facoltativo e consente di personalizzare le impostazioni di registrazione per singoli tipi di eventi:

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

   • LogLevel: sovrascrive 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 ogni 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 le sostituzioni specifiche della risorsa 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-levelil comando per configurare le sostituzioni specifiche della risorsa. Vedi il seguente esempio 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.