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 ver e gerenciar métricas do lado do cliente, consulte Ver 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 tentativas feitas pelo cliente no Spanner. Uma operação é concluída quando o cliente recebe uma resposta ou esgota todas as tentativas.

Uma solicitação 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 os tipos de valor de métrica DISTRIBUTION e INT64. Para mais informações, consulte Tipos de valor e tipos de métrica.

É possível acessar métricas do lado do cliente usando as bibliotecas de cliente do Spanner para Java ou Go.

As métricas do lado do cliente são compatíveis com todos os métodos do Spanner na API RPC google.spanner.v1.Spanner.

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

  • project ID: o ID do projeto do Google Cloud .
  • instance ID: o ID da instância do Spanner.
  • database ID: o ID do banco de dados do Spanner.
  • location: a região Google Cloud em que as métricas do lado do cliente são publicadas. Se o aplicativo for implantado fora de 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 de AFE

A métrica de latências do AFE mede o tempo entre o recebimento da solicitação de RPC do cliente pelo AFE do Spanner e o início da gravação da resposta pelo AFE do Spanner.

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 de attempt_count normalmente é idêntico ao valor de operation_count. Se o cliente receber erros transitórios, o valor de attempt_count será a soma de todas as tentativas.

A métrica "Número 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. Normalmente, o valor de attempt_latencies é idêntico ao valor de operation_latencies. Se o cliente receber erros transitórios, o valor de operation_latencies será a soma de todos os valores de attempt_latencies.

A métrica "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 momento em que o GFE recebe a solicitação de RPC do cliente e quando o GFE recebe o primeiro byte da resposta. Essa métrica não considera o tempo gasto em handshakes de 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 "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