Ver e gerenciar métricas do lado do cliente

Nesta página, você encontra informações sobre como visualizar e gerenciar métricas do lado do cliente. As métricas do lado do cliente oferecem informações de latência sobre as solicitações RPC do cliente para o Spanner.

O Spanner oferece métricas do lado do cliente que podem ser usadas com métricas do lado do servidor para otimizar o desempenho e resolver problemas, se ocorrerem.

As métricas do lado do cliente são medidas desde o momento em que uma solicitação sai do seu aplicativo até o momento em que ele recebe a resposta. Por outro lado, as métricas do lado do servidor são medidas a partir do momento em que o Spanner recebe uma solicitação até que o último byte de dados seja enviado ao cliente.

Antes de começar

  1. As métricas do lado do cliente ficam disponíveis depois que você ativa a API Cloud Monitoring.

    Ativar a API Monitoring

  2. Para garantir que sua conta de serviço tenha a permissão necessária para acessar métricas do lado do cliente, peça ao administrador para conceder à sua conta de serviço o papel do IAM de Gravador de métricas do Monitoring (roles/monitoring.metricWriter) no projeto.

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Esse papel predefinido contém a permissão monitoring.timeSeries.create, necessária para acessar métricas do lado do cliente.

    O administrador também pode conceder essa permissão à sua conta de serviço com papéis personalizados ou outros papéis predefinidos.

Acessar métricas do lado do cliente

É possível acessar métricas do lado do cliente usando as seguintes bibliotecas de cliente:

  • Java na versão 6.81.0 e mais recentes.
  • Go na versão 1.71.0 e mais recentes.

Para conferir as métricas do lado do cliente no Metrics Explorer, faça o seguinte:

  1. No console Google Cloud , acesse a página do  Metrics explorer:

    Acessar o Metrics Explorer

  2. Selecione o projeto.

  3. Clique em Selecionar uma métrica.

  4. Pesquisar por spanner.googleapis.com/client.

  5. Selecione a métrica e clique em Aplicar.

Para mais informações sobre como agrupar ou agregar sua métrica, consulte Criar consultas usando menus.

O aplicativo precisa ser executado por pelo menos um minuto antes que você possa ver as métricas publicadas.

Desativar as métricas do lado do cliente

Se você já usa o OpenTelemetry para capturar métricas personalizadas do cliente, é possível desativar o uso de métricas do lado do cliente usando o seguinte código:

Java 

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

Go

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

Preços

Não há custo para acessar as métricas do lado do cliente no Cloud Monitoring. O uso da API Monitoring pode gerar cobranças. Para mais informações, consulte Preços do Google Cloud Observability.

A seguir