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 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 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 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 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 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 recebimento da solicitação de RPC do cliente e o recebimento do 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