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

# Inoltro di log di sistema
<a name="system-log-forwarder-component"></a>

Il System log forwarder (`aws.greengrass.SystemLogForwarder`) carica i log di sistema attivi direttamente su Amazon CloudWatch utilizzando l'API HTTPS. CloudWatch 

**Importante**  
Questo componente inoltrerà solo i log systemd-journald generati durante l'esecuzione. [https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html)

**Nota**  
Questo componente richiede autorizzazioni specifiche per creare e gestire gruppi e flussi di log. CloudWatch 

**Topics**
+ [Versioni](#system-log-forwarder-component-versions)
+ [Tipo](#system-log-forwarder-component-type)
+ [Sistema operativo](#system-log-forwarder-component-os-support)
+ [Requisiti](#system-log-forwarder-component-requirements)
+ [Endpoint e porte](#system-log-forwarder-component-endpoints)
+ [Dipendenze](#system-log-forwarder-component-dependencies)
+ [Configurazione](#system-log-forwarder-component-configuration)
+ [Changelog](#system-log-forwarder-component-changelog)

## Versioni
<a name="system-log-forwarder-component-versions"></a>

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

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

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico (`aws.greengrass.generic`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<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="system-log-forwarder-component-os-support"></a>

Questo componente deve essere installato su sistemi Linux basati su sistema.

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

Questo componente presenta i seguenti requisiti:

Il componente richiede l'accesso per creare gruppi di log e stream, CloudWatch nonché l'autorizzazione per eseguire la chiamata PutLogEvents HTTP. È necessario aggiungere almeno le seguenti autorizzazioni di policy all'alias di ruolo del dispositivo Greengrass:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogGroup"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:*"
    },
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogStream", "logs:PutLogEvents"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:log-stream:${credentials-iot:ThingName}"
    }
  ]
}
```

------

**Nota**  
[Per ulteriori informazioni, consulta la pagina Github di System Log Forwarder.](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder)

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

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


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | No |  Obbligatorio se si scrivono log in Logs. CloudWatch   | 

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

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

------
#### [ 2.1.x ]

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


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=2.0.0 | Rigidi | 
| [Greengrass Nucleus Lite](greengrass-nucleus-lite-component.md) | >=2.3.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 | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=2.0.0 | Rigidi | 

------

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

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

------
#### [ 2.0.x-2.1.x ]

`maxUploadIntervalSec`  
Il periodo massimo in cui il log forwarder di sistema tenterà di caricare i log. Poiché il log forwarder caricherà i log quando la memoria si riempie, potrebbe comunque caricarsi più spesso della cadenza massima configurata.

`maxRetriesCount`  
Numero di volte in cui il log forwarder di sistema tenterà di riprovare un errore HTTP transitorio.

`bufferCapacity`  
La dimensione del ring buffer per l'archiviazione dei log in memoria.

`logGroup`  
Il percorso del registro in. CloudWatch

`logStream`  
Il CloudWatch LogStream.

`filters`  
Una mappa delle configurazioni dei filtri per il dispositivo principale.    
`services`  
Un elenco di filtri per i nomi di servizio che System Log Forwarder utilizzerà per determinare quali log verranno caricati. Un registro verrà caricato solo se il servizio da cui proviene corrisponde ad almeno uno dei filtri in questo elenco. I filtri in questo elenco possono essere una stringa a cui il nome del servizio deve corrispondere completamente o una stringa che termina con \$1, il che significa che il prefisso deve corrispondere.  
Impostazione predefinita: `[ggl.*]`  
Un registro verrà caricato solo se il servizio da cui proviene corrisponde ad almeno uno dei filtri in questo elenco.
L'utilizzo del valore \$1 includerà tutti i servizi disponibili.

**Example Configurazione di esempio:**  
L'esempio seguente filtrerà i log in base a tutti i servizi inclusi in Greengrass Nucleus Lite.  

```
{
    "maxUploadIntervalSec": 300,
    "maxRetriesCount": 3,
    "bufferCapacity": 1048576,
    "logGroup": "greengrass/systemLogs",
    "logStream": "deviceName",
    "filters": {
        "services": ["ggl.*"]
    }
}
```

------

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

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


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.0  |  Versione iniziale.  |