Questa pagina offre informazioni di riepilogo sulla raccolta di tracce con OpenTelemetry. Per monitorare ed eseguire il debug delle richieste di Spanner, puoi abilitare le tracce nelle librerie client di Spanner. La tracciabilità lato client ed end-to-end può aiutarti a monitorare le prestazioni ed eseguire il debug dei problemi.
Le tracce forniscono informazioni pertinenti per ogni richiesta di un client, ad esempio:
Intervalli con timestamp di quando il client ha inviato una richiesta RPC e quando il client ha ricevuto la risposta RPC, inclusa la latenza causata dalla rete e dal sistema client.
Attributi (coppie chiave-valore) che forniscono informazioni sul client e sulla sua configurazione.
Annotazioni con eventi importanti negli intervalli.
Per ulteriori informazioni su intervalli e attributi, consulta Intervalli e Attributi nella documentazione di OpenTelemetry.
Tracciabilità end-to-end
Oltre alla tracciabilità lato client, puoi attivare la tracciabilità end-to-end. La tracciabilità end-to-end ti aiuta a comprendere ed eseguire il debug dei problemi di latenza specifici di Spanner, ad esempio:
Identificare se la latenza è dovuta alla latenza di rete tra l'applicazione e Spanner o se si verifica all'interno di Spanner.
Identificare le Google Cloud regioni attraverso le quali vengono instradate le richieste dell'applicazione e se esiste una richiesta tra regioni. Una richiesta tra regioni di solito comporta latenze più elevate tra l'applicazione e Spanner.
Per evitare di sovraccaricare Cloud Trace e gestire i costi in modo efficace, la tracciabilità end-to-end prevede un limite al numero di intervalli di traccia che puoi esportare. A causa di questo limite, non si verifica alcun impatto sull'utilizzo della tracciabilità end-to-end per la risoluzione dei problemi.
OpenTelemetry
Le librerie client di Spanner supportano la raccolta di tracce utilizzando OpenTelemetry API. OpenTelemetry è un framework di osservabilità open source. OpenTelemetry offre un'ampia gamma di configurazioni, come esportatori per backend specifici, rapporti di campionamento e limiti di intervalli.
Esportare le tracce utilizzando OTLP
Nell'ambito della configurazione di OpenTelemetry, utilizzi un esportatore per inviare i dati di traccia a un backend di osservabilità. Ti consigliamo di utilizzare un esportatore OpenTelemetry Protocol
(OTLP)
che invia i dati utilizzando il protocollo OpenTelemetry. Puoi configurare l'esportatore OTLP per inviare le tracce direttamente ai backend di osservabilità che supportano OTLP, come Cloud Trace utilizzando Telemetry
API, o a un agente di raccolta OpenTelemetry.
Limitazioni
Le tracce di Spanner presentano le seguenti limitazioni:
- Gli intervalli di Trace sono disponibili solo per le librerie client Java, Go, Node e Python.
- Le tracce end-to-end possono essere esportate solo in Cloud Trace.
Prezzi
Oltre all'utilizzo di Spanner, la tracciabilità può comportare addebiti tramite il backend di osservabilità.
L'importazione degli intervalli di traccia nel backend di osservabilità è fatturabile. Ad esempio, se utilizzi Cloud Trace come backend, ti verrà addebitato l'importo in base ai prezzi di Cloud Trace.
Per comprendere meglio la fatturazione, inizia con un piccolo rapporto di campionamento delle tracce in base al traffico.
Passaggi successivi
Per configurare la tracciabilità lato client ed end-to-end, consulta Configurare la raccolta di tracce utilizzando OpenTelemetry.