View a markdown version of this page

Utilizzo AWS X-Ray mappe dei servizi e viste di tracciamento con API Gateway - Gateway Amazon API

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

Utilizzo AWS X-Ray mappe dei servizi e viste di tracciamento con API Gateway

In questa sezione sono disponibili informazioni dettagliate sull'utilizzo delle mappe di servizio e delle viste di monitoraggio di AWS X-Ray con API Gateway.

Esempio X-Ray di mappa dei servizi

AWS X-Ray le mappe dei servizi mostrano informazioni sull'API e su tutti i relativi servizi a valle. Quando X-Ray è abilitato per una fase API in API Gateway, vedrai un nodo nella mappa dei servizi contenente informazioni sul tempo complessivo trascorso nel servizio API Gateway. Puoi ottenere informazioni dettagliate sullo stato della risposta e un istogramma del tempo di risposta dell'API nel periodo di tempo selezionato. Per le API che si integrano con AWS servizi come AWS Lambda Amazon DynamoDB, vedrai più nodi che forniscono metriche prestazionali relative a tali servizi. C'è una mappa di servizio per ogni fase API.

L'esempio seguente mostra una mappa di servizio per la fase test di un'API denominata xray. Quest’API dispone di due integrazioni Lambda. I nodi rappresentano il servizio Gateway API e le due funzioni Lambda.

Per una spiegazione dettagliata della struttura della mappa dei servizi, consulta Utilizzare la mappa di tracciamento. X-Ray

Esempio di mappa del servizio di una fase API di API Gateway

La mappa dei servizi può essere ingrandita per mostrare una vista della traccia della fase API. La traccia visualizza informazioni approfondite riguardanti l'API, rappresentate come segmenti e segmenti secondari. Ad esempio, il monitoraggio della mappa di servizio mostrata sopra include i segmenti del servizio Lambda e della funzione Lambda. Per ulteriori informazioni, vedere AWS Lambda e AWS X-Ray.

Se scegli un nodo o un edge su una mappa dei X-Ray servizi, la X-Ray console mostra un istogramma di distribuzione della latenza. Puoi utilizzare un istogramma della latenza per visualizzare il tempo impiegato da un servizio per completare le richieste. Di seguito è riportato un istogramma della fase dell'API Gateway denominata xray/test nella precedente mappa di servizio. Per una spiegazione dettagliata degli istogrammi di distribuzione della latenza, consulta Use Latency Histograms.

X-Ray istogramma di una fase API Gateway

Esempio di visualizzazione della X-Ray traccia

Il seguente diagramma mostra una vista del monitoraggio generato per l’API di esempio descritta in precedenza, con una funzione di backend Lambda. Viene mostrata una richiesta metodo API andata a buon fine con codice di risposta pari a 200.

Per una spiegazione dettagliata delle viste di traccia, consulta View traces and trace details.

API Gateway con monitoraggio in modalità attiva abilitato