Gestore dei registri - AWS IoT Greengrass
VersioniTypeSistema operativoRequisitiDipendenzeConfigurazioneUtilizzoFile di registro localeChangelog

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à.

Gestore dei registri

Il componente log manager (aws.greengrass.LogManager) carica i log dai dispositivi AWS IoT Greengrass principali su Amazon CloudWatch Logs. Puoi caricare i log dal nucleo di Greengrass, da altri componenti Greengrass e da altre applicazioni e servizi che non sono componenti Greengrass. Per ulteriori informazioni su come monitorare i log in CloudWatch Logs e nel file system locale, vedere. Monitora AWS IoT Greengrass i registri

Le seguenti considerazioni si applicano quando si utilizza il componente log manager per scrivere nei registri: CloudWatch

  • Registra i ritardi

    Nota

    Si consiglia di eseguire l'aggiornamento alla versione 2.3.0 di log manager, che riduce i ritardi di registro per i file di registro ruotati e attivi. Quando esegui l'aggiornamento a log manager 2.3.0, ti consigliamo di eseguire anche l'aggiornamento a Greengrass nucleus 2.9.1.

    Il componente di log manager versione 2.2.8 (e precedenti) elabora e carica i log solo dai file di registro ruotati. Per impostazione predefinita, il software AWS IoT Greengrass Core ruota i file di registro ogni ora o dopo che hanno raggiunto i 1.024 KB. Di conseguenza, il componente log manager carica i log solo dopo che il software AWS IoT Greengrass Core o un componente Greengrass hanno scritto oltre 1.024 KB di log. È possibile configurare un limite inferiore per le dimensioni dei file di registro per far sì che i file di registro ruotino più spesso. Ciò fa sì che il componente log manager carichi i log in Logs più CloudWatch frequentemente.

    Il componente di gestione dei registri versione 2.3.0 (e successive) elabora e carica tutti i log. Quando si scrive un nuovo registro, la versione 2.3.0 (e successive) di log manager elabora e carica direttamente il file di registro attivo anziché attendere che venga ruotato. Ciò significa che è possibile visualizzare il nuovo registro in 5 minuti o meno.

    Il componente di gestione dei registri carica periodicamente nuovi registri. Per impostazione predefinita, il componente di gestione dei registri carica nuovi registri ogni 5 minuti. È possibile configurare un intervallo di caricamento inferiore, in modo che il componente log manager carichi i log in Logs più frequentemente configurando CloudWatch . periodicUploadIntervalSec Per ulteriori informazioni su come configurare questo intervallo periodico, vedere Configurazione.

    I log possono essere caricati quasi in tempo reale dallo stesso file system Greengrass. Se hai bisogno di osservare i log in tempo reale, prendi in considerazione l'utilizzo dei log del file system.

    Nota

    Se utilizzi file system diversi su cui scrivere i log, log manager torna al comportamento delle versioni 2.2.8 e precedenti dei componenti di log manager. Per informazioni sull'accesso ai log del file system, consultate Access file system logs.

  • Inclinazione dell'orologio

    Il componente log manager utilizza il processo di firma standard Signature Version 4 per creare richieste API per CloudWatch Logs. Se l'ora del sistema su un dispositivo principale non è sincronizzata per più di 15 minuti, CloudWatch Logs rifiuta le richieste. Per ulteriori informazioni, consulta la pagina relativa al processo di firma Signature Version 4 nella Riferimenti generali di AWS.

Per informazioni sui gruppi di log e sui flussi di log in cui questo componente carica i log, consulta. Utilizzo

Versioni

Questo componente ha le seguenti versioni:

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2,0x

Type

Questo componente è un componente del plugin ()aws.greengrass.plugin. Il nucleo Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.

Per ulteriori informazioni, consultare Tipi di componenti.

Sistema operativo

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

Requisiti

