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

Los receptores definen el destino al que se envían los datos de registros procesados. Cada canalización debe tener exactamente un receptor. Actualmente, solo se admite el receptor de Registros de CloudWatch.


**Comportamiento del receptor por tipo de origen**  

| Tipo de origen | Configuración del grupo de registro | Comportamiento | 
| --- | --- | --- | 
| Registros de CloudWatch | Debe usar @original | Los eventos se devuelven a su grupo de registro original | 
| S3 | Ruta del grupo de registro personalizada | Los eventos se envían al grupo de registro especificado | 
| API de terceros | Ruta del grupo de registro personalizada | Los eventos se envían al grupo de registro especificado | 

**Configuración**  
Configure el receptor con los siguientes parámetros:

**Example Configuración de orígenes que no son de Registros de CloudWatch**  

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

**Example Configuración de orígenes de Registros de CloudWatch**  

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

`log_group` (obligatorio)  
El nombre del grupo de registro de registros de CloudWatch al que se enviarán los eventos procesados. Para las canalizaciones con orígenes que no son `cloudwatch_logs`, debe ser el nombre de un grupo de registro existente. Para las canalizaciones con el origen `cloudwatch_logs`, el ÚNICO valor permitido es `@original`.

`include_original` (opcional)  
Cuando está presente, almacena una copia de cada evento de registro sin procesar antes de que se lleve a cabo cualquier transformación. Esto preserva los datos originales con fines de auditoría o cumplimiento. Especifíquelo como un objeto vacío (`{}`). Disponible solo para canalizaciones con orígenes de `cloudwatch_logs`. Se debe configurar al menos un procesador cuando esta opción esté habilitada.

**Example Receptor de Registros de CloudWatch con conservación del registro original**  

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

## Requisitos y limitaciones
<a name="sink-requirements"></a>

Existencia del grupo de registro  
Si se creó con la Consola de administración de AWS, CloudWatch intentará crear el grupo de registro especificado y la política de recursos adecuada si no existe cuando se utiliza un origen que no sea Registros de CloudWatch. De lo contrario, el grupo de registro especificado debe existir antes de crear la canalización. 

Tamaño de eventos  
Cada evento de registro no puede superar los 256 KB de tamaño después de su procesamiento.

Retención del grupo de registro  
La canalización utiliza los ajustes de retención configurados en el grupo de registro de destino.

Política de recursos del grupo de registros  
Las políticas de recursos de Registros de CloudWatch son obligatorias para canalizaciones que escriben en grupos de registro, excepto para las canalizaciones que utilizan el origen `cloudwatch_logs`. Cuando utilice la Consola de administración de AWS para configurar la canalización, CloudWatch intentará agregar la política de recursos si es necesario. Si va a crear la canalización mediante la AWS CLI o una API, debe crear la política manualmente y agregarla mediante la solicitud `logs:PutResourcePolicy`. Para obtener más información, consulte [Políticas de recursos](pipeline-iam-reference.md#resource-policies).

Compatibilidad entre regiones  
El grupo de registro de destino y la canalización deben estar en la misma región.

**importante**  
Para las canalizaciones que utilizan el tipo de origen `cloudwatch_logs`:  
Debe usar `@original` como valor del grupo de registro.
Los eventos siempre se devuelven a su grupo de registro original.
El grupo de registro original debe existir durante todo el ciclo de vida de la canalización.
Las canalizaciones con procesadores mutan los eventos de registro en el grupo de registro original de CloudWatch desde el que se interceptan para obtener registros de servicios de AWS. Para conservar los datos originales, active `include_original` en la configuración del receptor.

**nota**  
Los eventos de registro están sujetos a las cuotas y limitaciones de Registros de CloudWatch.