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
**avvertimento**
Si consiglia l'aggiornamento a Log Manager v2.3.5 o versione successiva. La versione 2.3.5 ottimizza le scritture di configurazione di Log Manager, riducendo le operazioni di IO e migliorando la velocità di caricamento dei log, le prestazioni complessive del dispositivo e possibilmente prolungandone la durata.
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](monitor-logs.md)
Le seguenti considerazioni si applicano quando si utilizza il componente log manager per scrivere nei registri: CloudWatch
+ **Registra i ritardi**
La versione 2.2.8 (e precedenti) del componente di gestione dei log 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 il CloudWatch . `periodicUploadIntervalSec` [Per ulteriori informazioni su come configurare questo intervallo periodico, vedere Configurazione.](https://docs.aws.amazon.com/greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration)
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](monitor-logs.md#access-local-logs).
**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](https://docs.aws.amazon.com/greengrass/v2/developerguide/monitor-logs.html#access-local-logs) 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](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) 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](#log-manager-component-usage)
**Topics**
+ [Versioni](#log-manager-component-versions)
+ [Tipo](#log-manager-component-type)
+ [Sistema operativo](#log-manager-component-os-support)
+ [Requisiti](#log-manager-component-requirements)
+ [Dipendenze](#log-manager-component-dependencies)
+ [Configurazione](#log-manager-component-configuration)
+ [Utilizzo](#log-manager-component-usage)
+ [File di registro locale](#log-manager-component-log-file)
+ [Changelog](#log-manager-component-changelog)
## Versioni
Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Tipo
Questo componente è un componente del plugin (`aws.greengrass.plugin`). Il [nucleo Greengrass](greengrass-nucleus-component.md) 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](monitor-logs.md).
Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).
## 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](device-service-role.md) deve consentire le `logs:DescribeLogStreams` azioni`logs:CreateLogGroup`,`logs:CreateLogStream`, e`logs: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](device-service-role.md) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-identity-based-access-control-cwl.html) 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](allow-device-traffic.md).
| Endpoint | Porta | Richiesto | Description |
| --- | --- | --- | --- |
| `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](#log-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.
------
#### [ 2.3.11 ]
La tabella seguente elenca le dipendenze per la versione 2.3.11 di questo componente.
| Dipendenza | Versioni compatibili | Tipo di dipendenza |
| --- | --- | --- |
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.17.0 | Flessibili |
------
#### [ 2.3.10 ]
La tabella seguente elenca le dipendenze per la versione 2.3.10 di questo componente.
| Dipendenza | Versioni compatibili | Tipo di dipendenza |
| --- | --- | --- |
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.16.0 | Flessibili |
------
#### [ 2.3.9 ]
La tabella seguente elenca le dipendenze per la versione 2.3.9 di questo componente.
| Dipendenza | Versioni compatibili | Tipo di dipendenza |
| --- | --- | --- |
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.15.0 | Flessibili |
------
#### [ 2.3.8 ]
La tabella seguente elenca le dipendenze per la versione 2.3.8 di questo componente.
| Dipendenza | Versioni compatibili | Tipo di dipendenza |
| --- | --- | --- |
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.14.0 | Flessibili |
------
#### [ 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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Flessibili |
------
[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Configurazione
Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.
------
#### [ v2.3.10 ]
`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](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) 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](greengrass-nucleus-component.md) per l'output di log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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
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 utilizza`logFileRegex`. 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.](#log-manager-multiple-logs-v2.3.10)
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 *`componentName`* componente 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, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) 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à specificata`diskSpaceLimitUnit`. 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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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à per`diskSpaceLimit`. 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 in`logFileDirectoryPath`.
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\$1world\$1\$1\$1\$1w\$1.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`, *componentName* dov'è 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)
`updateToTlogIntervalSec`
(Facoltativo) Il periodo in secondi con cui il nucleo scrive i dettagli degli eventi di Amazon CloudWatch Events caricamento dei registri nel registro delle transazioni locale (). `config.tlog` Il valore predefinito è il valore specificato in. `periodicUploadIntervalSec` È possibile modificare questo parametro per aumentare l'intervallo di scrittura.
Impostazione predefinita: `periodicUploadIntervalSec`
Minimo: `periodicUploadIntervalSec`
`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`.
**Example 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"
}
```
**Example 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.6 – v2.3.9 ]
`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](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) 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](greengrass-nucleus-component.md) per l'output di log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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
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 utilizza`logFileRegex`. 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.](#log-manager-multiple-logs-v2.3.1)
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 *`componentName`* componente 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, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) 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à specificata`diskSpaceLimitUnit`. 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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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à per`diskSpaceLimit`. 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 in`logFileDirectoryPath`.
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\$1world\$1\$1\$1\$1w\$1.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`, *componentName* dov'è 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`.
**Example 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"
}
```
**Example 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.0 – 2.3.5 ]
`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](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) 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](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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
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 utilizza`logFileRegex`. 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.](#log-manager-multiple-logs-v2.3.1)
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 *`componentName`* componente 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, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) 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à specificata`diskSpaceLimitUnit`. 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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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à per`diskSpaceLimit`. 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 in`logFileDirectoryPath`.
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\$1world\$1\$1\$1\$1w\$1.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`, *componentName* dov'è 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)
**Example 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"
}
```
**Example 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](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) 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](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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
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 *`componentName`* componente 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, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) 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à specificata`diskSpaceLimitUnit`. 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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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à per`diskSpaceLimit`. 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 in`logFileDirectoryPath`.
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\$1world\$1\$1\$1\$1w\$1.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`, *componentName* dov'è 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)
**Example 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](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) 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](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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](https://github.com/aws-greengrass/aws-greengrass-logging-java) 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à specificata`diskSpaceLimitUnit`. 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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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à per`diskSpaceLimit`. 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 in`logFileDirectoryPath`.
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\$1world\$1\$1\$1\$1w\$1.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`, *componentName* dov'è 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)
**Example 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](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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](https://github.com/aws-greengrass/aws-greengrass-logging-java) 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à specificata`diskSpaceLimitUnit`. 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](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). 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à per`diskSpaceLimit`. 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 in`logFileDirectoryPath`.
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\$1\$1w\$1.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)
**Example 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](greengrass-nucleus-component.md).
+ `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](develop-greengrass-components.md#component-types).
+ `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 esempio`2020/12/15`. Il componente log manager utilizza il `yyyy/MM/dd` formato.
+ `thingName`— Il nome del dispositivo principale.
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](greengrass-nucleus-component.md).
+ `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 esempio`2020/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 denominato`MyGreengrassCoreGroup`, che contiene il dispositivo principale.
I `deploymentTargets` per questo dispositivo principale sono`thing/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](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration) 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.](https://docs.aws.amazon.com/greengrass/v2/developerguide/gg-cli-logs.html) L'esempio seguente delinea la forma JSON:
```
{
"loggerName": ,
"level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
"eventType": ,
"cause": ,
"contexts": {},
"thread": ,
"message": ,
"timestamp": # Needs to be epoch time
}
```
Per controllare l'output dei log del componente, puoi utilizzare l'`minimumLogLevel`opzione 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](greengrass-nucleus-component.md).
------
#### [ 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:\$1greengrass\$1v2* 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.11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.9 | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. |
| 2.3.8 | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. |
| 2.3.7 | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. |
| 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. |
| 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.3 | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. |
| 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.0 | Si consiglia di eseguire l'aggiornamento a Greengrass nucleus 2.9.1 quando si esegue l'aggiornamento a log manager 2.3.0. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 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 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.2.1 | Versione aggiornata per la versione 2.5.0 di Greengrass nucleus. |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 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 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) |
| 2.0.x | Versione iniziale. |