View a markdown version of this page

Utilizzo AWS X-Ray per tracciare le richieste in AWS AppSync - AWS AppSync GraphQL
Installazione e configurazioneTracciamento della tua API con 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à.

Utilizzo AWS X-Ray per tracciare le richieste in AWS AppSync

È possibile utilizzarlo AWS X-Ray per tracciare le richieste man mano che vengono eseguite in. AWS AppSync Puoi utilizzarlo X-Ray con AWS AppSync in tutte le AWS regioni in cui X-Ray è disponibile. X-Ray offre una panoramica dettagliata di un'intera richiesta GraphQL. In questo modo puoi analizzare le latenze nelle API, nei resolver sottostanti e nelle origini dati. È possibile utilizzare una mappa dei X-Ray servizi per visualizzare la latenza di una richiesta, inclusi tutti AWS i servizi integrati con. X-Ray È inoltre possibile configurare le regole di campionamento per stabilire X-Ray quali richieste registrare e con quali frequenze di campionamento, in base ai criteri specificati.

Per ulteriori informazioni sul campionamento X-Ray, vedere Configurazione delle regole di campionamento nella console. AWS X-Ray

Installazione e configurazione

Puoi abilitare la X-Ray traccia per un'API GraphQL tramite la console. AWS AppSync

  1. Accedi alla console. AWS AppSync

  2. Nel riquadro di navigazione scegliere Settings (Impostazioni).

  3. In X-Ray, attiva Abilita X-Ray.

  4. Scegli Salva. X-Ray il tracciamento è ora abilitato per la tua API.

Se stai usando AWS CLI or AWS CloudFormation, puoi anche abilitare la X-Ray traccia quando crei una nuova AWS AppSync API o aggiorni un' AWS AppSync API esistente, impostando la xrayEnabled proprietà su. true

Quando X-Ray il tracing è abilitato per un' AWS AppSync API, nel tuo account viene creato automaticamente un ruolo AWS Identity and Access Management collegato al servizio con le autorizzazioni appropriate. Ciò consente di AWS AppSync inviare tracce a X-Ray in modo sicuro.

Tracciamento della tua API con X-Ray

Campionamento

Utilizzando le regole di campionamento è possibile controllare la quantità di dati da registrare in AWS AppSync e modificare immediatamente il comportamento del campionamento senza dover cambiare o ridistribuire il codice. Ad esempio, questa regola esegue il campionamento delle richieste all'API GraphQL con l'ID API 3n572shhcpfokwhdnq1ogu59v6.

  • Nome regola - test-sample

  • Priorità - 10

  • Dimensioni riserva - 10

  • Tasso fisso - 10

  • Nome servizio - *

  • Tipo di servizio - AWS::AppSync::GraphQLAPI

  • Metodo HTTP - *

  • Risorsa ARN - arn:aws:appsync:us-west-2:123456789012:apis/3n572shhcpfokwhdnq1ogu59v6

  • Host - *

Informazioni sulle tracce

Quando abiliti il X-Ray tracciamento per la tua API GraphQL, puoi utilizzare la pagina dei dettagli della X-Ray traccia per esaminare informazioni dettagliate sulla latenza sulle richieste fatte alla tua API. Nell'esempio seguente viene illustrata la visualizzazione della traccia insieme alla mappa del servizio per questa specifica richiesta. La richiesta è stata effettuata a un'API chiamata postAPI con un tipo Post, i cui dati sono contenuti in una tabella Amazon DynamoDB denominata. PostTable-Example

L'immagine di traccia seguente corrisponde alla seguente query GraphQL:

query getPost {
    getPost(id: "1") {
      id
      title
    }
}

Il resolver per la getPost query utilizza l'origine dati DynamoDB sottostante. La seguente visualizzazione di traccia mostra la chiamata a DynamoDB e le latenze di varie parti dell'esecuzione della query:

Mappa di tracciamento che mostra il flusso di richieste PostAPI dal client in arrivo con dettagli sulle tempistiche DynamoDB .

  • Nell'immagine precedente, /getPost rappresenta il percorso completo dell'elemento che viene risolto. In questo caso, poiché getPost è un campo sul tipo di Query radice, viene visualizzato direttamente dopo la radice del percorso.

  • requestMappingTemplateEvaluation rappresenta il tempo trascorso da AWS AppSync per la valutazione del modello di mapping della richiesta per questo elemento nella query.

  • Query.getPost rappresenta un tipo e un campo (nel formato Type.field). Può contenere più sottosegmenti, a seconda della struttura dell'API e della richiesta tracciata.

    • DynamoDB rappresenta l'origine dati associata a questo resolver. Contiene la latenza della chiamata di rete a DynamoDB per risolvere il campo.

    • responseMappingTemplateEvaluation rappresenta il tempo trascorso da AWS AppSync per la valutazione del modello di mapping della risposta per questo elemento nella query.

Quando visualizzi le tracce in X-Ray, puoi ottenere ulteriori informazioni contestuali e sui metadati sui sottosegmenti del AWS AppSync segmento scegliendo i sottosegmenti ed esplorando la vista dettagliata.

Per alcune interrogazioni complesse o profondamente annidate, tieni presente che il segmento a cui viene inviato AWS AppSync può essere maggiore della dimensione massima X-Ray consentita per i documenti del segmento, come definito in Documenti di segmento. AWS X-Ray X-Ray non visualizza i segmenti che superano il limite.