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.

• Verifica l'avvio e la corretta inizializzazione dell'agente Hub. Per informazioni dettagliate, vedi Installa e convalida le integrazioni gestite Hub SDK.

Nota

Per creare configurazioni di registrazione, consulta PutRuntimeLogConfiguration API 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.

Esempio 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'RuntimeLogConfigurationsAPI.

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.

Importante

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

Nota

Se impostato su false, i file caricati vengono rinominati in: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}

File di registro di esempio

Di seguito è riportato un esempio di file CloudWatch di registro: