Guida introduttiva a X-Ray - AWS X-Ray

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

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 Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere Migrazione dalla strumentazione a raggi X 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

    Per ulteriori informazioni sulla strumentazione, vedere. Strumentazione della tua applicazione per AWS X-Ray

  2. (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.

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

  4. (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

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.

Per un esempio dei dati e delle mappe disponibili nella console, avviate un'applicazione di esempio 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.