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à.
# Abilita CloudWatch i registri
L'Hub SDK offre funzionalità di registrazione complete. Per impostazione predefinita, Hub SDK scrive i log nel file system locale. Tuttavia, puoi sfruttare l'API cloud per configurare lo streaming dei log su CloudWatch Logs, che offre:
+ **Monitora le prestazioni del dispositivo**: acquisisci registri di runtime dettagliati per una gestione proattiva dei dispositivi. Abilita l'analisi e il monitoraggio avanzati dei log su tutta la tua flotta di dispositivi
+ **Risolvi i problemi**: genera voci di registro granulari per un'analisi diagnostica rapida. Registra gli eventi a livello di sistema e di applicazione per un'indagine approfondita.
+ **Registrazione flessibile e centralizzata: gestione remota dei registri senza accesso** diretto al dispositivo. Aggrega i log di più dispositivi in un unico archivio ricercabile.
## Prerequisiti
+ Effettua l'onboard del dispositivo gestito nel cloud. Per informazioni dettagliate, vedi [Configurazione dell'hub onboarding](managedintegrations-sdk-v2-cookbook-hubsetup.md).
+ Verifica l'avvio e la corretta inizializzazione dell'agente Hub. Per informazioni dettagliate, vedi [Installa e convalida le integrazioni gestite Hub SDK](managedintegrations-sdk-v2-cookbook-deployment.md).
**Nota**
Per creare configurazioni di registrazione, consulta [PutRuntimeLogConfiguration API](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_PutRuntimeLogConfiguration.html) per i dettagli.
**avvertimento**
L'abilitazione dei log conta ai fini della misurazione delle quote a più livelli. L'aumento dei livelli di registro comporterà un aumento del volume di messaggi e costi aggiuntivi.
## Configurazioni dei log di Setup Hub SDK
Configurate le impostazioni di registro dell'hub SDK chiamando l'API per configurare la configurazione del log di runtime.
**Example esempio di richiesta API**
```
aws iot-managed-integrations put-runtime-log-configuration \
--managed-thing-id MANAGED_THING_ID \
--runtime-log-configurations LogLevel=DEBUG,UploadLog=TRUE
```
### RuntimeLogConfigurations attributi
I seguenti attributi sono opzionali e possono essere configurati nell'`RuntimeLogConfigurations`API.
**LogLevel**
Imposta il livello di severità minimo per le tracce di runtime. Valori: `DEBUG, ERROR, INFO, WARN`
Predefinito: `WARN` (build rilasciata)
**LogFlushLevel**
Determina il livello di gravità per il trasferimento immediato dei dati nell'archiviazione locale. Valori: `DEBUG, ERROR, INFO, WARN`
Impostazione predefinita: `DISABLED`
**LocalStoreLocation**
Specifica la posizione di archiviazione per le tracce di runtime. Impostazione predefinita: `/var/log/awsiotmi`
+ Registro attivo: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.log`
+ Registri ruotati: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.N.log` (N indica l'ordine di rotazione)
**LocalStoreFileRotationMaxBytes**
Attiva la rotazione del file quando il file corrente supera la dimensione specificata.
Per un'efficienza ottimale, mantieni la dimensione del file inferiore a 125 KB. I valori superiori a 125 KB verranno automaticamente limitati.
**LocalStoreFileRotationMaxFiles,**
Imposta il numero massimo di file di rotazione consentito dal demone di log.
**UploadLog**
Controlla il trasferimento della traccia in fase di esecuzione sul cloud. I log vengono archiviati nel gruppo `/aws/iotmanagedintegration` CloudWatch Logs.
Default: `false`.
**UploadPeriodMinutes**
Definisce la frequenza dei caricamenti delle tracce in fase di esecuzione. Impostazione predefinita: `5`
**DeleteLocalStoreAfterUpload**
Controlla l'eliminazione dei file dopo il caricamento. Impostazione predefinita: `true`
Se impostato su false, i file caricati vengono rinominati in: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}`
### File di registro di esempio
Vedi l'esempio di un file di CloudWatch log di seguito:
