As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# EventBridge Integração da Amazon com AWS X-Ray
<a name="eb-related-service-xray"></a>

Você pode usar AWS X-Ray para rastrear [eventos](eb-events.md) que passam EventBridge. EventBridge passa o cabeçalho de rastreamento original para o [destino](eb-targets.md) para que os serviços de destino possam rastrear, analisar e depurar.

EventBridge só pode passar um cabeçalho de rastreamento para um evento se o evento vier de uma `PutEvents` solicitação que passou pelo contexto de rastreamento. O X-Ray não rastreia eventos originados de parceiros terceirizados, eventos programados ou [serviços da AWS](eb-events.md#eb-service-event), e essas origens de eventos não aparecem no mapa do serviço X-Ray.

O X-Ray valida os cabeçalhos de rastreamento, e os cabeçalhos de rastreamento que não são válidos são descartados. No entanto, o evento ainda está sendo processado.

**Importante**  
O cabeçalho de rastreamento **não** está disponível no evento entregue ao destino da invocação.   
Se tiver um [arquivo de eventos](eb-archive-event.md), o cabeçalho de rastreamento não estará disponível nos eventos arquivados. Se reproduzir eventos arquivados, o cabeçalho de rastreamento não será incluído.
Se tiver uma [fila de mensagens não entregues (DLQ)](eb-rule-dlq.md), o cabeçalho de rastreamento será incluído na solicitação `SendMessage` que envia o evento para a DLQ. Se recuperar eventos (mensagens) da DLQ usando `ReceiveMessage`, o cabeçalho de rastreamento associado ao evento será incluído no atributo de mensagem do Amazon SQS, mas não será incluído na mensagem do evento.

Para obter informações sobre como um nó de EventBridge eventos conecta os serviços de origem e destino, consulte [Visualizando a origem e os destinos no mapa do serviço X-Ray](https://docs.aws.amazon.com//xray/latest/devguide/xray-services-eventbridge.html#xray-services-eventbridge-service-map) no *AWS X-Ray Developer Guide*.

Você pode passar as seguintes informações do cabeçalho de rastreamento por meio de EventBridge:
+ **Cabeçalho HTTP padrão**: o X-Ray SDK preenche automaticamente o cabeçalho de rastreamento como cabeçalho `X-Amzn-Trace-Id` HTTP para todos os destinos de invocação. Para saber mais sobre o cabeçalho HTTP padrão, consulte o [cabeçalho de rastreamento](https://docs.aws.amazon.com//xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader) no *Guia do desenvolvedor do AWS X-Ray *.
+ **`TraceHeader`atributo do sistema** — `TraceHeader` é um [PutEventsRequestEntry atributo](https://docs.aws.amazon.com//eventbridge/latest/APIReference/API_PutEventsRequestEntry.html) reservado por EventBridge para transportar o cabeçalho de rastreamento do X-Ray até um alvo. Se `PutEventsRequestEntry` também é usado, `PutEventsRequestEntry` substitui o cabeçalho de rastreamento HTTP. 

**nota**  
O cabeçalho do rastreamento não conta para o tamanho do evento `PutEventsRequestEntry`. Para obter mais informações, consulte [Calculando o tamanho da entrada do PutEvents evento](eb-putevents.md#eb-putevent-size).

 O vídeo a seguir demonstra o uso do X-Ray and EventBridge together: