View a markdown version of this page

Guida introduttiva con 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 con X-Ray

Nota

X-Ray SDK/Daemon Avviso di manutenzione: il 25 febbraio 2026 AWS X-Ray SDKs/Daemon entrerà in modalità manutenzione, che AWS limiterà le versioni di X-Ray SDK e Daemon per risolvere solo i problemi di sicurezza. Per ulteriori informazioni sulla tempistica dell'assistenza, 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 X-Ray strumentazione alla strumentazione. OpenTelemetry

Per utilizzarlo, procedi nel seguente X-Ray modo:

  1. Strumenta la tua applicazione, che consente di X-Ray tenere traccia del modo in cui l'applicazione elabora una richiesta.

    • Usa gli X-Ray SDK, le X-Ray API ADOT o i segnali CloudWatch applicativi a cui inviare dati di traccia. 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) Configura X-Ray per lavorare con 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' X-Ray SDK registrerà i dati di traccia, segmento e sottosegmento. In questo passaggio, potresti anche dover impostare una policy IAM e distribuire un agente o un raccoglitore.

  4. (Facoltativo) Apri una console per visualizzare e analizzare i dati. È possibile visualizzare una rappresentazione GUI di una mappa di tracciamento, una mappa dei servizi e altro ancora per verificare il funzionamento dell'applicazione. Usa le informazioni grafiche nella console per ottimizzare, eseguire il debug e comprendere la tua applicazione. Per ulteriori informazioni sulla scelta di una console, vedere. Usa una console

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

X-Ray visualizza informazioni dettagliate sulle richieste delle applicazioni, tra cui stato, durata e codice di risposta HTTP.

Per un esempio dei dati e delle mappe disponibili nella console, avvia un'applicazione di esempio già dotata degli strumenti per generare dati di traccia. In pochi minuti, è possibile generare traffico, inviare segmenti e visualizzare una X-Ray mappa di tracciamento e servizi.