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à.

# Guida introduttiva a X-Ray
<a name="xray-gettingstarted"></a>

**Nota**  
Avviso di SDK/Daemon manutenzione a raggi X: il 25 febbraio 2026, X-Ray SDKs/Daemon entrerà in modalità di manutenzione, in cui AWS limiterà le versioni di AWS X-Ray SDK e Daemon per risolvere solo problemi di sicurezza. Per ulteriori informazioni sulla tempistica del supporto, consulta. [Cronologia di X-Ray SDK e Daemon Support](xray-sdk-daemon-timeline.md) Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere [Migrazione dalla strumentazione a raggi X](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html) alla strumentazione. OpenTelemetry 

Per utilizzare X-Ray, procedi nel seguente modo:

1. Strumenta la tua applicazione, il che consente a X-Ray di tracciare il modo in cui l'applicazione elabora una richiesta.
   + Usa X-Ray APIs, SDKs X-Ray ADOT o CloudWatch Application Signals per inviare dati di traccia a X-Ray. Per ulteriori informazioni sull'interfaccia da utilizzare, vedere. [Scelta di un'interfaccia](aws-xray-interface.md)

    Per ulteriori informazioni sulla strumentazione, vedere. [Strumentazione della tua applicazione per AWS X-Ray](xray-instrumenting-your-app.md)

1. (Facoltativo) Configurare X-Ray per utilizzarne altri Servizi AWS che si integrano con X-Ray. È possibile campionare le tracce e aggiungere intestazioni alle richieste in arrivo, eseguire un agente o un raccoglitore e inviare automaticamente i dati di traccia a X-Ray. Per ulteriori informazioni, consulta [Integrazione AWS X-Ray con altri Servizi AWS](xray-services.md).

1. Implementa la tua applicazione strumentata. Man mano che l'applicazione riceve le richieste, l'SDK X-Ray registrerà i dati di traccia, segmento e sottosegmento. In questa fase, potresti anche dover configurare una policy IAM e implementare un agente o un raccoglitore.
   +  [Ad esempio gli script per distribuire un'applicazione utilizzando l'SDK AWS Distro for OpenTelemetry (ADOT) e l' CloudWatch agente su piattaforme diverse, consulta Application Signals Demo Scripts.](https://github.com/aws-observability/application-signals-demo/tree/main/scripts)
   + Per uno script di esempio per distribuire un'applicazione utilizzando l'SDK X-Ray e il demone X-Ray, vedere. [AWS X-Ray applicazione di esempio](xray-scorekeep.md)

1. (Facoltativo) Aprire una console per visualizzare e analizzare i dati. È possibile visualizzare una rappresentazione GUI di una mappa di tracciamento, di una mappa dei servizi e altro ancora per verificare il funzionamento dell'applicazione. Utilizzate le informazioni grafiche nella console per ottimizzare, eseguire il debug e comprendere l'applicazione. Per ulteriori informazioni sulla scelta di una console, consulta. [Usa una console](aws-xray-interface-console.md)

Il diagramma seguente mostra come iniziare a usare X-Ray:

![\[X-Ray visualizza informazioni dettagliate sulle richieste delle applicazioni, tra cui lo stato, la durata e il codice di risposta HTTP.\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/xray-get-started.png)


Per un esempio dei dati e delle mappe disponibili nella console, avviate un'[applicazione di esempio](xray-scorekeep.md) già dotata di strumenti per generare dati di traccia. In pochi minuti, puoi generare traffico, inviare segmenti a X-Ray e visualizzare una mappa di tracciamento e di servizio.