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 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 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 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
Événements rejoués à partir d'une archive
Événements envoyés au bus via PutEvents
EventBridge n'enregistre pas les événements qui correspondent uniquement aux règles gérées.
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.
-
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.
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
Decryptet lesGenerateDataKeyé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é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 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.
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:AllowVendedLogDeliveryForResourceaction pour le bus de l'événement.
Pour plus d'informations, consultez Service-specific les autorisations 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_RECEIVEDEVENT_INGESTEDEVENT_INGESTED_FAILEDRULE_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_FAILUREINVOCATION_THROTTLE_STARTINVOCATION_ATTEMPT_THROTTLEINVOCATION_ATTEMPT_RETRYABLE_FAILUREINVOCATION_ATTEMPT_PERMANENT_FAILUREINVOCATION_FAILUREINVOCATION_DLQ