Questo componente presenta i seguenti requisiti:

  • Il ruolo del dispositivo Greengrass deve consentire le logs:DescribeLogStreams azionilogs:CreateLogGroup,logs:CreateLogStream, elogs:PutLogEvents,, come illustrato nel seguente esempio di policy IAM.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}
    Nota

    Il ruolo del dispositivo Greengrass che crei quando installi il software AWS IoT Greengrass Core include per impostazione predefinita le autorizzazioni di questo criterio di esempio.

    Per ulteriori informazioni, consulta Using Identity-Based Policy (IAM policies) for CloudWatch Logs nella Amazon CloudWatch Logs User Guide.

  • Il componente log manager è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.

    • Il componente di gestione dei registri deve disporre di una connettività a logs.region.amazonaws.com cui abbia l'endpoint VPC di. com.amazonaws.us-east-1.logs

Endpoint e porte

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Endpoint Porta Richiesto Descrizione

logs.region.amazonaws.com

 443 No

Obbligatorio se si scrivono log in Logs. CloudWatch

Dipendenze

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console. AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

2.3.7

La tabella seguente elenca le dipendenze per la versione 2.3.7 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.13.0 Flessibili
2.3.5 and 2.3.6

La tabella seguente elenca le dipendenze per le versioni 2.3.5 e 2.3.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.12.0 Flessibili
2.3.3 – 2.3.4

La tabella seguente elenca le dipendenze per le versioni da 2.3.3 a 2.3.4 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.11.0 Flessibili
2.2.8 – 2.3.2

La tabella seguente elenca le dipendenze per le versioni da 2.2.8 a 2.3.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.10.0 Flessibili
2.2.7

La tabella seguente elenca le dipendenze per la versione 2.2.7 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.9.0 Flessibili
2.2.6

La tabella seguente elenca le dipendenze per la versione 2.2.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.8.0 Flessibili
2.2.5

La tabella seguente elenca le dipendenze per la versione 2.2.5 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.7.0 Flessibili
2.2.1 - 2.2.4

La tabella seguente elenca le dipendenze per le versioni 2.2.1 - 2.2.4 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.6.0 Flessibili
2.1.3 and 2.2.0

La tabella seguente elenca le dipendenze per le versioni 2.1.3 e 2.2.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.5.0 Flessibili
2.1.2

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.4.0 Flessibili
2.1.1

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.3.0 Flessibili
2.1.0

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.2.0 Flessibili
2.0.x

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.3 <2.1.0 Flessibili

Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

v2.3.6 – v2.3.7
logsUploaderConfiguration

