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 log
<a name="log-manager-component"></a>

**avvertimento**  
Si consiglia di eseguire l'aggiornamento a Log manager v2.3.5 o successivo. La versione 2.3.5 ottimizza le scritture di configurazione di Log Manager, riducendo le operazioni di I/O 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 da AWS IoT Greengrass dispositivi principali su Amazon CloudWatch Registri. È possibile caricare i log da Greengrass Nucleus, da altri componenti Greengrass e da altre applicazioni e servizi che non sono componenti Greengrass. Per ulteriori informazioni su come monitorare gli accessi CloudWatch Registri e sul file system locale, vedere [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="log-manager-considerations-intro"></a>Le seguenti considerazioni si applicano quando si utilizza il componente di gestione dei log su cui scrivere CloudWatch Registri:<a name="log-manager-considerations"></a>
+ **Ritardi nei log**

  La versione 2.2.8 (e precedenti) del componente Log manager elabora e carica i log solo da file di registro ruotati. Per impostazione predefinita, AWS IoT Greengrass Il software principale ruota i file di registro ogni ora o dopo che sono pari a 1.024 KB. Di conseguenza, il componente Log manager carica i log solo dopo AWS IoT Greengrass Il software principale o un componente Greengrass scrive 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 su CloudWatch Registra più frequentemente.

  La versione 2.3.0 (e successive) del componente Log manager 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 Log manager carica periodicamente nuovi log. Per impostazione predefinita, il componente Log manager carica nuovi log ogni 5 minuti. È possibile configurare un intervallo di caricamento inferiore, in modo che il componente Log manager carichi i log su CloudWatch Effettua i log più frequentemente configurando `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 [registri del file system](monitor-logs.md#access-local-logs).
**Nota**  
Se si utilizzano file system diversi su cui scrivere i log, Log manager torna al comportamento delle versioni 2.2.8 e precedenti del componente Log manager. Per informazioni sull'accesso ai log del file system, vedere [Accedere ai log del file system](https://docs.aws.amazon.com/greengrass/v2/developerguide/monitor-logs.html#access-local-logs).
+ **Orologio inclinato**

  Il componente Log manager utilizza il processo di firma standard Signature Version 4 per creare richieste API per CloudWatch Log. Se l'ora di sistema su un dispositivo principale non è sincronizzata per più di 15 minuti, allora 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, vedi [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
<a name="log-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="log-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente plug-in (`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.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo di Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="log-manager-component-os-support"></a>

Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="log-manager-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ Il [Ruolo del dispositivo Greengrass](device-service-role.md) deve consentire il `logs:CreateLogGroup`, `logs:CreateLogStream`, `logs:PutLogEvents`, e `logs:DescribeLogStreams` azioni, come mostrato 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**  
Le [Ruolo del dispositivo Greengrass](device-service-role.md) che crei quando installi AWS IoT Greengrass Per impostazione predefinita, il software principale include le autorizzazioni di questo criterio di esempio.

  Per ulteriori informazioni, vedere [Utilizzo di politiche basate sull'identità (politiche IAM) per CloudWatch Registri](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-identity-based-access-control-cwl.html) nel *Amazon CloudWatch Guida per l'utente di Logs*.
+ Il componente Log manager è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente Log manager deve essere connesso a `logs.region.amazonaws.com` che ha l'endpoint VPC di `com.amazonaws.us-east-1.logs`.

### Endpoint e porte
<a name="log-manager-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita ai seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per il funzionamento 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 i log su CloudWatch Registri. | 

## Dipendenze
<a name="log-manager-component-dependencies"></a>

Quando si distribuisce un componente, AWS IoT Greengrass distribuisce anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuirlo correttamente. Questa sezione elenca le dipendenze per [versioni rilasciate](#log-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nel [AWS IoT Greengrass plancia](https://console.aws.amazon.com/greengrass). Nella pagina dei dettagli del componente, cerca **Dipendenze** elenco.

------
#### [ 2.3.13 and 2.3.14 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.13 e 2.3.14 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | > =2.1.0 <2.19.0 | Flessibili | 

------
#### [ 2.3.12 ]

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


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | > =2.1.0 <2.18.0 | Flessibili | 

------
#### [ 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 [riferimento alla ricetta dei componenti](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configurazione
<a name="log-manager-component-configuration"></a>

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 AWS IoT Greengrass Registri di sistema del software principale, che includono i registri di [Nucleo di Greengrass](greengrass-nucleus-component.md) e [componenti del plugin](develop-greengrass-components.md#component-types). Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema su CloudWatch Registri.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura [Componente Greengrass Nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. Per abilitare i log in formato JSON, specificare `JSON` per [formato di registrazione](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) parametro (`logging.format`).  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di log di sistema di Greengrass, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di sistema di Greengrass supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ciascuno `componentName` l'oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti su CloudWatch Registri.  
Consigliamo vivamente di utilizzare una singola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file di registro su cui viene scritta attivamente quando si utilizza il `logFileRegex`. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati su CloudWatch. Se hai come target più file di log attivi con una singola regex, ti consigliamo di eseguire l'aggiornamento a Log manager v2.3.1 o successivo e di prendere in considerazione la possibilità di modificare la configurazione utilizzando [esempio di configurazione](#log-manager-multiple-logs-v2.3.10).
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare `componentLogsConfiguration` elenco invece di `componentLogsConfigurationMap`. Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni su `componentLogsConfiguration` parametro, vedi i parametri di configurazione per la v2.1.x di questo componente.  
{{`componentName`}}  
La configurazione del registro per {{`componentName`}} componente o 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`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(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 nella [AWS IoT Greengrass modulo di registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) repository su GitHub.  
Scegli tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Le AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
Il componente di gestione dei log applica questo limite solo dopo aver caricato i file di registro di un componente su CloudWatch Registri. Per un componente che scrive i propri file di registro, i file che non vengono caricati (ad esempio, mentre il dispositivo è offline o i caricamenti non riescono) non vengono eliminati, quindi la dimensione totale può superare questo limite.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).  
Default: `{{/greengrass/v2}}/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log 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, è possibile specificare **hello\_world\\\\\\\\w\*.log** per caricare i log per un'applicazione Hello World. Il `\\\\w*` il pattern corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare abbina i file di registro con e senza timestamp nel loro 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`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(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 di gestione dei log aggiunge la nuova riga al messaggio di registro per la 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 log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.  
Predefinito: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

`updateToTlogIntervalSec`  
(Facoltativo) Il periodo in secondi per la frequenza di scrittura del nucleo Amazon CloudWatch Events log-upload dei dettagli dell'evento 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 Log manager deve utilizzare i miglioramenti della velocità di registrazione introdotti in Log manager v2.3.5. Imposta il valore su `false` per utilizzare i miglioramenti.  
Se imposti 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: aggiornamento dell'unione delle configurazioni**  
La seguente configurazione di esempio specifica di caricare i log di sistema e `com.example.HelloWorld` i log dei componenti su CloudWatch Registri.  

```
{
  "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 seguente configurazione di esempio è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questa configurazione di esempio specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, verranno caricati anche tutti i file ruotati che corrispondono a `logFileRegex`. Questa configurazione di esempio è supportata su 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 AWS IoT Greengrass Registri di sistema del software principale, che includono i registri di [Nucleo di Greengrass](greengrass-nucleus-component.md) e [componenti del plugin](develop-greengrass-components.md#component-types). Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema su CloudWatch Registri.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura [Componente Greengrass Nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. Per abilitare i log in formato JSON, specificare `JSON` per [formato di registrazione](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) parametro (`logging.format`).  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di log di sistema di Greengrass, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di sistema di Greengrass supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ciascuno `componentName` l'oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti su CloudWatch Registri.  
Consigliamo vivamente di utilizzare una singola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file di registro su cui viene scritta attivamente quando si utilizza il `logFileRegex`. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati su CloudWatch. Se hai come target più file di log attivi con una singola regex, ti consigliamo di eseguire l'aggiornamento a Log manager v2.3.1 o successivo e di prendere in considerazione la possibilità di modificare la configurazione utilizzando [esempio di configurazione](#log-manager-multiple-logs-v2.3.1).
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare `componentLogsConfiguration` elenco invece di `componentLogsConfigurationMap`. Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni su `componentLogsConfiguration` parametro, vedete i parametri di configurazione per la v2.1.x di questo componente.  
{{`componentName`}}  
La configurazione del registro per {{`componentName`}} componente o 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`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(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 nella [AWS IoT Greengrass modulo di registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) repository su GitHub.  
Scegli tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
Il componente di gestione dei log applica questo limite solo dopo aver caricato i file di registro di un componente su CloudWatch Registri. Per un componente che scrive i propri file di registro, i file che non vengono caricati (ad esempio, mentre il dispositivo è offline o i caricamenti non riescono) non vengono eliminati, quindi la dimensione totale può superare questo limite.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).  
Default: `{{/greengrass/v2}}/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log 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, è possibile specificare **hello\_world\\\\\\\\w\*.log** per caricare i log per un'applicazione Hello World. Il `\\\\w*` il pattern corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare abbina i file di registro con e senza timestamp nel loro 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`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(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 di gestione dei log aggiunge la nuova riga al messaggio di registro per la 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 log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.  
Predefinito: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

`deprecatedVersionSupport`  
Indica se il Log manager deve utilizzare i miglioramenti della velocità di registrazione introdotti in Log manager v2.3.5. Imposta il valore su `false` per utilizzare i miglioramenti.  
Se imposti 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: aggiornamento dell'unione delle configurazioni**  
La seguente configurazione di esempio specifica di caricare i log di sistema e `com.example.HelloWorld` i log dei componenti su CloudWatch Registri.  

```
{
  "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 seguente configurazione di esempio è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questa configurazione di esempio specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, verranno caricati anche tutti i file ruotati che corrispondono a `logFileRegex`. Questa configurazione di esempio è supportata su 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 AWS IoT Greengrass Registri di sistema del software principale, che includono i registri di [Nucleo di Greengrass](greengrass-nucleus-component.md) e [componenti del plugin](develop-greengrass-components.md#component-types). Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema su CloudWatch Registri.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura [Componente Greengrass Nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. Per abilitare i log in formato JSON, specificare `JSON` per [formato di registrazione](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) parametro (`logging.format`).  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di log di sistema di Greengrass, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di sistema di Greengrass supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ciascuno `componentName` l'oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti su CloudWatch Registri.  
Consigliamo vivamente di utilizzare una singola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file di registro su cui viene scritta attivamente quando si utilizza il `logFileRegex`. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati su CloudWatch. Se hai come target più file di log attivi con una singola regex, ti consigliamo di eseguire l'aggiornamento a Log manager v2.3.1 e di prendere in considerazione la possibilità di modificare la configurazione utilizzando [esempio di configurazione](#log-manager-multiple-logs-v2.3.1).
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare `componentLogsConfiguration` elenco invece di `componentLogsConfigurationMap`. Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni su `componentLogsConfiguration` parametro, vedi i parametri di configurazione per la v2.1.x di questo componente.  
{{`componentName`}}  
La configurazione del registro per {{`componentName`}} componente o 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`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(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 nella [AWS IoT Greengrass modulo di registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) repository su GitHub.  
Scegli tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
Il componente di gestione dei log applica questo limite solo dopo aver caricato i file di registro di un componente su CloudWatch Registri. Per un componente che scrive i propri file di registro, i file che non vengono caricati (ad esempio, mentre il dispositivo è offline o i caricamenti non riescono) non vengono eliminati, quindi la dimensione totale può superare questo limite.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).  
Default: `{{/greengrass/v2}}/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log 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, è possibile specificare **hello\_world\\\\\\\\w\*.log** per caricare i log per un'applicazione Hello World. Il `\\\\w*` il pattern corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare abbina i file di registro con e senza timestamp nel loro 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`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(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 di gestione dei log aggiunge la nuova riga al messaggio di registro per la 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 log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.  
Predefinito: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: aggiornamento dell'unione delle configurazioni**  
La seguente configurazione di esempio specifica di caricare i log di sistema e `com.example.HelloWorld` i log dei componenti su CloudWatch Registri.  

```
{
  "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 seguente configurazione di esempio è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questa configurazione di esempio specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, verranno caricati anche tutti i file ruotati che corrispondono a `logFileRegex`. Questa configurazione di esempio è supportata su 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 AWS IoT Greengrass Registri di sistema del software principale, che includono i registri di [Nucleo di Greengrass](greengrass-nucleus-component.md) e [componenti del plugin](develop-greengrass-components.md#component-types). Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema su CloudWatch Registri.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura [Componente Greengrass Nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. Per abilitare i log in formato JSON, specificare `JSON` per [formato di registrazione](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) parametro (`logging.format`).  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di log di sistema di Greengrass, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di sistema di Greengrass supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ciascuno `componentName` l'oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti su CloudWatch Registri.  
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare `componentLogsConfiguration` elenco invece di `componentLogsConfigurationMap`. Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni su `componentLogsConfiguration` parametro, vedi i parametri di configurazione per la v2.1.x di questo componente.   
{{`componentName`}}  
La configurazione del registro per {{`componentName`}} componente o 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`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(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 nella [AWS IoT Greengrass modulo di registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) repository su GitHub.  
Scegli tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
Il componente di gestione dei log applica questo limite solo dopo aver caricato i file di registro di un componente su CloudWatch Registri. Per un componente che scrive i propri file di registro, i file che non vengono caricati (ad esempio, mentre il dispositivo è offline o i caricamenti non riescono) non vengono eliminati, quindi la dimensione totale può superare questo limite.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).  
Default: `{{/greengrass/v2}}/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log 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, è possibile specificare **hello\_world\\\\\\\\w\*.log** per caricare i log per un'applicazione Hello World. Il `\\\\w*` il pattern corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare abbina i file di registro con e senza timestamp nel loro 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`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(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 di gestione dei log aggiunge la nuova riga al messaggio di registro per la 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 log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.  
Predefinito: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: aggiornamento dell'unione delle configurazioni**  
La seguente configurazione di esempio specifica di caricare i log di sistema e `com.example.HelloWorld` i log dei componenti su CloudWatch Registri.  

```
{
  "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 AWS IoT Greengrass Registri di sistema del software principale, che includono i registri di [Nucleo di Greengrass](greengrass-nucleus-component.md) e [componenti del plugin](develop-greengrass-components.md#component-types). Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema su CloudWatch Registri.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura [Componente Greengrass Nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. Per abilitare i log in formato JSON, specificare `JSON` per [formato di registrazione](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) parametro (`logging.format`).  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di log di sistema di Greengrass, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di sistema di Greengrass supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
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 log dei componenti su CloudWatch Registri  
Ogni oggetto contiene le seguenti informazioni:    
`componentName`  <a name="log-manager-component-configuration-component-component-name"></a>
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`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(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 nella [AWS IoT Greengrass modulo di registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) repository su GitHub.  
Scegli tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
Il componente di gestione dei log applica questo limite solo dopo aver caricato i file di registro di un componente su CloudWatch Registri. Per un componente che scrive i propri file di registro, i file che non vengono caricati (ad esempio, mentre il dispositivo è offline o i caricamenti non riescono) non vengono eliminati, quindi la dimensione totale può superare questo limite.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).  
Default: `{{/greengrass/v2}}/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log 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, è possibile specificare **hello\_world\\\\\\\\w\*.log** per caricare i log per un'applicazione Hello World. Il `\\\\w*` il pattern corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare abbina i file di registro con e senza timestamp nel loro 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`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(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 di gestione dei log aggiunge la nuova riga al messaggio di registro per la 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 log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

 `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.  
Predefinito: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: aggiornamento dell'unione delle configurazioni**  
La seguente configurazione di esempio specifica di caricare i log di sistema e `com.example.HelloWorld` i log dei componenti su CloudWatch Registri.  

```
{
  "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 AWS IoT Greengrass Registri di sistema del software principale. Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema su CloudWatch Registri.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura [Componente Greengrass Nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. Per abilitare i log in formato JSON, specificare `JSON` per [formato di registrazione](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) parametro (`logging.format`).  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di log di sistema di Greengrass, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di sistema di Greengrass supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per `diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB` — kilobyte
+ `MB` — megabyte
+ `GB` — gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
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 log dei componenti su CloudWatch Registri  
Ogni oggetto contiene le seguenti informazioni:    
`componentName`  <a name="log-manager-component-configuration-component-component-name"></a>
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`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(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 nella [AWS IoT Greengrass modulo di registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) repository su GitHub.  
Scegli tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata in `diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, AWS IoT Greengrass Il software principale elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato a [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) parametro (`totalLogsSizeKB`) del [componente del nucleo di Greengrass](greengrass-nucleus-component.md). Il AWS IoT Greengrass Il software principale utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
Il componente di gestione dei log applica questo limite solo dopo aver caricato i file di registro di un componente su CloudWatch Registri. Per un componente che scrive i propri file di registro, i file che non vengono caricati (ad esempio, mentre il dispositivo è offline o i caricamenti non riescono) non vengono eliminati, quindi la dimensione totale può superare questo limite.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(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, specifica **`{{/greengrass/v2}}`/logs**e sostituisci `{{/greengrass/v2}}` con 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, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare **com.example.HelloWorld\\\\w\*.log** per caricare i log per un componente Hello World. Il `\\w*` il pattern corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare abbina i file di registro con e senza timestamp nel loro nome. In questo esempio, il Log manager 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 di Greengrass aggiunge un timestamp rotante ai file di registro.  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log su CloudWatch Registri.  
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(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 di gestione dei log aggiunge la nuova riga al messaggio di registro per la 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 log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

`periodicUploadIntervalSec`  
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.  
Predefinito: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: aggiornamento dell'unione delle configurazioni**  
La seguente configurazione di esempio specifica di caricare i log di sistema e `com.example.HelloWorld` i log dei componenti su CloudWatch Registri.  

```
{
  "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
<a name="log-manager-component-usage"></a>

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

------
#### [ 2.1.0 and later ]<a name="log-manager-log-group-stream-format"></a>

**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 di Greengrass. Il componente fa parte del [Nucleo Greengrass](greengrass-nucleus-component.md).
  + `UserComponent` — Questo gruppo di log include i log per i componenti generici, i componenti Lambda e altre applicazioni sul dispositivo. Il componente non fa parte del nucleo di Greengrass.

  Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).
+ `region` — Il AWS Regione utilizzata dal dispositivo principale.
+ `componentName` — Il nome del componente. Per i log di sistema, questo valore è `System`.

**Nome del log stream**  

```
/{{date}}/thing/{{thingName}}
```
Il nome del flusso di log utilizza le seguenti variabili:  
+ `date` — La data del registro, ad esempio `2020/12/15`. Il componente di gestione dei log utilizza `yyyy/MM/dd` formato.
+ `thingName` — Il nome del dispositivo principale.
Se il nome di un oggetto contiene i due punti (`:`), il gestore dei log 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 di [Nucleo Greengrass](greengrass-nucleus-component.md).
  + `UserComponent` — Il componente non fa parte del nucleo di Greengrass. Il Log manager utilizza questo tipo per i componenti Greengrass e altre applicazioni sul dispositivo.
+ `region` — Il AWS Regione utilizzata dal dispositivo principale.
+ `componentName` — Il nome del componente. Per i log di sistema, questo valore è `System`.

**Nome del log stream**  

```
/{{date}}/{{deploymentTargets}}/{{thingName}}
```
Il nome del flusso di log utilizza le seguenti variabili:  
+ `date` — La data del registro, ad esempio `2020/12/15`. Il componente Log manager utilizza `yyyy/MM/dd` formato.
+ `deploymentTargets` — Le cose le cui implementazioni 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`.

  Considerate un esempio in cui avete un dispositivo principale denominato `MyGreengrassCore`e il dispositivo principale ha due implementazioni:
  + Una distribuzione destinata al dispositivo principale, `MyGreengrassCore`.
  + Una distribuzione destinata a un gruppo di oggetti denominato `MyGreengrassCoreGroup`, che contiene il dispositivo principale.

  Il `deploymentTargets` per questo dispositivo principale sono `thing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup`.
+ `thingName` — Il nome del dispositivo principale.

------

### Formati per le voci di registro.
<a name="log-manager-entry-format"></a>

Il nucleo di Greengrass scrive i file di registro in formato stringa o JSON. Per i log di sistema, è possibile controllare il formato impostando `format` campo del `logging` ingresso. Puoi trovare `logging` voce nel file di configurazione del componente Greengrass nucleus. Per ulteriori informazioni, vedere [Configurazione del nucleo di Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration).

Il formato del testo è in formato libero e accetta qualsiasi stringa. Il seguente messaggio di servizio sullo stato del parco veicoli è 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 registri con [Log della CLI di Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/gg-cli-logs.html) comanda o interagisci 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 usare il `minimumLogLevel` opzione di configurazione. Per utilizzare questa opzione, il componente deve scrivere le voci di registro in formato JSON. È necessario utilizzare lo stesso formato del file di registro di sistema.

## File di registro locale
<a name="log-manager-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del [Nucleo di Greengrass](greengrass-nucleus-component.md) componente.

------
#### [ 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 verso il AWS IoT Greengrass cartella principale.

------
#### [ Linux ]

  ```
  sudo tail -f {{/greengrass/v2}}/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content {{C:\greengrass\v2}}\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="log-manager-component-changelog"></a>

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


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 2.3.14 |  **Correzioni di bug e miglioramenti**<br />   Risolve un problema in cui i log con multibyte UTF-8 i caratteri (come giapponese, cinese o emoji) causano caricamenti duplicati su Amazon CloudWatch.     | 
| 2.3.13 | Aggiorna la versione del componente per la versione 2.18.0 di Greengrass nucleus. | 
| 2.3.12 | Aggiorna la versione del componente per la versione 2.17.0 di Greengrass nucleus. | 
| 2.3.11 |  **Correzioni di bug e miglioramenti**<br />   Risolve un problema a causa del quale la configurazione del runtime di Log Manager cresceva all'infinito con informazioni obsolete sui file di registro caricati.     | 
| 2.3.10 |  **Nuove funzionalità**<br />   Aggiunge una nuova chiave di configurazione (`updateToTlogIntervalSec`) per controllare la frequenza con cui i dettagli dell'evento di caricamento del registro vengono mantenuti nel registro delle transazioni locale (`config.tlog`).   <br />**Correzioni di bug e miglioramenti**<br />   Migliora il Log Manager per aggiornare il client Cloudwatch in caso di errore di connessione al socket.     | 
| 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 |  <a name="changelog-log-manager-2.3.6"></a>**Correzioni di bug e miglioramenti**<br />   Regola i livelli di registro per determinati errori.     | 
| 2.3.5 |  <a name="changelog-log-manager-2.3.5"></a>**Miglioramenti**<br /> Migliora la velocità di caricamento dei log.  Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.  | 
| 2.3.4 |  <a name="changelog-log-manager-2.3.4"></a>**Correzioni di bug e miglioramenti**<br />   Aggiunge il supporto per l'impostazione di `periodicUploadIntervalSec` parametro ai valori frazionari. Il valore minimo è 1 microsecondo.   Risolve un problema a causa del quale il gestore dei log non rispetta il 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**<br />   Migliora la gestione dello spazio in modo che i file di registro non vengano eliminati prima del caricamento.   Risolve i problemi relativi alla gestione della cache.   Miglioramenti e correzioni di bug minori aggiuntivi.     | 
| 2.3.1 |  **Correzioni di bug e miglioramenti**<br />   Risolve un problema a causa del quale i gruppi di file di destinazione con più file di registro attivi caricano voci duplicate in CloudWatch.   Miglioramenti e correzioni di bug minori aggiuntivi.     | 
| 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. **Nuove funzionalità**<br /> Riduce i ritardi nei log elaborando e caricando direttamente i file di log attivi invece di attendere la rotazione dei nuovi file. <br />**Correzioni di bug e miglioramenti**<br />   Migliora il supporto della rotazione dei log durante la rotazione di file con un nome univoco.   Miglioramenti e correzioni di bug minori aggiuntivi.    | 
| 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**<br />   Migliora la stabilità nella gestione di configurazioni non valide.   Correzioni e miglioramenti minori aggiuntivi.     | 
| 2.2.3 |  **Correzioni di bug e miglioramenti**<br />   Migliora la stabilità in determinati scenari in cui il componente si riavvia o incontra errori.   Risolve i problemi a causa del mancato caricamento di messaggi 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 in cui a `null` `diskSpaceLimit` il valore di configurazione impediva la distribuzione del componente.     | 
| 2.2.2 |  **Correzioni di bug e miglioramenti**<br />   Aggiunge il supporto per i messaggi di registro di dimensioni superiori a 256 kilobyte. Il componente Log manager 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 funzionalità**<br />   Aggiunge `componentLogsConfigurationMap` parametro di configurazione per supportare un formato di mappa per le configurazioni del registro dei componenti. Ciascuno `componentName` l'oggetto nella mappa definisce la configurazione del registro per un componente o un'applicazione.     | 
| 2.1.3 | Versione aggiornata per Greengrass nucleus versione 2.4.0. | 
| 2.1.2 | Versione aggiornata per Greengrass nucleus versione 2.3.0. | 
| 2.1.1 |  <a name="changelog-log-manager-2.1.1"></a>**Correzioni di bug e miglioramenti**<br />   Risolve un problema per cui la configurazione del registro di sistema non veniva aggiornata in alcuni casi.     | 
| 2.1.0 |  <a name="changelog-log-manager-2.1.0"></a>**Correzioni di bug e miglioramenti**<br />   Usa i valori predefiniti per `logFileDirectoryPath` e `logFileRegex` che funzionano con i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).   Instrada correttamente il traffico attraverso un proxy di rete configurato durante il caricamento dei log su CloudWatch Registri.   Gestisci correttamente i caratteri dei due punti (`:`) nei nomi dei flussi di log. CloudWatch I nomi dei log stream non supportano i due punti.   Semplifica i nomi dei flussi di log rimuovendo i nomi dei gruppi di oggetti dal flusso di log.   Rimuovi un messaggio di registro degli errori che viene stampato durante il normale comportamento.     | 
| 2.0.x | Versione iniziale. |