Supporto di tracciamento attivo di Amazon API Gateway per AWS 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à.

Supporto di tracciamento attivo di Amazon API Gateway per AWS X-Ray

Puoi usare X-Ray per tracciare e analizzare le richieste degli utenti mentre viaggiano attraverso le API di Amazon API Gateway verso i servizi sottostanti. API Gateway supporta il tracciamento a raggi X per tutti i tipi di endpoint API Gateway: regionali, ottimizzati per l'edge e privati. Puoi usare X-Ray con Amazon API Gateway ovunque Regioni AWS X-Ray sia disponibile. Per ulteriori informazioni, consulta Trace API Gateway API Execution with AWS X-Ray nella Amazon API Gateway Developer Guide.

Nota

X-Ray supporta solo il tracciamento per le API REST tramite API Gateway.

Amazon API Gateway fornisce supporto di tracciamento attivo per AWS X-Ray. Abilita il tracciamento attivo sulle fasi dell'API per campionare le richieste in arrivo e inviare tracce a X-Ray.

Per abilitare il tracciamento attivo su una fase API

  1. Aprire la console Gateway API all'indirizzo https://console.aws.amazon.com/apigateway/.

  2. Scegliere un'API.

  3. Scegliere una fase.

  4. Nella scheda Log/Tracciamento, scegli Abilita tracciamento X-Ray, quindi scegli Salva modifiche.

  5. Scegliere Resources (Risorse) sul pannello di navigazione a sinistra.

  6. Per ridistribuire l'API con le nuove impostazioni, scegli il menu a discesa Azioni, quindi scegli Deploy API.

API Gateway utilizza le regole di campionamento definite nella console X-Ray per determinare quali richieste registrare. È possibile creare regole che si applicano solo alle API o che si applicano solo alle richieste che contengono determinate intestazioni. API Gateway registra le intestazioni negli attributi del segmento, insieme ai dettagli sulla fase e sulla richiesta. Per ulteriori informazioni, consulta Configurazione delle regole di campionamento di .

Nota

Quando si tracciano le API REST con l'integrazione HTTP di API Gateway, il nome di servizio di ogni segmento viene impostato sul percorso dell'URL della richiesta da API Gateway all'endpoint di integrazione HTTP, ottenendo un nodo di servizio sulla mappa di traccia X-Ray per ogni percorso URL univoco. Un numero elevato di percorsi URL può far sì che la mappa di traccia superi il limite di 10.000 nodi, con conseguente errore.

Per ridurre al minimo il numero di nodi di servizio creati da API Gateway, valuta la possibilità di passare i parametri all'interno della stringa di query dell'URL o nel corpo della richiesta tramite POST. Entrambi gli approcci garantiranno che i parametri non facciano parte del percorso URL, il che potrebbe comportare un minor numero di percorsi URL e nodi di servizio distinti.

Per tutte le richieste in entrata, API Gateway aggiunge un'intestazione di tracciamento alle richieste HTTP in entrata che non ne hanno già una.

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793
Formato ID di traccia X-Ray

Una radiografia trace_id è composta da tre numeri separati da trattini. Ad esempio, 1-58406520-a006649127e371903a2de979. Questo include:

  • Il numero di versione, che è. 1

  • L'ora della richiesta originale in Unix epoch time utilizzando 8 cifre esadecimali.

    Ad esempio, il fuso orario PST delle 10:00 del 1° dicembre 2016 è espresso in secondi o in cifre esadecimali. 1480615200 58406520

  • Un identificatore a 96 bit univoco a livello globale per la traccia in 24 cifre esadecimali.

Se il tracciamento attivo è disattivato, la fase memorizza comunque un segmento se la richiesta proviene da un servizio che ha campionato la richiesta e ha avviato un tracciamento. Ad esempio, un'applicazione Web strumentata può chiamare un'API API Gateway con un client HTTP. Quando si strumenta un client HTTP con l'SDK X-Ray, aggiunge un'intestazione di tracciamento alla richiesta in uscita che contiene la decisione di campionamento. API Gateway legge l'intestazione di tracciamento e crea un segmento per le richieste campionate.

Se utilizzi API Gateway per generare un SDK Java per la tua API, puoi strumentare il client SDK aggiungendo un gestore di richieste con il client builder, nello stesso modo in cui strumenteresti manualmente un client SDK. AWS Per istruzioni, consulta Tracciamento delle chiamate AWS SDK con X-Ray SDK for Java.