(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:

systemLogsConfiguration

(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del nucleo Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:

uploadToCloudWatch

(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.

Impostazione predefinita: false

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.

Questo parametro è equivalente al parametro log size limit (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.

diskSpaceLimitUnit

(Opzionale) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch

Impostazione predefinita: false

componentLogsConfigurationMap

(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni componentName oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente log manager carica questi registri dei componenti in Logs. CloudWatch

Importante

Consigliamo vivamente di utilizzare una sola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file con un solo file di registro in cui viene scritto attivamente quando si utilizzalogFileRegex. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati in. CloudWatch Se hai come target più file di log attivi con un'unica espressione regolare, ti consigliamo di eseguire l'aggiornamento a log manager v2.3.1 o versione successiva e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.

Nota

Se stai eseguendo l'aggiornamento da una versione di log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. componentLogsConfiguration componentLogsConfigurationMap Tuttavia, ti consigliamo vivamente di utilizzare il formato della mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul componentLogsConfiguration parametro, consulta i parametri di configurazione per la versione 2.1.x di questo componente.

componentName

La configurazione del registro per il componentNamecomponente o l'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.

Ogni oggetto contiene le seguenti informazioni:

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass registrazione su. GitHub

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.

Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.

diskSpaceLimitUnit

(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

logFileDirectoryPath

(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Default: /greengrass/v2/logs.

logFileRegex

(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella inlogFileDirectoryPath.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log hello_world\\\\w*.log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:

  • hello_world.log— Il file di registro più recente per l'applicazione Hello World.

  • hello_world_2020_12_15_17_0.log— Un vecchio file di registro per l'applicazione Hello World.

Impostazione predefinita:componentName\\\\w*.log, dove componentName è il nome del componente per questa configurazione di registro.

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch

Impostazione predefinita: false

multiLineStartPattern

(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.

Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

periodicUploadIntervalSec

(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.

Impostazione predefinita: 300 (5 minuti)

Minimo: 0.000001 (1 microsecondo)

deprecatedVersionSupport

Indica se il gestore dei registri deve utilizzare i miglioramenti della velocità di registrazione introdotti in log manager v2.3.5. Imposta il valore su cui utilizzare false i miglioramenti.

Se si imposta questo valore su false quando si esegue l'aggiornamento da log manager v2.3.1 o versioni precedenti, è possibile che vengano caricate voci di registro duplicate.

Il valore predefinito è true.

Esempio: fusione e aggiornamento della configurazione

La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei com.example.HelloWorld componenti in Logs. CloudWatch 

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "300",
  "deprecatedVersionSupport": "false"
}
Esempio: configurazione per caricare più file di registro attivi utilizzando log manager v2.3.1

La configurazione di esempio seguente è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questo esempio di configurazione specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, la configurazione caricherà anche tutti i file ruotati che corrispondono a. logFileRegex Questa configurazione di esempio è supportata in log manager v2.3.1.

{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.A": {
        "logFileRegex": "com.example.A\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
      "com.example.B": {
        "logFileRegex": "com.example.B\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "10"
}
v2.3.x
logsUploaderConfiguration

(Facoltativo) La configurazione per i log caricati dal componente log manager. Questo oggetto contiene le seguenti informazioni:

systemLogsConfiguration

(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del nucleo Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:

uploadToCloudWatch

(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.

Impostazione predefinita: false

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.

Questo parametro è equivalente al parametro log size limit (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.

diskSpaceLimitUnit

(Opzionale) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch

Impostazione predefinita: false

componentLogsConfigurationMap

(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni componentName oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente log manager carica questi registri dei componenti in Logs. CloudWatch

Importante

Consigliamo vivamente di utilizzare una sola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file con un solo file di registro in cui viene scritto attivamente quando si utilizzalogFileRegex. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati in. CloudWatch Se hai come target più file di log attivi con un'unica espressione regolare, ti consigliamo di eseguire l'aggiornamento a log manager v2.3.1 e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.

Nota

Se stai eseguendo l'aggiornamento da una versione di log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. componentLogsConfiguration componentLogsConfigurationMap Tuttavia, ti consigliamo vivamente di utilizzare il formato della mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul componentLogsConfiguration parametro, consulta i parametri di configurazione per la versione 2.1.x di questo componente.

componentName

La configurazione del registro per il componentNamecomponente o l'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.

Ogni oggetto contiene le seguenti informazioni:

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass registrazione su. GitHub

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.

Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.

diskSpaceLimitUnit

(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

logFileDirectoryPath

(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Default: /greengrass/v2/logs.

logFileRegex

(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella inlogFileDirectoryPath.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log hello_world\\\\w*.log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:

  • hello_world.log— Il file di registro più recente per l'applicazione Hello World.

  • hello_world_2020_12_15_17_0.log— Un vecchio file di registro per l'applicazione Hello World.

Impostazione predefinita:componentName\\\\w*.log, dove componentName è il nome del componente per questa configurazione di registro.

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch

Impostazione predefinita: false

multiLineStartPattern

(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.

Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

periodicUploadIntervalSec

(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.

Impostazione predefinita: 300 (5 minuti)

Minimo: 0.000001 (1 microsecondo)

Esempio: fusione e aggiornamento della configurazione

La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei com.example.HelloWorld componenti in Logs. CloudWatch 

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "300"
}
Esempio: configurazione per caricare più file di registro attivi utilizzando log manager v2.3.1

La configurazione di esempio seguente è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questo esempio di configurazione specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, la configurazione caricherà anche tutti i file ruotati che corrispondono a. logFileRegex Questa configurazione di esempio è supportata in log manager v2.3.1.

{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.A": {
        "logFileRegex": "com.example.A\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
      "com.example.B": {
        "logFileRegex": "com.example.B\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "10"
}
v2.2.x
logsUploaderConfiguration

(Facoltativo) La configurazione per i log caricati dal componente log manager. Questo oggetto contiene le seguenti informazioni:

systemLogsConfiguration

(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del nucleo Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:

uploadToCloudWatch

(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.

Impostazione predefinita: false

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.

Questo parametro è equivalente al parametro log size limit (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.

diskSpaceLimitUnit

(Opzionale) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch

Impostazione predefinita: false

componentLogsConfigurationMap

(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni componentName oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente log manager carica questi registri dei componenti in Logs. CloudWatch

Nota

Se stai eseguendo l'aggiornamento da una versione di log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. componentLogsConfiguration componentLogsConfigurationMap Tuttavia, ti consigliamo vivamente di utilizzare il formato della mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul componentLogsConfiguration parametro, consulta i parametri di configurazione per la versione 2.1.x di questo componente.

componentName

La configurazione del registro per il componentNamecomponente o l'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.

Ogni oggetto contiene le seguenti informazioni:

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass registrazione su. GitHub

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.

Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.

diskSpaceLimitUnit

(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

logFileDirectoryPath

(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Default: /greengrass/v2/logs.

logFileRegex

(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella inlogFileDirectoryPath.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log hello_world\\\\w*.log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:

  • hello_world.log— Il file di registro più recente per l'applicazione Hello World.

  • hello_world_2020_12_15_17_0.log— Un vecchio file di registro per l'applicazione Hello World.

Impostazione predefinita:componentName\\\\w*.log, dove componentName è il nome del componente per questa configurazione di registro.

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch

Impostazione predefinita: false

multiLineStartPattern

(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.

Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

periodicUploadIntervalSec

(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.

Impostazione predefinita: 300 (5 minuti)

Minimo: 0.000001 (1 microsecondo)

Esempio: fusione e aggiornamento della configurazione

La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei com.example.HelloWorld componenti in Logs. CloudWatch 

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "300"
}
v2.1.x
logsUploaderConfiguration

(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:

systemLogsConfiguration

(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del nucleo Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:

uploadToCloudWatch

(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.

Impostazione predefinita: false

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.

Questo parametro è equivalente al parametro log size limit (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.

diskSpaceLimitUnit

(Opzionale) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch

Impostazione predefinita: false

componentLogsConfiguration

(Facoltativo) Un elenco di configurazioni di registro per i componenti del dispositivo principale. Ogni configurazione in questo elenco definisce la configurazione del registro per un componente o un'applicazione. Il componente log manager carica questi registri dei componenti in Logs CloudWatch

Ogni oggetto contiene le seguenti informazioni:

componentName

Il nome del componente o dell'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass registrazione su. GitHub

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.

Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.

diskSpaceLimitUnit

(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

logFileDirectoryPath

(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Default: /greengrass/v2/logs.

logFileRegex

(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella inlogFileDirectoryPath.

Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).

Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log hello_world\\\\w*.log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:

  • hello_world.log— Il file di registro più recente per l'applicazione Hello World.

  • hello_world_2020_12_15_17_0.log— Un vecchio file di registro per l'applicazione Hello World.

Impostazione predefinita:componentName\\\\w*.log, dove componentName è il nome del componente per questa configurazione di registro.

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch

Impostazione predefinita: false

multiLineStartPattern

(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.

Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

periodicUploadIntervalSec

(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.

Impostazione predefinita: 300 (5 minuti)

Minimo: 0.000001 (1 microsecondo)

Esempio: fusione e aggiornamento della configurazione

La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei com.example.HelloWorld componenti in Logs. CloudWatch 

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfiguration": [
      {
        "componentName": "com.example.HelloWorld",
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    ]
  },
  "periodicUploadIntervalSec": "300"
}
v2.0.x
logsUploaderConfiguration

(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:

systemLogsConfiguration

(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core. Specificate questa configurazione per consentire al componente di gestione dei log di gestire i registri di sistema. Questo oggetto contiene le seguenti informazioni:

uploadToCloudWatch

(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.

Impostazione predefinita: false

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.

Questo parametro è equivalente al parametro log size limit (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.

diskSpaceLimitUnit

(Opzionale) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch

Impostazione predefinita: false

componentLogsConfiguration

(Facoltativo) Un elenco di configurazioni di registro per i componenti del dispositivo principale. Ogni configurazione in questo elenco definisce la configurazione del registro per un componente o un'applicazione. Il componente log manager carica questi registri dei componenti in Logs CloudWatch

Ogni oggetto contiene le seguenti informazioni:

componentName

Il nome del componente o dell'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.

minimumLogLevel

(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, che puoi trovare nel repository del modulo di AWS IoT Greengrass registrazione su. GitHub

Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Impostazione predefinita: INFO

diskSpaceLimit

(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.

Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.

diskSpaceLimitUnit

(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:

  • KB— kilobyte

  • MB— megabyte

  • GB— gigabyte

Impostazione predefinita: KB

logFileDirectoryPath

Il percorso della cartella che contiene i file di registro di questo componente.

Per caricare i log di un componente Greengrass/greengrass/v2/logs, specificate e sostituiteli con /greengrass/v2 la cartella principale di Greengrass.

logFileRegex

Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella inlogFileDirectoryPath.

Per caricare i log di un componente Greengrass, specifica un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log com.example.HelloWorld\\w*.log per un componente Hello World. Il \\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:

  • com.example.HelloWorld.log— Il file di registro più recente per il componente Hello World.

  • com.example.HelloWorld_2020_12_15_17_0.log— Un vecchio file di registro per il componente Hello World. Il nucleo Greengrass aggiunge un timestamp rotante ai file di registro.

deleteLogFileAfterCloudUpload

(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch

Impostazione predefinita: false

multiLineStartPattern

(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.

Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

periodicUploadIntervalSec

(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.

Impostazione predefinita: 300 (5 minuti)

Minimo: 0.000001 (1 microsecondo)

Esempio: fusione e aggiornamento della configurazione

La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei com.example.HelloWorld componenti in Logs. CloudWatch 

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfiguration": [
      {
        "componentName": "com.example.HelloWorld",
        "minimumLogLevel": "INFO",
        "logFileDirectoryPath": "/greengrass/v2/logs",
        "logFileRegex": "com.example.HelloWorld\\w*.log",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    ]
  },
  "periodicUploadIntervalSec": "300"
}

Utilizzo

Il componente log manager viene caricato nei seguenti gruppi di log e flussi di log.

2.1.0 and later
Nome del gruppo di log
/aws/greengrass/componentType/region/componentName

Il nome del gruppo di log utilizza le seguenti variabili:

  • componentType— Il tipo di componente, che può essere uno dei seguenti:

    • GreengrassSystemComponent— Questo gruppo di log include i log per i componenti del nucleo e del plugin, che vengono eseguiti nella stessa JVM del nucleo Greengrass. Il componente fa parte del nucleo Greengrass.

    • UserComponent— Questo gruppo di log include i registri per componenti generici, componenti Lambda e altre applicazioni sul dispositivo. Il componente non fa parte del nucleo Greengrass.

    Per ulteriori informazioni, consulta Tipi di componenti.

  • region— La AWS regione utilizzata dal dispositivo principale.

  • componentName— Il nome del componente. Per i registri di sistema, questo valore èSystem.

Nome del flusso di log
/date/thing/thingName

Il nome del flusso di registro utilizza le seguenti variabili:

  • date— La data del registro, ad esempio2020/12/15. Il componente log manager utilizza il yyyy/MM/dd formato.

  • thingName— Il nome del dispositivo principale.

Nota

Se il nome di un oggetto contiene due punti (:), il gestore dei registri sostituisce i due punti con un segno più (+).

2.0.x
Nome del gruppo di log
/aws/greengrass/componentType/region/componentName

Il nome del gruppo di log utilizza le seguenti variabili:

  • componentType— Il tipo di componente, che può essere uno dei seguenti:

    • GreengrassSystemComponent— Il componente fa parte del nucleo Greengrass.

    • UserComponent— Il componente non fa parte del nucleo Greengrass. Il gestore dei registri utilizza questo tipo per i componenti Greengrass e altre applicazioni sul dispositivo.

  • region— La AWS regione utilizzata dal dispositivo principale.

  • componentName— Il nome del componente. Per i registri di sistema, questo valore èSystem.

Nome del flusso di log
/date/deploymentTargets/thingName

Il nome del flusso di registro utilizza le seguenti variabili:

  • date— La data del registro, ad esempio2020/12/15. Il componente log manager utilizza il yyyy/MM/dd formato.

  • deploymentTargets— Le cose le cui distribuzioni includono il componente. Il componente log manager separa ogni destinazione con una barra. Se il componente viene eseguito sul dispositivo principale come risultato di una distribuzione locale, questo valore è. LOCAL_DEPLOYMENT

    Si consideri un esempio in cui si dispone di un dispositivo principale denominato MyGreengrassCore e il dispositivo principale ha due distribuzioni:

    • Una distribuzione destinata al dispositivo principale,. MyGreengrassCore

    • Una distribuzione destinata a un gruppo di oggetti denominatoMyGreengrassCoreGroup, che contiene il dispositivo principale.

    I deploymentTargets per questo dispositivo principale sonothing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup.

  • thingName— Il nome del dispositivo principale.

Formati per le voci di registro.

Il nucleo Greengrass scrive i file di registro in formato stringa o JSON. Per i log di sistema, è possibile controllare il formato impostando il format campo della voce. logging Puoi trovare la logging voce nel file di configurazione del componente Greengrass nucleus. Per ulteriori informazioni, vedere Greengrass nucleus configuration.

Il formato di testo è in formato libero e accetta qualsiasi stringa. Il seguente messaggio del servizio Fleet Status è un esempio di registrazione in formato stringa:

2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2)
com.aws.greengrass.status.FleetStatusService: fss-status-update-published. 
Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService, 
currentState=RUNNING}

È necessario utilizzare il formato JSON se si desidera visualizzare i log con il comando Greengrass CLI logs o interagire con i log a livello di codice. L'esempio seguente delinea la forma JSON:

{
   "loggerName": <string>,
   "level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
   "eventType": <string, optional>,
   "cause": <string, optional>,
   "contexts": {},
   "thread": <string>,
   "message": <string>,
   "timestamp": <epoch time> # Needs to be epoch time
}

Per controllare l'output dei log del componente, puoi utilizzare l'minimumLogLevelopzione di configurazione. Per utilizzare questa opzione, il componente deve scrivere le sue voci di registro in formato JSON. È necessario utilizzare lo stesso formato del file di registro di sistema.

File di registro locale

Questo componente utilizza lo stesso file di registro del componente Greengrass nucleus.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente

  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

La tabella seguente descrive le modifiche in ogni versione del componente.

Versione

Modifiche

2.3.7

Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.

2.3.6
Correzioni di bug e miglioramenti

  • Regola i livelli di registro per determinati errori.

2.3.5
Miglioramenti

Migliora la velocità di caricamento dei log.

Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.

2.3.4
Correzioni di bug e miglioramenti

  • Aggiunge il supporto per l'impostazione del periodicUploadIntervalSec parametro su valori frazionari. Il valore minimo è 1 microsecondo.

  • Risolve un problema per cui il gestore dei registri non rispetta i CloudWatch putLogEvents limiti.

2.3.3

Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.

2.3.2
Correzioni di bug e miglioramenti

  • Migliora la gestione dello spazio in modo che i file di registro non vengano eliminati prima di essere caricati.

  • Risolve i problemi relativi alla gestione della cache.

  • Correzioni e miglioramenti aggiuntivi di bug minori.

2.3.1
Correzioni di bug e miglioramenti

  • Risolve un problema in cui i gruppi di file di destinazione con più file di registro attivi caricavano voci duplicate. CloudWatch

  • Correzioni e miglioramenti aggiuntivi di bug minori.

2.3.0
Nota

Si consiglia di eseguire l'aggiornamento a Greengrass nucleus 2.9.1 quando si esegue l'aggiornamento a log manager 2.3.0.

Nuove funzionalità

Riduce i ritardi nei log elaborando e caricando direttamente i file di registro attivi anziché attendere la rotazione dei nuovi file.

Correzioni di bug e miglioramenti

  • Migliora il supporto della rotazione dei log durante la rotazione di file con un nome univoco.

  • Correzioni e miglioramenti aggiuntivi di bug minori.

2.2.8

 Versione aggiornata per la versione 2.9.0 di Greengrass nucleus.

2.2.7

 Versione aggiornata per la versione 2.8.0 di Greengrass nucleus.

2.2.6

Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.

2.2.5

Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.

2.2.4
Correzioni di bug e miglioramenti

  • Migliora la stabilità nella gestione di configurazioni non valide.

  • Correzioni e miglioramenti minori aggiuntivi.

2.2.3
Correzioni di bug e miglioramenti

  • Migliora la stabilità in alcuni scenari in cui il componente si riavvia o riscontra errori.

  • Risolve i problemi relativi al mancato caricamento di messaggi di registro e file di registro di grandi dimensioni in determinati scenari.

  • Risolve i problemi relativi al modo in cui questo componente gestisce gli aggiornamenti di ripristino della configurazione.

  • Risolve un problema a causa del quale un valore null diskSpaceLimit di configurazione impediva la distribuzione del componente.

2.2.2
Correzioni di bug e miglioramenti

  • Aggiunge il supporto per i messaggi di registro di dimensioni superiori a 256 kilobyte. Il componente di gestione dei log divide questi messaggi di registro di grandi dimensioni in più messaggi con lo stesso timestamp degli eventi di registro.

2.2.1

Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.

2.2.0
Nuova caratteristica

  • Aggiunge il parametro componentLogsConfigurationMap di configurazione per supportare un formato di mappa per le configurazioni dei registri dei componenti. Ogni componentName oggetto nella mappa definisce la configurazione del registro per un componente o un'applicazione.

2.1.3

Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.

2.1.2

Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.

2.1.1
Correzioni di bug e miglioramenti

  • Risolve un problema per cui la configurazione del registro di sistema non veniva aggiornata in alcuni casi.

2.1.0
Correzioni di bug e miglioramenti

  • Usa i valori predefiniti per logFileDirectoryPath e logFileRegex che funzionano per i componenti Greengrass che stampano su output standard (stdout) ed errore standard (stderr).

  • Indirizza correttamente il traffico attraverso un proxy di rete configurato durante il caricamento dei log su Logs. CloudWatch

  • Gestisci correttamente i due punti (:) nei nomi dei flussi di log. CloudWatch I nomi dei flussi di log non supportano i due punti.

  • Semplifica i nomi dei flussi di log rimuovendo i nomi dei gruppi di oggetti dal flusso di log.

  • Rimuove un messaggio di registro degli errori che viene stampato durante il normale comportamento.

2.0.x

Versione iniziale.