Veja e faça a gestão de métricas do lado do cliente

Esta página oferece informações sobre a visualização e a gestão de métricas do lado do cliente. As métricas do lado do cliente oferecem informações de latência sobre os pedidos RPC do cliente ao Spanner.

O Spanner fornece métricas do lado do cliente que pode usar juntamente com as 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 um pedido sai da sua aplicação até ao momento em que a aplicação recebe a resposta. Por outro lado, as métricas do lado do servidor são medidas desde o momento em que o Spanner recebe um pedido até ao envio do último byte de dados para o cliente.

Aceda às métricas do lado do cliente

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

  • Java na versão 6.81.0 e posteriores.
  • Go na versão 1.71.0 e posteriores.

As métricas do lado do cliente estão disponíveis depois de ativar a API Cloud Monitoring.

Ative a API Monitoring

As métricas do lado do cliente estão disponíveis para utilizadores ou contas de serviço aos quais é concedida a autorização de gestão de identidade e de acesso (IAM) monitoring.timeSeries.create. Esta autorização está incluída nas seguintes funções do IAM do Spanner:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir a monitoring.timeSeries.create autorização IAM necessária através de funções personalizadas.

Veja métricas no explorador de métricas

  1. Na Google Cloud consola, aceda à página Explorador de métricas.

    Aceda ao Metrics Explorer

  2. Selecione o seu projeto.

  3. Clique em Selecionar uma métrica.

  4. Pesquise spanner.googleapis.com/client.

  5. Selecione a métrica e, de seguida, clique em Aplicar.

Para mais informações sobre como agrupar ou agregar a sua métrica, consulte o artigo Crie consultas com menus.

A sua aplicação tem de ser executada durante, pelo menos, um minuto antes de poder ver quaisquer métricas publicadas.

Desative as métricas do lado do cliente

Se já estiver a usar o OpenTelemetry para captar métricas personalizadas do cliente, pode optar por não usar métricas do lado do cliente através do 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 é cobrado nenhum valor para ver as métricas do lado do cliente no Cloud Monitoring. A utilização da API Monitoring pode incorrer em custos. Para mais informações, consulte os preços da observabilidade do Google Cloud.

O que se segue?