Visualizzare e gestire le metriche lato client

Questa pagina fornisce informazioni su come visualizzare e gestire le 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 eventuali problemi di prestazioni.

Le metriche lato client vengono misurate dal momento in cui una richiesta esce dalla tua applicazione fino al momento in cui l'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.

Accedere alle metriche lato client

Le metriche lato client sono disponibili nelle seguenti librerie client:

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

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

Abilita l'API Monitoring

Le metriche lato client sono disponibili per gli utenti o gli account di servizio a cui è stato concesso il ruolo Scrittore di metriche di monitoraggio (roles/monitoring.metricWriter) di Identity and Access Management(IAM).

Questo ruolo predefinito contiene l'autorizzazione monitoring.timeSeries.create, necessaria per visualizzare le metriche lato client.

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere l'monitoring.timeSeries.create autorizzazione IAM richiesta tramite ruoli personalizzati.

Visualizzare le metriche in Metrics Explorer

  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 e poi fai clic su Applica.

Per saperne di più su come raggruppare o aggregare la metrica, consulta Creare query utilizzando i menu.

L'applicazione deve essere in esecuzione per almeno un minuto prima che tu possa visualizzare le metriche pubblicate.

Disattivare le metriche lato client

Se utilizzi già OpenTelemetry per acquisire metriche client personalizzate, puoi scegliere di 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,
    })

Costi

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

Passaggi successivi