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

# Sink
<a name="pipeline-sinks"></a>

I sink definiscono la destinazione in cui vengono inviati i dati di registro elaborati. Ogni tubazione deve avere esattamente un lavandino. Attualmente, è supportato solo CloudWatch Logs sink.


**Comportamento del sink per tipo di sorgente**  

| Tipo di fonte | Configurazione del gruppo di log | Comportamento | 
| --- | --- | --- | 
| CloudWatch Registri | Deve usare @original | Gli eventi vengono rispediti al gruppo di log originale | 
| S3 | Percorso personalizzato del gruppo di log | Gli eventi vengono inviati al gruppo di log specificato | 
| Terze parti APIs | Percorso personalizzato del gruppo di log | Gli eventi vengono inviati al gruppo di log specificato | 

**Configurazione**  
Configura il sink con i seguenti parametri:

**Example Configurazione del codice sorgente CloudWatch Non-Logs**  

```
sink:
  cloudwatch_logs:
    log_group: "/aws/my-application/logs"
```

**Example CloudWatch Registra la configurazione del codice sorgente**  

```
sink:
  cloudwatch_logs:
    log_group: "@original"
```Parameters

`log_group`(richiesto)  
Il nome del gruppo di log CloudWatch Logs a cui verranno inviati gli eventi elaborati. Per le pipeline che non contengono `cloudwatch_logs` fonti, questo deve essere il nome di un gruppo di log esistente. Per le pipeline che utilizzano il `cloudwatch_logs` codice sorgente, l'UNICO valore consentito è. `@original`

`include_original` (facoltativo)  
Se presente, memorizza una copia di ogni evento di registro non elaborato prima che avvenga qualsiasi trasformazione. Ciò preserva i dati originali per scopi di controllo o conformità. Specificare come oggetto vuoto (`{}`). Disponibile solo per le pipeline con `cloudwatch_logs` sorgenti. Almeno un processore deve essere configurato quando questa opzione è abilitata.

**Example CloudWatch I log vengono salvati con la conservazione originale dei log**  

```
sink:
  - cloudwatch_logs:
      log_group: "@original"
      include_original: {}
```

## Requisiti e limitazioni
<a name="sink-requirements"></a>

Registra l'esistenza di un gruppo  
Se creato utilizzando Console di gestione AWS, CloudWatch tenterà di creare il gruppo di log specificato e la politica delle risorse appropriata se non esiste quando si utilizza una fonte non CloudWatch registrata. Altrimenti, il gruppo di log specificato deve esistere prima di creare la pipeline. 

Dimensioni dell'evento  
Ogni evento di registro non può superare le dimensioni di 256 KB dopo l'elaborazione.

Conservazione dei gruppi di log  
La pipeline utilizza le impostazioni di conservazione configurate nel gruppo di log di destinazione.

Policy delle risorse del gruppo di log  
CloudWatch Le politiche relative alle risorse dei log sono necessarie per le pipeline che scrivono in gruppi di log, ad eccezione delle pipeline che utilizzano il codice sorgente. `cloudwatch_logs` Quando si utilizza il Console di gestione AWS per configurare la pipeline, CloudWatch tenterà di aggiungere la politica delle risorse, se necessario. Se stai creando la pipeline utilizzando AWS CLI o un'API, devi creare la policy manualmente e aggiungerla utilizzando la `logs:PutResourcePolicy` richiesta. Per ulteriori informazioni, consulta [Policy delle risorse](pipeline-iam-reference.md#resource-policies).

Supporto tra regioni  
Il gruppo di log di destinazione deve trovarsi nella stessa regione della pipeline.

**Importante**  
Per le pipeline che utilizzano il tipo di origine `cloudwatch_logs`:  
È necessario utilizzare `@original` come valore del gruppo di log.
Gli eventi vengono sempre rispediti al gruppo di log originale.
Il gruppo di log originale deve esistere per tutto il ciclo di vita della pipeline.
Le pipeline con processori modificano gli eventi di registro nel gruppo di log originale da cui vengono intercettati per i CloudWatch log dei servizi. AWS Per conservare i dati originali, `include_original` abilitateli nella configurazione sink.

**Nota**  
Gli eventi di registro sono soggetti alle quote e alle limitazioni CloudWatch dei log.