Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# EventBridge Integrazione Amazon con AWS X-Ray
<a name="eb-related-service-xray"></a>

È possibile utilizzare AWS X-Ray per tracciare [gli eventi](eb-events.md) che EventBridge passano. EventBridge passa l'intestazione di traccia originale alla [destinazione](eb-targets.md) in modo che i servizi di destinazione possano tracciare, analizzare ed eseguire il debug.

EventBridge può passare un'intestazione di traccia per un evento solo se l'evento proviene da una `PutEvents` richiesta che ha superato il contesto di traccia. X-Ray non traccia gli eventi che provengono da partner, eventi pianificati o [AWS servizi](eb-events.md#eb-service-event) di terze parti e queste origini di eventi non vengono visualizzate nella mappa dei servizi X-Ray.

X-Ray convalida le intestazioni di traccia e quelle non valide vengono eliminate. Tuttavia, l'evento continua a essere elaborato.

**Importante**  
L'intestazione di traccia **non** è disponibile nell'evento che viene distribuito alla destinazione dell'invocazione.   
Se disponi di un [archivio di eventi](eb-archive-event.md), l'intestazione di traccia non è disponibile negli eventi archiviati. Se riproduci eventi archiviati, l'intestazione di traccia non è inclusa.
Se disponi di una [coda DLQ](eb-rule-dlq.md), l'intestazione di traccia è inclusa nella richiesta `SendMessage` che invia l'evento alla coda DLQ. Se recuperi eventi (messaggi) dalla coda DLQ utilizzando `ReceiveMessage`, l'intestazione di traccia associata all'evento è inclusa nell'attributo del messaggio Amazon SQS, ma non è inclusa nel messaggio dell'evento.

Per informazioni su come un nodo EventBridge evento connette i servizi di origine e destinazione, vedere [Visualizzazione della sorgente e delle destinazioni nella mappa dei servizi X-Ray](https://docs.aws.amazon.com//xray/latest/devguide/xray-services-eventbridge.html#xray-services-eventbridge-service-map) nella *AWS X-Ray Developer* Guide.

È possibile trasmettere le seguenti informazioni sull'intestazione di traccia tramite: EventBridge
+ **Intestazione HTTP predefinita**: l'SDK X-Ray popola automaticamente l'intestazione di traccia come intestazione HTTP `X-Amzn-Trace-Id` per tutte le destinazioni di invocazione. Per ulteriori informazioni sull'intestazione HTTP predefinita, consulta [Intestazione di traccia](https://docs.aws.amazon.com//xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader) nella *Guida per gli sviluppatori di AWS X-Ray *.
+ **`TraceHeader`attributo di sistema**: `TraceHeader` è un [PutEventsRequestEntry attributo](https://docs.aws.amazon.com//eventbridge/latest/APIReference/API_PutEventsRequestEntry.html) riservato EventBridge a trasportare l'intestazione della traccia X-Ray su un bersaglio. Se utilizzi anche `PutEventsRequestEntry`, `PutEventsRequestEntry` sovrascrive l'intestazione di traccia HTTP. 

**Nota**  
L'intestazione di traccia non viene conteggiato ai fini della dimensione dell'evento `PutEventsRequestEntry`. Per ulteriori informazioni, consulta [Calcolo delle dimensioni di immissione PutEvents degli eventi](eb-putevents.md#eb-putevent-size).

 Il seguente video dimostra l'uso di EventBridge X-Ray e in combinazione: