View a markdown version of this page

EventBridge Intégration d'Amazon avec AWS X-Ray - Amazon EventBridge

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.

EventBridge Intégration d'Amazon avec AWS X-Ray

Vous pouvez l'utiliser AWS X-Ray pour suivre les événements qui se produisent EventBridge. EventBridge transmet l'en-tête de trace d'origine à la cible afin que les services cibles puissent suivre, analyser et déboguer.

Note

Cette page s'applique à Custom Event Bus - Classic. Un abonné à Custom Event Bus propage un en-tête de trace vers les cibles Step Functions via StepFunctionsParameters.TraceHeader et vers les cibles Amazon SQS via MessageSystemAttributes ; voir. Objectifs pour un abonné à Custom Event Bus

EventBridge peut transmettre un en-tête de trace pour un événement uniquement si l'événement provient d'une PutEvents demande qui a transmis le contexte de trace. X-Ray ne trace pas les événements provenant de partenaires tiers, d'événements planifiés ou de AWS services, et ces sources d'événements n'apparaissent pas sur votre carte des X-Ray services.

X-Ray valide les en-têtes de trace et les en-têtes de trace qui ne sont pas valides sont supprimés. Cependant, l’événement est toujours traité.

Important

L’en-tête de suivi n’est pas disponible sur l’événement livré à la cible d’invocation.

  • Si vous avez une archive d’événement, l’en-tête de suivi n’est pas disponible pour les événements archivés. Si vous relisez des événements archivés, l’en-tête de suivi n’est pas inclus.

  • Si vous avez une file d’attente de lettres mortes (DLQ), l’en-tête de suivi est inclus dans la demande SendMessage qui envoie l’événement à la DLQ. Si vous récupérez des événements (messages) de la DLQ en utilisant ReceiveMessage, l’en-tête de suivi associé à l’événement est inclus dans l’attribut de message Amazon SQS, mais il n’est pas inclus dans le message d’événement.

Pour plus d'informations sur la manière dont un nœud d' EventBridge événement connecte les services source et cible, consultez la section Affichage de la source et des cibles sur la carte des X-Ray services du Guide du AWS X-Ray développeur.

Vous pouvez transmettre les informations d'en-tête de trace suivantes via EventBridge :

  • En-tête HTTP par défaut  : le X-Ray SDK remplit automatiquement l'en-tête de trace en tant qu'en-tête X-Amzn-Trace-Id HTTP pour toutes les cibles d'invocation. Pour en savoir plus sur l’en-tête HTTP par défaut, consultez En-tête de suivi dans le Guide du développeur AWS X-Ray .

  • TraceHeaderattribut système — TraceHeader est un PutEventsRequestEntry attribut réservé EventBridge pour transporter l'en-tête de X-Ray trace vers une cible. Si vous utilisez également PutEventsRequestEntry, PutEventsRequestEntry remplace l’en-tête de suivi HTTP.

Note

L’en-tête de suivi n’est pas pris en compte dans la taille de l’événement PutEventsRequestEntry. Pour plus d’informations, consultez Calculer la taille des inscriptions à un PutEvents événement.

La vidéo suivante montre comment utiliser X-Ray et EventBridge associer :