Connectez-vous à 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 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 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 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 en direction d’un enrichissement et/ou d’une cible. Si cette option est activée, EventBridge génère un enregistrement de journal pour chaque étape d'exécution effectué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 plus d’informations, consultez Traitement par lots et simultanéité d'Amazon EventBridge Pipes.

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 plus d’informations, consultez Spécification du niveau de journalisation des EventBridge tuyaux.

• 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 plus d’informations, consultez Inclure les données d'exécution dans les logs de EventBridge Pipes.

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.

É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 lors de 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 d'enrichissement et de 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êmeawsRequest, 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.

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