Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Récepteurs
<a name="pipeline-sinks"></a>

Les récepteurs définissent la destination à laquelle les données de journal traitées sont envoyées. Chaque pipeline doit avoir exactement un puits. Actuellement, seul le récepteur CloudWatch Logs est pris en charge.


**Comportement du récepteur par type de source**  

| Type de source | Configuration du groupe de journaux | Comportement | 
| --- | --- | --- | 
| CloudWatch Journaux | Doit utiliser @original | Les événements sont renvoyés dans leur groupe journal d'origine | 
| S3 | Chemin d'accès personnalisé au groupe de journaux | Les événements sont envoyés au groupe de journaux spécifié | 
| Tierce APIs | Chemin d'accès personnalisé au groupe de journaux | Les événements sont envoyés au groupe de journaux spécifié | 

**Configuration**  
Configurez le récepteur avec les paramètres suivants :

**Example Configuration de la source sans CloudWatch journaux**  

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

**Example CloudWatch Configuration de la source des journaux**  

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

`log_group` (obligatoire)  
Nom du groupe de CloudWatch journaux dans lequel les événements traités seront envoyés. Pour les pipelines ne contenant pas de `cloudwatch_logs` sources, il doit s'agir d'un nom de groupe de journaux existant. Pour les pipelines utilisant la `cloudwatch_logs` source, la SEULE valeur autorisée est`@original`.

`include_original` (facultatif)  
Lorsqu'il est présent, stocke une copie de chaque événement du journal brut avant toute transformation. Cela permet de conserver les données d'origine à des fins d'audit ou de conformité. Spécifiez en tant qu'objet vide (`{}`). Disponible uniquement pour les pipelines avec `cloudwatch_logs` sources. Au moins un processeur doit être configuré lorsque cette option est activée.

**Example CloudWatch Évier à bûches avec système de conservation des bûches original**  

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

## Exigences et limitations
<a name="sink-requirements"></a>

Existence d'un groupe de journaux  
S'il est créé à l'aide du AWS Management Console, CloudWatch tentera de créer le groupe de journaux spécifié et la politique de ressources appropriée s'il n'existe pas lors de l'utilisation d'une source autre que CloudWatch les journaux. Dans le cas contraire, le groupe de journaux spécifié doit exister avant de créer le pipeline. 

Taille de l'événement  
La taille de chaque événement du journal ne peut pas dépasser 256 Ko après le traitement.

Conservation des groupes de journaux  
Le pipeline utilise les paramètres de rétention configurés sur le groupe de journaux de destination.

Politique de ressources du groupe de journaux  
CloudWatch Les politiques relatives aux ressources des journaux sont requises pour les pipelines qui écrivent dans des groupes de journaux, à l'exception des pipelines utilisant la `cloudwatch_logs` source. Lorsque vous utilisez le AWS Management Console pour configurer le pipeline, il CloudWatch essaiera d'ajouter la politique de ressources si nécessaire. Si vous créez le pipeline à l'aide de l'API AWS CLI ou d'une API, vous devez créer la politique manuellement et l'ajouter à l'aide de la `logs:PutResourcePolicy` demande. Pour de plus amples informations, veuillez consulter [Politiques basées sur une ressource](pipeline-iam-reference.md#resource-policies).

Prise en charge entre régions  
Le groupe de journaux de destination doit se trouver dans la même région que le pipeline.

**Important**  
Pour les pipelines utilisant le type de source `cloudwatch_logs` :  
Vous devez l'utiliser `@original` comme valeur du groupe de journaux.
Les événements sont toujours renvoyés dans leur groupe journal d'origine.
Le groupe de logs d'origine doit exister tout au long du cycle de vie du pipeline.
Les pipelines dotés de processeurs transforment les événements du journal du groupe de CloudWatch journaux d'origine à partir duquel ils sont interceptés pour les remplacer par des journaux provenant AWS des services. Pour conserver les données d'origine, activez-les `include_original` dans la configuration du récepteur.

**Note**  
Les événements de journalisation sont soumis à CloudWatch des quotas et à des limites de journalisation.