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:
-
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
-
-
(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.
-
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.
-
Ad esempio, gli script per distribuire un'applicazione utilizzando l'SDK AWS Distro for OpenTelemetry (ADOT) e l' CloudWatch agente su piattaforme diverse, vedi 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 e il X-Ray demone, vedere. X-Ray AWS X-Ray applicazione di esempio
-
-
(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:
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.