Utilizzo di mappe di servizio e viste di traccia di AWS X-Ray con Gateway API
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 di mappa dei servizi di X-Ray
AWS X-RayLe mappe di servizio mostrano informazioni sull'API e su tutti i relativi servizi downstream. Quando X-Ray è abilitato per una fase API in API Gateway, sarà possibile visualizzare un nodo nella mappa di servizio che contiene informazioni sul tempo complessivo passato 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 l'integrazione delle API con servizi AWS quali AWS Lambda e Amazon DynamoDB, visualizzerai altri nodi con parametri di prestazioni relativi a questi 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 di servizio, consulta Use the X-Ray trace map.

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, consultare AWS Lambda e AWS X-Ray.
Se scegli un nodo o un edge su una mappa di servizio di X-Ray, la console di X-Ray mostra un istogramma della 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.

Esempio di visualizzazione del monitoraggio di X-Ray
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.
