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.
# Configuration des journaux pour les bus EventBridge d'événements Amazon
Vous pouvez configurer EventBridge pour envoyer des journaux détaillant la façon dont un bus d'événements traite les événements, afin de faciliter le dépannage et le débogage.
Vous pouvez sélectionner les AWS services suivants comme destinations de * journaux * vers lesquelles les journaux EventBridge sont envoyés pour le bus d'événements spécifié :
+ CloudWatch Journaux Amazon
EventBridge fournit les journaux au groupe de CloudWatch journaux de journaux spécifié.
Utilisez CloudWatch les journaux pour centraliser les journaux de tous vos systèmes, applications et AWS services que vous utilisez, dans un service unique et hautement évolutif. Pour plus d'informations, consultez la section [ Utilisation de groupes de journaux et de flux de CloudWatch journaux ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) dans le guide de l'utilisateur * Amazon Logs*.
+ Amazon Data Firehose
EventBridge transmet les journaux à un flux de diffusion Firehose.
Amazon Data Firehose est un service entièrement géré permettant de diffuser des données de streaming en temps réel vers des destinations telles que certains AWS services, ainsi que vers tout point de terminaison HTTP personnalisé ou 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 * Amazon Data Firehose. *
+ Amazon S3
EventBridge transmet les journaux 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 pour les bus événementiels
EventBridge génère des journaux pour :
+ Tout événement AWS de service correspondant à une règle sur le bus d'événements
+ Tout événement diffusé par les méthodes suivantes, qu'il ait été ingéré avec succès ou qu'il corresponde à l'une des règles :
+ Événements provenant de sources d'événements [ partenaires ](eb-saas.md)
+ Événements [ rejoués à partir d'une archive ](eb-archive.md)
+ Événements envoyés au bus via [`PutEvents`](eb-putevents.md)
EventBridge n'enregistre pas les événements qui correspondent uniquement aux règles [ gérées](eb-rules.md#eb-rules-managed).
Les données de journal envoyées à chaque destination de journal sélectionnée sont les mêmes.
Vous pouvez personnaliser les journaux EventBridge envoyés vers les destinations sélectionnées de la manière suivante :
+ Vous pouvez spécifier le niveau de * journalisation*, qui détermine les étapes pour lesquelles EventBridge les journaux sont envoyés aux destinations sélectionnées. Pour de plus amples informations, veuillez consulter [Spécification du niveau du journal des bus d'événements](#eb-event-bus-logs-level).
+ Vous pouvez spécifier si EventBridge des informations plus détaillées sont incluses le cas échéant, notamment :
+ Détails de l’événement
+ Informations d'entrée cibles
+ Informations sur la demande cible
Pour de plus amples informations, veuillez consulter [Inclusion de données détaillées dans les journaux des bus d'événements](#eb-event-logs-data).
### Considérations relatives à la livraison des
Gardez les considérations suivantes à l'esprit lorsque vous configurez la journalisation des bus d'événements :
+ Les registres des bus des événements sont fournis dans les meilleurs délais. La plupart des demandes concernant un bus d'événements correctement configuré pour la journalisation aboutissent à la livraison d'un enregistrement de journal. L'exhaustivité et l'actualité de l'enregistrement des bus des événements ne sont pas garanties.
+ Dans certaines circonstances, la fourniture des enregistrements du journal des bus d'événements génère elle-même des événements qui sont ensuite envoyés EventBridge, ce qui peut perturber la livraison des enregistrements du journal. Pour cette raison, EventBridge n'enregistre pas les événements suivants :
+ AWS KMS `[Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html)`et les `[GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html)` événements générés lorsque des enregistrements de journal chiffrés à l'aide d'une clé gérée par le client sont transmis à une destination de journal.
+ `[PutRecordBatch](https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html)`événements dans Firehose générés par la livraison de journaux de bus d'événements.
+ Pour les destinations de journaux S3, il n'est pas recommandé de spécifier un compartiment de destination avec la notification d'[événements pour EventBridge ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) activée, car cela peut perturber la livraison de vos journaux.
### Chiffrement des journaux
Lors de l'envoi de journaux, EventBridge chiffre les `error` sections `detail` et de chaque enregistrement de journal avec la clé KMS spécifiée pour le bus d'événements. Une fois livré, l'enregistrement est déchiffré puis rechiffré avec la clé KMS spécifiée pour la destination du journal.
Pour de plus amples informations, veuillez consulter [Chiffrement des journaux des bus d'événements](encryption-bus-logs.md).
### Spécifier les autorisations de journalisation des bus d'événements
Pour activer la journalisation à partir d'un bus d'événements, associez la politique d'identité suivante à votre identité AWS Identity and Access Management (IAM) (utilisateur ou rôle). Cette politique octroie l'`events:AllowVendedLogDeliveryForResource`action pour le bus de l'événement.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ServiceLevelAccessForLogDelivery",
"Effect": "Allow",
"Action": [
"events:AllowVendedLogDeliveryForResource"
],
"Resource": "arn:aws:events:{{us-east-1}}:{{123456789012}}:event-bus/{{my-event-bus}}*"
}
]
}
```
------
Pour plus d'informations, consultez [ Service-specific les autorisations ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions) dans le Guide de l'utilisateur * CloudWatch des journaux*.
## Spécification du niveau du journal des bus d'événements
Vous pouvez spécifier les types d'étapes de traitement des événements qui EventBridge se connectent aux destinations de journal sélectionnées.
Choisissez parmi les niveaux de détail suivants à inclure dans les journaux. Le niveau de journalisation s'applique à toutes les destinations de journalisation spécifiées pour le bus d'événements. Chaque niveau de journalisation inclut les étapes des niveaux de journalisation précédents.
+ **OFF ** : EventBridge n'envoie aucun journal. Il s’agit de l’option par défaut.
+ **ERREUR ** : EventBridge envoie tous les journaux liés aux erreurs générées lors du traitement de l'événement et de la livraison de la cible.
+ **INFO ** — EventBridge envoie tous les journaux liés aux erreurs, ainsi que les principales étapes effectuées lors du traitement des événements.
+ **TRACE ** : EventBridge envoie tous les journaux générés à toutes les étapes du traitement de l'événement.
Le tableau suivant répertorie les étapes de traitement des événements incluses dans chaque niveau de journalisation.
| Step (Étape) | TRACE | INFO | ERROR | OFF |
| --- | --- | --- | --- | --- |
| Événement ingéré | x | x | | |
| Échec de l'ingestion des événements | x | h/24, j/7 | x | |
| Événement reçu | x | | | |
| Tentative d'invocation démarrée | x | | | |
| Échec permanent de la tentative d'invocation | x | h/24, j/7 | x | |
| Echec de la tentative d' Retry-able invocation | x | h/24, j/7 | x | |
| Tentative d'invocation réussie | x | | | |
| Tentative d'invocation limitée | x | h/24, j/7 | x | |
| Invocation DLQ | x | h/24, j/7 | x | |
| Échec de l'invocation | x | h/24, j/7 | x | |
| Invocation commencée | x | x | | |
| Invocation réussie | x | x | | |
| Invocation Throttle a démarré | x | h/24, j/7 | x | |
| Aucune règle ne correspond | x | x | | |
| Règle correspondante | x | x | | |
| La correspondance des règles a commencé | x | | | |
## Inclusion de données détaillées dans les journaux des bus d'événements
Vous pouvez spécifier EventBridge pour inclure des informations plus détaillées dans les journaux qu'il génère. Ces données peuvent être utiles pour le dépannage et le débogage. Si vous sélectionnez cette option, EventBridge inclut ces données dans les enregistrements pertinents pour toutes les destinations de journal spécifiées.
Les informations détaillées incluent les champs suivants :
+ `event_detail`: Les détails de l'événement lui-même.
+ `target_input`: la demande EventBridge est envoyée à la cible.
+ `target_properties`:
## Tronquer les données dans les journaux des bus d'événements
En raison des contraintes liées à la destination EventBridge des journaux, limite les enregistrements à 1 Mo. Si un enregistrement de journal dépasse cette limite, EventBridge tronque l'enregistrement en supprimant les champs suivants dans l'ordre suivant :
+ `target_input`
+ `target_properties`
+ `target_response_body`
EventBridge supprime le `event_detail` champ des types d'enregistrement de journal suivants si nécessaire :
+ `EVENT_RECEIVED`
+ `EVENT_INGESTED`
+ `EVENT_INGESTED_FAILED`
+ `RULE_MATCH_STARTED`
Si une troncature est nécessaire, EventBridge supprime la totalité du champ.
Si EventBridge les champs de l'événement sont tronqués, le `dropped_fields` champ inclut une liste des champs de données excisés.
## Signalement d'erreurs dans les journaux des bus d'événements
EventBridge inclut également des données d'erreur, le cas échéant, par étapes qui représentent les états de défaillance. Les étapes sont les suivantes :
+ `EVENT_INGEST_FAILURE`
+ `INVOCATION_THROTTLE_START`
+ `INVOCATION_ATTEMPT_THROTTLE`
+ `INVOCATION_ATTEMPT_RETRYABLE_FAILURE`
+ `INVOCATION_ATTEMPT_PERMANENT_FAILURE`
+ `INVOCATION_FAILURE`
+ `INVOCATION_DLQ`