Conferir e gerenciar métricas do lado do cliente

Esta página oferece 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 fornece métricas do lado do cliente que podem ser usadas com métricas do lado do servidor para otimizar o desempenho e resolver problemas de desempenho, se ocorrerem.

As métricas do lado do cliente são medidas desde o momento em que uma solicitação sai do aplicativo até o momento em que ele recebe a resposta. Por outro lado, as métricas 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.

Acessar métricas do lado do cliente

As métricas do lado do cliente estão disponíveis nas seguintes bibliotecas de cliente:

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

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

Ativar a API Monitoring

As métricas do lado do cliente estão disponíveis para usuários ou contas de serviço que receberam a permissão monitoring.timeSeries.create do Identity and Access Management (IAM). Essa permissão está incluída nos seguintes papéis do IAM do Spanner:

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

Também é possível receber a permissão monitoring.timeSeries.create IAM necessária com papéis personalizados.

Conferir métricas no Metrics Explorer

  1. No console Google Cloud , acesse a página Metrics Explorer.

    Acessar o Metrics Explorer

  2. Selecione o projeto.

  3. Clique em Selecionar uma métrica.

  4. Pesquise spanner.googleapis.com/client.

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

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

O aplicativo precisa ser executado por pelo menos um minuto antes de você poder conferir 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,
    })

Custos

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