Descrições das métricas do lado do cliente

Esta página contém uma descrição detalhada de cada métrica do lado do cliente oferecida pelo Spanner. Para mais informações sobre como visualizar e gerenciar métricas do lado do cliente, consulte Visualizar e gerenciar métricas do lado do cliente.

As métricas do lado do cliente oferecem informações de latência sobre as tentativas e operações de solicitação de RPC do cliente para o Spanner.

Uma tentativa é uma única solicitação de RPC do cliente para o Spanner. O cliente pode fazer várias tentativas se uma solicitação falhar.

Uma operação representa a conclusão de todas as solicitações de RPC, incluindo todas as as tentativas que o cliente fez no Spanner. Uma operação é concluída quando o cliente recebe uma resposta ou esgota todas as tentativas.

Uma solicitação de RPC primeiro chega ao front-end do Google (GFE) e depois ao front-end da API Spanner (AFE). Para mais informações, consulte Pontos de latência em uma solicitação do Spanner.

Essas métricas incluem DISTRIBUTION e INT64 tipos de valor de métrica. Para mais informações, consulte Tipos de valor e tipos de métrica.

É possível acessar as métricas do lado do cliente usando as bibliotecas de cliente do Spanner para Java, Go, Node.js e Python.

As métricas do lado do cliente oferecem suporte a todos os métodos do Spanner em a google.spanner.v1.Spanner API RPC.

Todas as métricas do lado do cliente têm as seguintes dimensões:

  • project ID: o Google Cloud ID do projeto.
  • instance ID: o ID da instância do Spanner.
  • database ID: o ID do banco de dados do Spanner.
  • location: aregião em que as métricas do lado do cliente são publicadas. Google Cloud Se o aplicativo for implantado fora Google Cloud, as métricas serão publicadas na região global.
  • method: o nome do método RPC, por exemplo, spanner.commit.
  • status: o status da RPC, por exemplo, OK ou INTERNAL.
  • client_name: o nome e a versão da biblioteca, por exemplo, spanner-java/6.70.1.

Contagem de erros de conectividade do AFE

A métrica de contagem de erros de conectividade do AFE registra o número de solicitações de RPC que não chegaram ao AFE do Spanner.

A métrica de contagem de erros de conectividade do AFE tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/afe_connectivity_error_count
  • Metric value type: INT64

Latências do AFE

A métrica de latências do AFE mede o tempo entre o AFE do Spanner receber a solicitação de RPC do cliente e o AFE do Spanner começar a gravar a resposta.

A métrica de latências do AFE tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/afe_latencies
  • Metric value type: DISTRIBUTION

Contagem de tentativas

A métrica de contagem de tentativas registra o número de tentativas realizadas. O valor attempt_count geralmente é idêntico ao valor operation_count. Se o cliente receber erros transitórios, o valor attempt_count será a soma de todas as tentativas.

A métrica de contagem de tentativas tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/attempt_count
  • Metric value type: INT64

Latências de tentativa

A métrica de latências de tentativa mede a duração necessária para que uma única solicitação de RPC chegue ao Spanner do cliente. O valor attempt_latencies geralmente é idêntico ao operation_latencies valor. Se o cliente receber erros transitórios, o operation_latencies valor será a soma de todos os attempt_latencies valores.

A métrica de latências de tentativa tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/attempt_latencies
  • Metric value type: DISTRIBUTION

Contagem de erros de conectividade do GFE

A métrica de contagem de erros de conectividade do GFE registra o número de solicitações de RPC que não chegaram ao GFE.

A métrica de contagem de erros de conectividade do GFE tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/gfe_connectivity_error_count
  • Metric value type: INT64

Latências do GFE

A métrica de latências do GFE mede o tempo entre o GFE receber a solicitação de RPC do cliente e o GFE receber o primeiro byte da resposta. Essa métrica não considera o tempo gasto para qualquer handshake TCP/SSL.

A métrica de latências do GFE tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/gfe_latencies
  • Metric value type: DISTRIBUTION

Contagem de operações

A métrica de contagem de operações registra o número de operações realizadas a cada 60 segundos.

A métrica de contagem de operações tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/operation_count
  • Metric value type: INT64

Latências de operação

A métrica de latências de operação mede o tempo de ida e volta de uma operação da camada gRPC do cliente para o Spanner e de volta ao cliente.

A métrica de latências de operação tem os seguintes atributos:

  • Metric name : spanner.googleapis.com/client/operation_latencies
  • Metric value type: DISTRIBUTION

A seguir