Descrizioni delle metriche lato client

Questa pagina fornisce una descrizione dettagliata di ogni metrica lato client offerta da Spanner. Per ulteriori informazioni su come visualizzare e gestire le metriche lato client, consulta Visualizzare e gestire le metriche lato client.

Le metriche lato client forniscono informazioni sulla latenza dei tentativi e delle operazioni di richiesta RPC del client su 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 su Spanner. Un'operazione viene completata quando il client riceve una risposta o esaurisce tutti i tentativi.

Queste metriche includono i tipi di valore delle metriche DISTRIBUTION e INT64. Per maggiori informazioni, consulta Tipi di valore e tipi di metriche.

Le metriche lato client sono disponibili quando utilizzi la libreria client Spanner per Java o Go.

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

Latenze delle operazioni

La metrica delle latenze delle operazioni misura il round trip di un'operazione dal livello gRPC del client a Spanner e di nuovo al client.

Questa metrica ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/operation_latencies
  • Metric value type: DISTRIBUTION
  • Dimensioni disponibili:
    • 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 l'applicazione viene eseguita 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.

Conteggio operazioni

La metrica Conteggio operazioni registra il numero di operazioni eseguite.

Questa metrica ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/operation_count
  • Metric value type: INT64
  • Dimensioni disponibili:
    • 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 l'applicazione viene eseguita 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 raccolta. Ad esempio, spanner-java/6.70.1.

Latenze dei tentativi

La metrica Latenze dei tentativi misura il tempo necessario a una singola richiesta RPC per raggiungere Spanner dal client. In genere, il valore attempt_latencies è identico al valore operation_latencies. Se il client riceve errori temporanei, il valore operation_latencies è la somma di tutti i valori attempt_latencies.

Questa metrica ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/attempt_latencies
  • Metric value type: DISTRIBUTION
  • Dimensioni disponibili:
    • 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 l'applicazione viene eseguita 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 raccolta. Ad esempio, spanner-java/6.70.1.

Conteggio tentativi

La metrica Conteggio 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.

Questa metrica ha i seguenti attributi:

  • Metric name: spanner.googleapis.com/client/attempt_count
  • Metric value type: INT64
  • Dimensioni disponibili:
    • 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 l'applicazione viene eseguita 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 raccolta. Ad esempio, spanner-java/6.70.1.

Passaggi successivi