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

SDK AWS X-Ray per Go

L'SDK X-Ray per Go è un insieme di librerie per applicazioni Go che offre classi e metodi per generare e inviare dati di tracciamento al daemon X-Ray. I dati di tracciamento includono informazioni sulle richieste HTTP in ingresso elaborate dall'applicazione e sulle chiamate che l'applicazione invoca verso i servizi a valle utilizzando l'AWSSDK, client HTTP o connettore di database SQL. Puoi anche possibile creare manualmente dei segmenti e aggiungere informazioni di debug in annotazioni e metadati.

Scarica l'SDK dal repository GitHub con go get:

$ go get -u github.com/aws/aws-xray-sdk-go/... 

In caso di applicazioni web, per tracciare le richieste in entrata inizia utilizzando la funzione xray.Handler. Il gestore dei messaggi crea un segmento per ogni richiesta tracciata e completa il segmento quando viene inviata la risposta. Fino a che il segmento è aperto puoi usare i metodi del client dell'SDK per aggiungere informazioni al segmento e creare sottosegmenti per tracciare le chiamate a valle. L'SDK, inoltre, registra automaticamente le eccezioni sollevate dall'applicazione per il tempo durante il quale il segmento è aperto.

Per le funzioni Lambda chiamate da un'applicazione o un servizio strumentati, Lambda legge ilintestazione di tracciamentoe traccia automaticamente le richieste campionate. Per altre funzioni, è possibileconfigura Lambdaper campionare e tracciare le richieste in ingresso. In entrambi i casi, Lambda crea il segmento e lo fornisce all'SDK X-Ray.

Quindi, includi il tuo client all'interno di una chiamata alla funzione AWS. Questa fase assicura che X-Ray analizzi le chiamate verso qualsiasi metodo client. Puoi anche analizzare le chiamate verso database SQL.

Dopo aver iniziato a utilizzare l'SDK, personalizza il suo comportamento conconfigurazione del registratore e del middleware. Puoi aggiungere dei plugin per memorizzare i dati sulle risorse di elaborazione sulle quali è eseguita la tua applicazione, personalizzare il comportamento di campionamento definendo regole di campionatura e impostare il livello di log per visualizzare più o meno informazioni generate dall'SDK nei log dell'applicazione.

Registra ulteriori informazioni sulle richieste e sull'attività svolta dalla tua applicazione in annotazioni e metadati. Le annotazioni sono semplici coppie chiave-valore indicizzati per l'uso con espressioni filtro, in modo da poter cercare tracce che contengono dati specifici. Gli elementi metadati sono meno restrittivi e possono memorizzare oggetti completi e vettori, tutto ciò che può essere serializzato in formato JSON.

Quando disponi di una notevole quantità di client analizzati nel tuo codice, un singolo segmento per la richiesta può contenere un numero elevato di sottosegmenti, uno per ciascuna delle chiamate effettuate con un client analizzato. Puoi organizzare e raggruppare i sottosegmenti inglobando le chiamate del client sottosegmenti personalizzati. Puoi creare un sottosegmento personalizzato per un'intera funzione o qualsiasi porzione di codice, e memorizzare metadati e annotazioni sul sottosegmento invece di scrivere tutto all'interno del segmento padre.

Requisiti

L'SDK X-Ray per Go richiede Go 1.9 o versione più recente.

L'SDK dipende dalle seguenti librerie per la compilazione e il runtime:

Queste dipendenze sono dichiarate nel file README.md dell'SDK.

Documentazione di riferimento

Una volta scaricato l'SDK, crea e conserva la documentazione in locale per visualizzarla in un browser Web.