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.

Antes de começar

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

    Ative a API Monitoring

  2. Para garantir que a sua conta de serviço tem a autorização necessária para aceder às métricas do lado do cliente, peça ao seu administrador para conceder à sua conta de serviço a função Escritor de métricas de monitorização (roles/monitoring.metricWriter) do IAM no projeto.

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

    Esta função predefinida contém a autorização monitoring.timeSeries.create , que é necessária para aceder a métricas do lado do cliente.

    O seu administrador também pode conceder à sua conta de serviço esta autorização com funções personalizadas ou outras funções predefinidas.

Aceda às métricas do lado do cliente

Pode aceder às métricas do lado do cliente através das seguintes bibliotecas de cliente:

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

Para ver as métricas do lado do cliente no explorador de métricas, faça o seguinte:

  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 de cliente personalizadas, pode optar por não usar métricas do lado do cliente usando o seguinte código:

Java 

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

Ir 

    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?