Visualizzare e gestire le metriche lato client

Questa pagina fornisce informazioni sulla visualizzazione e sulla gestione delle metriche lato client. Le metriche lato client forniscono informazioni sulla latenza delle richieste RPC del client a Spanner.

Spanner fornisce metriche lato client che puoi utilizzare insieme alle metriche lato server per ottimizzare le prestazioni e risolvere i problemi di prestazioni, se si verificano.

Le metriche lato client vengono misurate dal momento in cui una richiesta esce dalla tua applicazione al momento in cui la tua applicazione riceve la risposta. Al contrario, le metriche lato server vengono misurate dal momento in cui Spanner riceve una richiesta fino all'invio dell'ultimo byte di dati al client.

Prima di iniziare

  1. Le metriche lato client sono disponibili dopo aver abilitato l'API Cloud Monitoring.

    Abilita l'API Monitoring

  2. Per assicurarti che il tuo account di servizio disponga dell'autorizzazione necessaria per accedere alle metriche lato client, chiedi all'amministratore di concedere al tuo account di servizio il ruolo IAM Monitoring Metric Writer (roles/monitoring.metricWriter) sul progetto.

    Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

    Questo ruolo predefinito contiene l'autorizzazione monitoring.timeSeries.create necessaria per accedere alle metriche lato client.

    L'amministratore potrebbe anche essere in grado di concedere al tuo account di servizio questa autorizzazione tramite ruoli personalizzati o altri ruoli predefiniti.

Accedere alle metriche lato client

Puoi accedere alle metriche lato client utilizzando le seguenti librerie client:

  • Java nella versione 6.81.0 e successive.
  • Go nella versione 1.71.0 e successive.

Per visualizzare le metriche lato client in Metrics Explorer, procedi come segue:

  1. Nella console Google Cloud , vai alla pagina Metrics Explorer.

    Vai a Esplora metriche

  2. Seleziona il progetto.

  3. Fai clic su Seleziona una metrica.

  4. Cerca spanner.googleapis.com/client.

  5. Seleziona la metrica, quindi fai clic su Applica.

Per saperne di più sul raggruppamento o sull'aggregazione della metrica, consulta Creare query utilizzando i menu.

La tua applicazione deve essere eseguita per almeno un minuto prima che tu possa visualizzare le metriche pubblicate.

Disattivare le metriche lato client

Se utilizzi già OpenTelemetry per acquisire metriche lato client personalizzate, puoi disattivare l'utilizzo delle metriche lato client utilizzando il seguente codice:

Java 

Spanner spanner =
  SpannerOptions.newBuilder()
    .setProjectId("test-project")
    .setBuiltInMetricsEnabled(false)
    .build()
    .getService();

Vai 

    client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
    DisableNativeMetrics: true,
    })

Prezzi

La visualizzazione delle metriche lato client in Cloud Monitoring non comporta alcun costo. L'utilizzo dell'API Monitoring potrebbe comportare costi. Per maggiori informazioni, consulta la pagina Prezzi di Google Cloud Observability.

Passaggi successivi