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

Os coletores definem o destino para onde os dados de log processados são enviados. Cada pipeline deve ter exatamente um coletor. No momento, apenas o coletor do CloudWatch Logs é compatível.


**Comportamento do coletor por tipo de fonte**  

| Source type (Tipo de origem) | Configuração do grupo de logs | Comportamento | 
| --- | --- | --- | 
| CloudWatch Logs | Deve usar @original | Os eventos são sempre retornados a seu grupo de logs original | 
| S3 | Caminho de grupo de logs personalizado | Os eventos são enviados ao grupo de logs especificado | 
| APIs de terceiros | Caminho de grupo de logs personalizado | Os eventos são enviados ao grupo de logs especificado | 

**Configuração**  
Configure o coletor com os seguintes parâmetros:

**Example Configuração de fonte fora do CloudWatch Logs**  

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

**Example configuração de fonte do CloudWatch Logs**  

```
sink:
  cloudwatch_logs:
    log_group: "@original"
```Parâmetros

`log_group` (obrigatório)  
O nome do grupo de logs do CloudWatch Logs para onde os eventos processados serão enviados. Para pipelines com fontes fora do `cloudwatch_logs`, esse deve ser o nome de um grupo de logs existente. Para pipelines que usam a fonte `cloudwatch_logs`, o ÚNICO valor permitido é `@original`.

`include_original` (opcional)  
Quando presente, armazena uma cópia de cada evento de logs bruto antes que qualquer transformação ocorra. Isso preserva os dados originais para fins de auditoria ou conformidade. Especifique como um objeto vazio (`{}`). Disponível somente para pipelines com fontes `cloudwatch_logs`. Pelo menos um processador deve ser configurado quando essa opção está habilitada.

**Example Coletor do CloudWatch Logs com preservação dos logs originais**  

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

## Requisitos e limitações
<a name="sink-requirements"></a>

Existência do grupo de logs  
Se ele for criado usando o Console de gerenciamento da AWS, o CloudWatch tentará criar o grupo de logs especificado e a política de recurso apropriada se ela não existir ao usar uma fonte de logs fora do CloudWatch. Do contrário, o grupo de logs especificado já deverá existir quando o pipeline for criado. 

Tamanho do evento  
Cada evento de logs não pode exceder 256 KB após o processamento.

Retenção de grupo de logs  
O pipeline usa as configurações de retenção definidas no grupo de logs de destino.

Política de recursos do grupo de logs  
As políticas de recursos do CloudWatch Logs são obrigatórias para pipelines que gravam em grupos de logs, exceto os que usam a fonte `cloudwatch_logs`. Quando você usa o Console de gerenciamento da AWS para configurar o pipeline, o CloudWatch tenta adicionar a política de recurso, se necessário. Se você for criar o pipeline usando o AWS CLI ou uma API, deverá criar a política manualmente e adicioná-la usando a solicitação `logs:PutResourcePolicy`. Para obter mais informações, consulte [Políticas de recursos](pipeline-iam-reference.md#resource-policies).

Suporte entre regiões  
O grupo de logs de destino deve estar na mesma região que o pipeline.

**Importante**  
Para pipelines que usam o tipo de fonte `cloudwatch_logs`:  
Você deve usar `@original` como o valor do grupo de logs.
Os eventos são sempre retornados ao grupo de logs original.
O grupo de logs original deve ser existir durante todo o ciclo de vida do pipeline.
Pipelines com processadores modificam os eventos de logs no grupo de logs original do CloudWatch de onde são interceptados, para logs provenientes de serviços da AWS. Para preservar os dados originais, habilite `include_original` na configuração do coletor.

**nota**  
Os eventos de log estão sujeitos às cotas e limitações do CloudWatch Logs.