Descrizioni delle metriche lato client

Questa pagina fornisce una descrizione dettagliata di ogni metrica lato client offerta da Spanner. Per saperne di più sulla visualizzazione e sulla gestione delle metriche lato client, consulta Visualizza e gestisci le metriche lato client.

Le metriche lato client offrono informazioni sulla latenza dei tentativi e delle operazioni di richiesta RPC del client a Spanner.

Un tentativo è una singola richiesta RPC dal client a Spanner. Il client può effettuare più tentativi se una richiesta non va a buon fine.

Un'operazione rappresenta il completamento di tutte le richieste RPC, inclusi tutti i tentativi effettuati dal client verso Spanner. Un'operazione viene completata quando il client riceve una risposta o esaurisce tutti i tentativi.

Una richiesta RPC raggiunge prima il Google Front End (GFE) e poi il frontend dell'API Spanner (AFE). Per saperne di più, consulta Punti di latenza in una richiesta Spanner.

Il client calcola le metriche delle latenze GFE e AFE dalle informazioni di tempistica che GFE e AFE aggiungono alle intestazioni della risposta. Se un tentativo termina prima che il client riceva le intestazioni della risposta, il client non registra un campione di latenza GFE o AFE per quel tentativo. Ad esempio, questo accade quando la scadenza della richiesta scade e il client restituisce un errore DEADLINE_EXCEEDED. Il client incrementa invece la metrica del conteggio degli errori di connettività corrispondente. Di conseguenza, le distribuzioni della latenza di GFE e AFE includono solo i tentativi che hanno ricevuto intestazioni della risposta e potrebbero sembrare normali anche quando molti tentativi scadono.

Il client registra le metriche GFE solo per le richieste che passano attraverso il GFE. Se una richiesta utilizza DirectPath (directpath_used è true), il client non registra la latenza GFE o il conteggio degli errori di connettività GFE per la richiesta.

Queste metriche includono i tipi di valore delle metriche DISTRIBUTION e INT64. Per saperne di più, consulta Tipi di valori e tipi di metriche.

Puoi accedere alle metriche lato client utilizzando le librerie client di Spanner per Java, Go, Node.js e Python.

Le metriche lato client supportano tutti i metodi Spanner nell'API RPC google.spanner.v1.Spanner.

Tutte le metriche lato client hanno le seguenti dimensioni:

  • project ID: l'ID progetto Google Cloud .
  • instance ID: l'ID istanza Spanner.
  • database ID: l'ID database Spanner.
  • location: la regione Google Cloud in cui vengono pubblicate le metriche lato client. Se il deployment dell'applicazione viene eseguito al di fuori di Google Cloud, le metriche vengono pubblicate nella regione global.
  • method: il nome del metodo RPC, ad esempio spanner.commit.
  • status: lo stato RPC, ad esempio OK o INTERNAL.
  • client_name: il nome e la versione della libreria, ad esempio spanner-java/6.70.1.
  • directpath_enabled: indica se la libreria client è configurata per accedere direttamente a Spanner senza passare attraverso il frontend.
  • directpath_used: indica se la richiesta corrente è stata inviata direttamente a Spanner senza passare attraverso il frontend. Un valore false mentre directpath_enabled è true indica che la richiesta è tornata al percorso standard che passa attraverso il GFE.

Conteggio degli errori di connettività AFE

La metrica del conteggio degli errori di connettività AFE registra il numero di tentativi per i quali il client non ha ricevuto informazioni sulla tempistica dell'AFE di Spanner nelle intestazioni della risposta. Questo accade, ad esempio, quando la richiesta non raggiunge l'AFE o quando il tentativo scade prima che il client riceva le intestazioni della risposta. La metrica Latenze AFE non registra un campione per questi tentativi.

La metrica del conteggio degli errori di connettività AFE ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/afe_connectivity_error_count
  • Metric value type: INT64

Latenze AFE

La metrica delle latenze AFE misura il tempo che intercorre tra la ricezione della richiesta RPC da parte dell'AFE di Spanner dal client e l'inizio della scrittura della risposta da parte dell'AFE di Spanner.

Il client calcola questo valore dalle informazioni di temporizzazione nelle intestazioni della risposta. Se un tentativo termina prima che il client riceva le intestazioni della risposta, il client non registra un campione e incrementa la metrica Conteggio errori di connettività AFE.

La metrica delle latenze AFE ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/afe_latencies
  • Metric value type: DISTRIBUTION

Conteggio tentativi

La metrica Numero di tentativi registra il numero di tentativi eseguiti. Il valore attempt_count è in genere identico al valore operation_count. Se il client riceve errori temporanei, il valore attempt_count è la somma di tutti i tentativi.

La metrica Numero di tentativi ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/attempt_count
  • Metric value type: INT64

Latenze dei tentativi

La metrica delle latenze dei tentativi misura la durata di un singolo tentativo RPC, dal momento in cui il client invia la richiesta fino al momento in cui il tentativo ha esito positivo o negativo. Il valore attempt_latencies è in genere identico al valore operation_latencies. Se il client riceve errori temporanei, il valore operation_latencies è la somma di tutti i valori attempt_latencies.

La metrica Latenze dei tentativi ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/attempt_latencies
  • Metric value type: DISTRIBUTION

Conteggio degli errori di connettività GFE

La metrica del conteggio degli errori di connettività GFE registra il numero di tentativi per i quali il client non ha ricevuto informazioni sulle tempistiche GFE nelle intestazioni della risposta. Ciò accade, ad esempio, quando la richiesta non raggiunge il GFE o quando il tentativo scade prima che il client riceva le intestazioni della risposta. La metrica Latenze GFE non registra un campione per questi tentativi.

La metrica del conteggio degli errori di connettività GFE ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/gfe_connectivity_error_count
  • Metric value type: INT64

Latenze GFE

La metrica delle latenze GFE misura il tempo che intercorre tra la ricezione della richiesta RPC dal client da parte del GFE e la ricezione del primo byte della risposta da parte del GFE. Questa metrica non include il tempo impiegato per l'handshake TCP o TLS.

Il client calcola questo valore dalle informazioni di temporizzazione nelle intestazioni della risposta. Se un tentativo termina prima che il client riceva le intestazioni della risposta, il client non registra un campione e incrementa invece la metrica Conteggio errori di connettività GFE. Se il numero di errori di connettività GFE aumenta, le latenze GFE che sembrano normali non significano che la latenza sia bassa.

La metrica delle latenze GFE ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/gfe_latencies
  • Metric value type: DISTRIBUTION

Conteggio operazioni

La metrica del conteggio delle operazioni registra il numero di operazioni eseguite ogni 60 secondi.

La metrica Conteggio operazioni ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/operation_count
  • Metric value type: INT64

Latenze delle operazioni

La metrica delle latenze delle operazioni misura l'andata e ritorno di un'operazione dal livello gRPC del client a Spanner e di nuovo al client.

La metrica Latenze delle operazioni ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/operation_latencies
  • Metric value type: DISTRIBUTION

Passaggi successivi