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 manière 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 journal vers lesquelles sont EventBridge envoyés les journaux pour le bus d'événements spécifié :
Amazon CloudWatch Logs
EventBridge fournit des 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 de CloudWatch journaux dans le guide de l'utilisateur Amazon Logs.
Amazon Data Firehose
EventBridge fournit des journaux à 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 dans le guide de l'utilisateur d'Amazon Data Firehose.
Amazon S3
EventBridge fournit 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 dédiés aux événements
EventBridge génère des journaux pour :
-
Tout événement AWS de service correspondant à une règle du bus d'événements
-
Tout événement délivré par les méthodes suivantes, qu'il soit ingéré avec succès ou qu'il réponde à une règle quelconque :
É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 aux destinations sélectionnées de la manière suivante :
Vous pouvez spécifier le niveau de journalisation, qui détermine les étapes d' EventBridgeenvoi des journaux vers les destinations sélectionnées. Pour de plus amples informations, veuillez consulter Spécification du niveau de journalisation du bus d'événements.
-
Vous pouvez spécifier s'il EventBridge inclut des informations plus détaillées 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 Intégration de données détaillées dans les journaux des bus d'événements.
Considérations relatives à la livraison du
Tenez compte des considérations suivantes lorsque vous configurez la journalisation pour les bus d'événements :
Les enregistrements du bus d'événements sont fournis dans la mesure du possible. 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 événements par bus ne sont pas garanties.
Dans certaines circonstances, la livraison des enregistrements du 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 livrés à 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 des journaux S3, il n'est pas recommandé de spécifier un compartiment de destination dont la notification d'événement est 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écification des autorisations de journalisation du bus d'événements
Pour activer la journalisation à partir d'un bus d'événements, vous devez autoriser l'envoi de journaux EventBridge à partir de ce bus. Ajoutez une politique qui accorde des AllowVendedLogDeliveryForResourceautorisations au bus d'événements.
Pour plus d'informations, consultez la section Autorisations spécifiques au service dans le Guide de l'utilisateur CloudWatch des journaux.
Spécification du niveau de journalisation du 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 journal 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 relatifs aux erreurs générées lors du traitement des événements et de la livraison cible.
-
INFO — EventBridge envoie tous les journaux relatifs 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 au cours de toutes les étapes du traitement des événements.
Le tableau suivant répertorie les étapes de traitement des événements incluses dans chaque niveau de journalisation.
| Étape | TRACE | INFO | ERROR | OFF |
|---|---|---|---|---|
|
Événement ingéré |
x | x | ||
|
L'ingestion de l'événement a échoué |
x | h/24, j/7 | x | |
|
Événement reçu |
x | |||
|
Tentative d'invocation lancée |
x | |||
|
Echec permanent de la tentative d'invocation |
x | h/24, j/7 | x | |
|
Echec de la tentative d'invocation réessayable |
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 | ||
|
L'accélérateur d'invocation a démarré |
x | h/24, j/7 | x | |
|
Aucune règle correspondante |
x | x | ||
|
Règle correspondante |
x | x | ||
|
Mise en correspondance des règles |
x |
Intégration 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:
Troncation des 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 la troncature est nécessaire, le EventBridge champ entier est supprimé.
Si EventBridge des champs sont tronqués dans l'événement, 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 les données d'erreur, lorsqu'elles sont disponibles, dans les étapes représentant 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
