View a markdown version of this page

Usa l' X-Ray API - 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à.

Usa l' X-Ray API

Se l' X-Ray SDK non supporta il tuo linguaggio di programmazione, puoi utilizzare direttamente le X-Ray API o AWS Command Line Interface (AWS CLI) per chiamare i comandi X-Ray API. Usa le seguenti linee guida per scegliere come interagire con l'API:

  • Utilizza AWS CLI la sintassi più semplice utilizzando comandi preformattati o con opzioni all'interno della richiesta.

  • Usa direttamente l' X-Ray API per la massima flessibilità e personalizzazione delle richieste che invii. X-Ray

Se si utilizza direttamente l'X-Ray API anziché il AWS CLI, è necessario parametrizzare la richiesta nel formato di dati corretto e potrebbe anche essere necessario configurare l'autenticazione e la gestione degli errori.

Il diagramma seguente mostra le linee guida per scegliere come interagire con l' X-RayAPI:

X-Ray visualizza informazioni dettagliate sulle richieste delle applicazioni.

Utilizza l' X-Ray API per inviare i dati di tracciamento direttamente a X-Ray. L' X-Ray API supporta tutte le funzioni disponibili nell' X-Ray SDK, incluse le seguenti azioni comuni:

  • PutTraceSegments— Carica i documenti dei segmenti in. X-Ray

  • BatchGetTraces— Recupera un elenco di tracce in un elenco di ID di traccia. Ogni traccia recuperata è una raccolta di documenti segmentati da una singola richiesta.

  • GetTraceSummaries— Recupera gli ID e le annotazioni per le tracce. È possibile specificare FilterExpression a per recuperare un sottoinsieme di riepiloghi delle tracce.

  • GetTraceGraph— Recupera un grafico del servizio per un ID di traccia specifico.

  • GetServiceGraph— Recupera un documento JSON formattato che descrive i servizi che elaborano le richieste in arrivo e chiamano le richieste a valle.

È inoltre possibile utilizzare la AWS Command Line Interface (AWS CLI) all'interno del codice dell'applicazione per interagire in modo programmatico. X-Ray AWS CLI Supporta tutte le funzioni disponibili nell' X-Ray SDK, incluse quelle per altri. Servizi AWS Le seguenti funzioni sono versioni delle operazioni API elencate in precedenza con un formato più semplice:

  • put-trace-segments — Carica i documenti dei segmenti in. X-Ray

  • batch-get-trace — Recupera un elenco di tracce in un elenco di ID di traccia. Ogni traccia recuperata è una raccolta di documenti segmentati da una singola richiesta.

  • get-trace-summaries: recupera gli ID e le annotazioni per le tracce. È possibile specificare a per recuperare un sottoinsieme di riepiloghi FilterExpression delle tracce.

  • get-trace-graph — Recupera un grafico del servizio per un ID di traccia specifico.

  • get-service-graph — Recupera un documento JSON formattato che descrive i servizi che elaborano le richieste in arrivo e chiamano le richieste a valle.

Per iniziare, devi installare il file per il tuo sistema operativo. AWS CLI AWS supporti Linux macOS e sistemi Windows operativi. Per ulteriori informazioni sull'elenco dei X-Ray comandi, consulta la guida di riferimento ai AWS CLI comandi per X-Ray.

Argomenti