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.
# Enregistrement des performances d'Amazon EventBridge Pipes
EventBridge La journalisation des canaux vous permet de demander à EventBridge Pipes d'envoyer des enregistrements détaillant les performances des canaux aux AWS services pris en charge. Utilisez les journaux pour en savoir plus sur les performances d’exécution de votre canal et pour faciliter le dépannage et le débogage.
Vous pouvez sélectionner les AWS services suivants comme *destinations de log vers* lesquelles EventBridge Pipes livre des enregistrements :
+ CloudWatch Journaux
EventBridge fournit des enregistrements de journaux au groupe de CloudWatch journaux de journaux spécifié.
Utilisez CloudWatch les journaux pour centraliser les journaux de tous les systèmes, applications et AWS services que vous utilisez, au sein d'un seul service hautement évolutif. Pour plus d'informations, consultez la section [Utilisation des groupes de journaux et des flux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) de * CloudWatch journaux dans le guide de l'utilisateur Amazon Logs*.
+ Journaux de diffusion de Firehose
EventBridge fournit des enregistrements de journal à un flux de diffusion Firehose.
Amazon Data Firehose est un service entièrement géré qui fournit des données de streaming en temps réel à des destinations telles que certains AWS services, ainsi qu'à tout point de terminaison HTTP personnalisé ou à tout point de terminaison HTTP appartenant à des fournisseurs de services tiers pris en charge. Pour plus d'informations, consultez la section [Création d'un flux de diffusion Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) dans le guide de l'utilisateur *d'Amazon Data Firehose*.
+ Journaux Amazon S3
EventBridge fournit les enregistrements de journal sous forme d'objets Amazon S3 au compartiment spécifié.
Amazon S3 est un service de stockage d'objets qui offre une évolutivité, une disponibilité des données, une sécurité et des performances de pointe. Pour plus d’informations, consultez [Chargement, téléchargement et utilisation des objets dans Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-downloading-objects.html) dans le *Guide de l’utilisateur Amazon Simple Storage Service*.
## Comment fonctionne la journalisation sur Amazon EventBridge Pipes
Une *exécution* de canal est un événement ou un lot d'événements reçu par un canal qui se dirige vers une and/or cible d'enrichissement. Si cette option est activée, EventBridge génère un enregistrement de journal pour chaque étape d'exécution exécutée lors du traitement du lot d'événements. Les informations contenues dans l’enregistrement s’appliquent au lot d’événements, qu’il s’agisse d’un événement unique ou de 10 000 événements au maximum.
Vous pouvez configurer la taille du lot d’événements sur la source et la cible du canal. Pour de plus amples informations, veuillez consulter [Traitement par lots et simultanéité d'Amazon EventBridge Pipes](eb-pipes-batching-concurrency.md).
Les données d’enregistrement envoyées à chaque destination de journal sont les mêmes.
Si une destination Amazon CloudWatch Logs est configurée, les enregistrements de journal envoyés à toutes les destinations sont limités à 256 Ko. Les champs seront tronqués si nécessaire.
Vous pouvez personnaliser les enregistrements EventBridge envoyés aux destinations de journal sélectionnées de la manière suivante :
+ Vous pouvez spécifier le *niveau de journalisation*, qui détermine les étapes d'exécution pour lesquelles les EventBridge enregistrements sont envoyés aux destinations de journalisation sélectionnées. Pour de plus amples informations, veuillez consulter [Spécification du niveau de journalisation des EventBridge tuyaux](#eb-pipes-logs-level).
+ Vous pouvez spécifier si EventBridge Pipes inclut les données d'exécution dans les enregistrements des étapes d'exécution lorsque cela est pertinent. Ces données comprennent :
+ La charge utile du lot d’événements
+ La demande envoyée au service d' AWS enrichissement ou au service cible
+ La réponse renvoyée par le service AWS d'enrichissement ou le service cible
Pour de plus amples informations, veuillez consulter [Inclure les données d'exécution dans les logs de EventBridge Pipes](#eb-pipes-logs-execution-data).
## Spécification du niveau de journalisation des EventBridge tuyaux
Vous pouvez spécifier les types d'étapes d'exécution pour lesquelles des EventBridge enregistrements sont envoyés aux destinations de journal sélectionnées.
Choisissez parmi les niveaux de détail suivants à inclure dans les enregistrements de journal. Le niveau de journalisation s’applique à toutes les destinations de journal spécifiées pour le canal. Chaque niveau de journalisation inclut les étapes d’exécution des niveaux de journalisation précédents.
+ **OFF** — EventBridge n'envoie aucun enregistrement vers les destinations de journal spécifiées. Il s’agit du paramètre par défaut.
+ **ERREUR** — EventBridge envoie tous les enregistrements relatifs aux erreurs générées lors de l'exécution du canal vers les destinations de journal spécifiées.
+ **INFO** — EventBridge envoie tous les enregistrements relatifs aux erreurs, et sélectionne les autres étapes effectuées lors de l'exécution du canal vers les destinations de journal spécifiées.
+ **TRACE** — EventBridge envoie tous les enregistrements générés au cours de n'importe quelle étape de l'exécution du canal vers les destinations de journal spécifiées.
Dans la EventBridge console, CloudWatch les journaux sont sélectionnés comme destination par défaut, tout comme le niveau du `ERROR` journal. Ainsi, par défaut, EventBridge Pipes crée un nouveau groupe de CloudWatch journaux auquel il envoie des enregistrements contenant le `ERROR` niveau de détail. Aucune valeur par défaut n’est sélectionnée lorsque vous configurez les journaux par programmation.
Le tableau suivant répertorie les étapes d’exécution incluses dans chaque niveau de journalisation.
****
| Step (Étape) | TRACE | INFO | ERROR | OFF |
| --- | --- | --- | --- | --- |
| Échec de l'exécution | x | h/24, j/7 | x | |
| Échec partiel de l’exécution | x | h/24, j/7 | x | |
| Exécution commencée | x | x | | |
| Réussite de l'exécution | x | x | | |
| Exécution limitée | x | h/24, j/7 | x | |
| Execution Timeout (Délai d'exécution) | x | h/24, j/7 | x | |
| Échec de l’invocation d’enrichissement | x | h/24, j/7 | x | |
| Invocation d’enrichissement ignorée | x | x | | |
| L’invocation d’enrichissement a démarré | x | | | |
| Réussite de l’invocation d’enrichissement | x | | | |
| Début de l’étape d’enrichissement | x | x | | |
| Échec de l’étape d’enrichissement | x | h/24, j/7 | x | |
| Réussite de l’étape d’enrichissement | x | x | | |
| Echec de la transformation d’enrichissement | x | h/24, j/7 | x | |
| La transformation d’enrichissement a démarré | x | | | |
| Réussite de la transformation d’enrichissement | x | | | |
| Échec de l’invocation de la cible | x | h/24, j/7 | x | |
| Échec partiel de l’invocation de la cible | x | h/24, j/7 | x | |
| Invocation de la cible ignorée | x | | | |
| L’invocation de la cible a démarré | x | | | |
| Réussite de l’invocation de la cible | x | | | |
| Début de l’étape de la cible | x | x | | |
| Échec de l’étape de la cible | x | h/24, j/7 | x | |
| Échec partiel de l’étape de la cible | x | h/24, j/7 | x | |
| Étape de la cible ignorée | x | | | |
| Réussite de l’étape de la cible | x | x | | |
| Échec de la transformation de la cible | x | h/24, j/7 | x | |
| La transformation de la cible a démarré | x | | | |
| Réussite de la transformation de la cible | x | | | |
## Inclure les données d'exécution dans les logs de EventBridge Pipes
Vous pouvez spécifier EventBridge pour inclure les *données d'exécution* dans les enregistrements qu'il génère. Les données d’exécution incluent des champs représentant la charge utile du lot d’événements, ainsi que la demande envoyée à l’enrichissement et à la cible et la réponse de ces derniers.
Les données d’exécution sont utiles pour le dépannage et le débogage. Le champ `payload` contient le contenu réel de chaque événement inclus dans le lot, ce qui vous permet de corréler des événements individuels à une exécution de canal spécifique.
Si vous choisissez d’inclure les données d’exécution, elles sont incluses pour toutes les destinations de journal spécifiées pour le canal.
**Important**
Ces champs peuvent contenir des informations sensibles. EventBridge ne tente pas de supprimer le contenu de ces champs pendant la journalisation.
Lorsque vous incluez des données d'exécution, EventBridge ajoutez les champs suivants aux enregistrements concernés :
+ **`payload`**
Représente le contenu du lot d’événements traité par le canal.
EventBridge inclut le `payload` champ dans les enregistrements générés aux étapes où le contenu du lot d'événements peut avoir été mis à jour. Ces étapes sont les suivantes :
+ `EXECUTION_STARTED`
+ `ENRICHMENT_TRANSFORMATION_SUCCEEDED`
+ `ENRICHMENT_STAGE_SUCCEEDED`
+ `TARGET_TRANSFORMATION_SUCCEEDED`
+ `TARGET_STAGE_SUCCEEDED`
+ **`awsRequest`**
Représente la demande envoyée à l’enrichissement ou à la cible sous forme de chaîne JSON. Pour les demandes envoyées à une destination d’API, il s’agit de la requête HTTP envoyée à ce point de terminaison.
EventBridge inclut le `awsRequest` champ dans les enregistrements générés lors des dernières étapes de l'enrichissement et du ciblage, c'est-à-dire après avoir EventBridge exécuté ou tenté d'exécuter la demande par rapport à l'enrichissement ou au service cible spécifié. Ces étapes sont les suivantes :
+ `ENRICHMENT_INVOCATION_FAILED`
+ `ENRICHMENT_INVOCATION_SUCCEEDED`
+ `TARGET_INVOCATION_FAILED`
+ `TARGET_INVOCATION_PARTIALLY_FAILED`
+ `TARGET_INVOCATION_SUCCEEDED`
+ **`awsResponse`**
Représente la réponse renvoyée par l’enrichissement ou la cible, au format JSON. Pour les demandes envoyées à une destination d’API, il s’agit de la réponse HTTP renvoyée par ce point de terminaison.
De même`awsRequest`, EventBridge inclut le `awsResponse` champ dans les enregistrements générés lors des dernières étapes de l'enrichissement et du ciblage, c'est-à-dire après avoir EventBridge exécuté ou tenté d'exécuter une demande concernant le service d'enrichissement ou le service cible spécifié et reçu une réponse. Ces étapes sont les suivantes :
+ `ENRICHMENT_INVOCATION_FAILED`
+ `ENRICHMENT_INVOCATION_SUCCEEDED`
+ `TARGET_INVOCATION_FAILED`
+ `TARGET_INVOCATION_PARTIALLY_FAILED`
+ `TARGET_INVOCATION_SUCCEEDED`
Pour obtenir une description des étapes d’exécution de canal, consultez [EventBridge Étapes d'exécution des tuyaux](eb-pipes-logs-execution-steps.md).
### Tronquer les données d'exécution dans les enregistrements du journal EventBridge Pipes
Si vous choisissez d' EventBridge inclure les données d'exécution dans les enregistrements du journal d'un canal, il est possible qu'un enregistrement dépasse la limite de 256 Ko. Pour éviter cela, tronque EventBridge automatiquement les champs de données d'exécution, dans l'ordre suivant. EventBridge tronque entièrement chaque champ avant de tronquer le champ suivant. EventBridge tronque les données des champs simplement en supprimant des caractères à la fin de la chaîne de données ; aucune tentative n'est faite pour tronquer en fonction de l'importance des données, et la troncature invalidera le formatage JSON.
+ `payload`
+ `awsRequest`
+ `awsResponse`
Si EventBridge des champs sont tronqués dans l'événement, le `truncatedFields` champ inclut une liste des champs de données tronqués.
## Signalement d'erreurs dans les enregistrements du journal EventBridge Pipes
EventBridge inclut également les données d'erreur, lorsqu'elles sont disponibles, dans les étapes d'exécution du canal qui représentent les états de défaillance. Les étapes sont les suivantes :
+ `ExecutionThrottled`
+ `ExecutionTimeout`
+ `ExecutionFailed`
+ `ExecutionPartiallyFailed`
+ `EnrichmentTransformationFailed`
+ `EnrichmentInvocationFailed`
+ `EnrichmentStageFailed`
+ `TargetTransformationFailed`
+ `TargetInvocationFailed`
+ `TargetInvocationPartiallyFailed`
+ `TargetStageFailed`
+ `TargetStagePartiallyFailed`
# EventBridge Étapes d'exécution des tuyaux
En comprenant le déroulement des étapes d’exécution d’un canal, vous pourrez mieux résoudre les problèmes liés aux performances de votre canal ou les déboguer à l’aide de journaux.
Une *exécution* de canal est un événement ou un lot d’événements reçu par un canal en direction d’un enrichissement ou d’une cible. Si cette option est activée, EventBridge génère un enregistrement de journal pour chaque étape d'exécution exécutée lors du traitement du lot d'événements.
Globalement, l’exécution comporte deux *étapes* ou ensemble d’étapes : l’enrichissement et la cible. Chacune de ces étapes comprend des étapes de transformation et d’invocation.
Les principales étapes d’une exécution de canal réussie sont les suivantes :
+ L’exécution du canal démarre.
+ L’exécution passe à l’étape de l’enrichissement si vous avez spécifié un enrichissement pour les événements. Si vous n’avez pas spécifié d’enrichissement, l’exécution passe à l’étape de la cible.
Au cours de l’étape d’enrichissement, le canal effectue la transformation que vous avez spécifiée, puis invoque l’enrichissement.
+ Au cours de l’étape de cible, le canal effectue la transformation que vous avez spécifiée, puis invoque la cible.
Si vous n’avez pas spécifié de transformation ou de cible, l’exécution ignore l’étape de la cible.
+ L’exécution du canal se termine avec succès.
Le schéma ci-dessous illustre le déroulement des étapes. Les lignes pointillées représentent les chemins divergents.
![\[Une exécution en chaîne comprenant des étapes d'enrichissement et de ciblage, avec des étapes de transformation et d'invocation.\]](http://docs.aws.amazon.com/fr_fr/eventbridge/latest/userguide/images/pipes-logging-overview_eventbridge_architecture.svg)
Le schéma ci-dessous présente une vue détaillée du flux d’exécution d’un canal, avec toutes les étapes d’exécution possibles représentées. Les lignes pointillées représentent à nouveau les chemins divergents.
Pour obtenir la liste complète des étapes d’exécution d’un canal, consultez [Spécification du niveau de journalisation des EventBridge tuyaux](eb-pipes-logs.md#eb-pipes-logs-level).
![\[Le flux d'exécution du tube, y compris toutes les étapes et les étapes avec tous les résultats possibles.\]](http://docs.aws.amazon.com/fr_fr/eventbridge/latest/userguide/images/pipes-logging-detailed_eventbridge_architecture.svg)
Notez que l’invocation de la cible peut entraîner une défaillance partielle du lot. Pour de plus amples informations, veuillez consulter [Comportement de traitement par lots](eb-pipes-batching-concurrency.md#pipes-batching).
# EventBridge Référence du schéma du journal des tuyaux
La référence suivante détaille le schéma des enregistrements du journal EventBridge Pipes.
Chaque enregistrement de journal représente une étape d’exécution du canal et peut contenir jusqu’à 10 000 événements si la source et la cible du canal ont été configurées pour le traitement par lots.
Pour de plus amples informations, veuillez consulter [Enregistrement des performances d'Amazon EventBridge Pipes](eb-pipes-logs.md).
```
{
"executionId": "guid",
"timestamp": "date_time",
"messageType": "execution_step",
"resourceArn": "arn:aws:pipes:region:account:pipe/pipe-name",
"logLevel": "TRACE | INFO | ERROR",
"payload": "{}",
"awsRequest": "{}"
"awsResponse":"{}"
"truncatedFields": ["awsRequest","awsResponse","payload"],
"error": {
"httpStatusCode": code,
"message": "error_message",
"details": "",
"awsService": "service_name",
"requestId": "service_request_id"
}
}
```
**executionId**
ID de l’exécution de canal.
Une exécution de canal est un événement ou un lot d’événements reçu par un canal en direction d’un enrichissement ou d’une cible. Pour de plus amples informations, veuillez consulter [Comment fonctionne la journalisation sur Amazon EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-overview).
**timestamp**
Date et heure auxquelles l’événement de journal a été émis.
Unité : milliseconde
**messageType**
Étape d’exécution du canal pour laquelle l’enregistrement a été généré.
Pour plus d’informations sur les étapes d’exécution d’un canal, consultez [EventBridge Étapes d'exécution des tuyaux](eb-pipes-logs-execution-steps.md).
**resourceArn**
Amazon Resource Name (ARN) du canal.
**logLevel**
Niveau de détail spécifié pour le journal du canal.
*Valeurs valides* : `ERROR` \$1 `INFO` \$1 `TRACE`
Pour de plus amples informations, veuillez consulter [Spécification du niveau de journalisation des EventBridge tuyaux](eb-pipes-logs.md#eb-pipes-logs-level).
**payload**
Contenu du lot d’événements traité par le canal.
EventBridge inclut ce champ uniquement si vous avez spécifié d'inclure les données d'exécution dans les journaux de ce canal. Pour de plus amples informations, consultez [Inclure les données d'exécution dans les logs de EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-execution-data).
Ces champs peuvent contenir des informations sensibles. EventBridge ne tente pas de supprimer le contenu de ces champs pendant la journalisation.
Pour de plus amples informations, veuillez consulter [Inclure les données d'exécution dans les logs de EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-execution-data).
**awsRequest**
Demande envoyée à l’enrichissement ou à la cible, au format JSON. Pour les demandes envoyées à une destination d’API, il s’agit de la requête HTTP envoyée à ce point de terminaison.
EventBridge inclut ce champ uniquement si vous avez spécifié d'inclure les données d'exécution dans les journaux de ce canal. Pour de plus amples informations, consultez [Inclure les données d'exécution dans les logs de EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-execution-data).
Ces champs peuvent contenir des informations sensibles. EventBridge ne tente pas de supprimer le contenu de ces champs pendant la journalisation.
Pour de plus amples informations, veuillez consulter [Inclure les données d'exécution dans les logs de EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-execution-data).
**awsResponse**
Réponse renvoyée par l’enrichissement ou la cible, au format JSON. Pour les demandes envoyées à une destination d’API, il s’agit de la réponse HTTP renvoyée par ce point de terminaison, pas la réponse renvoyée par le service de destination d’API lui-même.
EventBridge inclut ce champ uniquement si vous avez spécifié d'inclure les données d'exécution dans les journaux de ce canal. Pour de plus amples informations, consultez [Inclure les données d'exécution dans les logs de EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-execution-data).
Ces champs peuvent contenir des informations sensibles. EventBridge ne tente pas de supprimer le contenu de ces champs pendant la journalisation.
Pour de plus amples informations, veuillez consulter [Inclure les données d'exécution dans les logs de EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-execution-data).
**truncatedFields**
La liste de tous les champs de données d'exécution EventBridge a été tronquée pour maintenir l'enregistrement en dessous de la limite de taille de 256 Ko.
S'il EventBridge n'est pas nécessaire de tronquer aucun des champs de données d'exécution, ce champ est présent mais`null`.
Pour de plus amples informations, veuillez consulter [Tronquer les données d'exécution dans les enregistrements du journal EventBridge Pipes](eb-pipes-logs.md#eb-pipes-logs-execution-data-truncation).
**error**
Contient des informations relatives aux erreurs générées lors de cette étape d’exécution du canal.
Si aucune erreur n’a été générée lors de cette étape d’exécution du canal, ce champ est présent mais `null`.
**httpStatusCode**
Code de statut HTTP renvoyé par le service appelé.
**message**
Message d’erreur renvoyé par le service appelé.
**details**
Toute information d’erreur détaillée renvoyée par le service appelé.
**awsService**
Nom du service appelé.
**requestId**
ID de cette demande provenant du service appelé.
# Enregistrement et surveillance d'Amazon EventBridge Pipes à l'aide d'Amazon CloudWatch Logs
Vous pouvez enregistrer EventBridge les invocations de Pipes à l'aide de métriques CloudTrail et surveiller leur état de santé. CloudWatch
## CloudWatch métriques
EventBridge Pipes envoie des métriques à Amazon CloudWatch toutes les minutes, qu'il s'agisse d'une exécution limitée d'un canal ou d'une cible invoquée avec succès.
| Métrique | Description | Dimensions | Uunités |
| --- | --- | --- | --- |
| `Concurrency` | Nombre d’exécutions simultanées d’un canal. | AwsAccountId | Aucune |
| `Duration` | Durée d’exécution du canal. | PipeName | Millisecondes |
| `EventCount` | Nombre d’événements traités par un canal. | PipeName | Aucune |
| `EventSize` | Taille de la charge utile de l’événement qui a invoqué le canal. | PipeName | Octets |
| `ExecutionThrottled` | Nombre d’exécutions d’un canal qui ont été limitées. Cette valeur est de `0` si aucune exécution n’a été limitée. | AwsAccountId, PipeName | Aucune |
| `ExecutionTimeout` | Nombre d’exécutions d’un canal qui ont expiré avant la fin de l’exécution. Cette valeur est de `0` si aucune exécution n’a expiré. | PipeName | Aucune |
| `ExecutionFailed` | Nombre d’exécutions d’un canal ayant échoué. Cette valeur est de `0` si aucune exécution n’a échoué. | PipeName | Aucune |
| `ExecutionPartiallyFailed` | Nombre d’exécutions d’un canal ayant partiellement échoué. Cette valeur est de `0` si aucune exécution n’a partiellement échoué. | PipeName | Aucune |
| `EnrichmentStageDuration` | Durée de l’étape d’enrichissement. | PipeName | Millisecondes |
| `EnrichmentStageFailed` | Nombre d’exécutions de l’étape d’enrichissement d’un canal ayant échoué. Cette valeur est de `0` si aucune exécution n’a échoué. | PipeName | Aucune |
| `Invocations` | Nombre total d’invocations. | AwsAccountId, PipeName | Aucune |
| `TargetStageDuration` | Durée de l’étape de la cible. | PipeName | Millisecondes |
| `TargetStageFailed` | Nombre d’exécutions de l’étape de la cible d’un canal ayant échoué. Cette valeur est de `0` si aucune exécution n’a échoué. | PipeName | Aucune |
| `TargetStagePartiallyFailed` | Nombre d’exécutions de l’étape de la cible d’un canal ayant partiellement échoué. Cette valeur est de `0` si aucune exécution de l’étape de la cible n’a partiellement échoué. | PipeName | Aucune |
| `TargetStageSkipped` | Nombre d’exécutions de l’étape de la cible d’un canal qui ont été ignorées (en raison du renvoi d’une charge utile vide par l’enrichissement, par exemple). | PipeName | Nombre |
## Dimensions pour les CloudWatch métriques
CloudWatch les métriques ont des *dimensions*, ou des attributs triables, qui sont répertoriés ci-dessous.
| Dimension | Description |
| --- | --- |
| AwsAccountId | Filtre les métriques disponibles par ID de compte. |
| PipeName | Filtre les métriques disponibles par nom de canal. |