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

Esta página oferece uma descrição detalhada de cada métrica do lado do cliente que o Spanner oferece. Para mais informações sobre como ver e gerir métricas do lado do cliente, consulte o artigo Veja e faça a gestão de métricas do lado do cliente.

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

Uma tentativa é um único pedido RPC do cliente para o Spanner. O cliente pode fazer várias tentativas se um pedido falhar.

Uma operação representa a conclusão de todos os pedidos RPC, incluindo todas as tentativas que o cliente fez ao Spanner. Uma operação é concluída quando o cliente recebe uma resposta ou esgota todas as tentativas.

Um pedido RPC chega primeiro ao front-end da Google (GFE) e, em seguida, ao front-end da API Spanner (AFE). Para mais informações, consulte o artigo Pontos de latência num pedido do Spanner.

Estas métricas incluem os tipos de valores de métricas DISTRIBUTION e INT64. Para mais informações, consulte Tipos de valores e tipos de métricas.

Pode aceder às métricas do lado do cliente através das bibliotecas cliente do Spanner para Java ou Go.

As métricas do lado do cliente suportam 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 Google Cloud ID do projeto.
  • instance ID: o ID da instância do Spanner.
  • database ID: o ID da base de dados do Spanner.
  • location: a Google Cloud região onde as métricas do lado do cliente são publicadas. Se a sua aplicação for implementada fora de Google Cloud, as métricas são publicadas na região global.
  • method: o nome do método RPC, por exemplo, spanner.commit.
  • status: o estado de 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 conetividade AFE

A métrica de contagem de erros de conetividade da AFE regista o número de pedidos RPC que não conseguiram alcançar a AFE do Spanner.

A métrica de contagem de erros de conetividade da AFE tem os seguintes atributos:

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

Latências da AFE

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

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

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

Número de tentativas

A métrica de contagem de tentativas regista o número de tentativas realizadas. Normalmente, o valor de attempt_count é idêntico ao valor de operation_count. Se o cliente receber erros temporários, o valor de attempt_count é 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 tentativas

A métrica de latências de tentativas mede a duração necessária para que um único pedido de RPC chegue ao Spanner a partir do cliente. Normalmente, o valor attempt_latencies é idêntico ao valor operation_latencies. Se o cliente receber erros temporários, o valor operation_latencies é a soma de todos os valores attempt_latencies.

A métrica Latências de tentativas tem os seguintes atributos:

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

Contagem de erros de conetividade do GFE

A métrica de contagem de erros de conetividade do GFE regista o número de pedidos RPC que não conseguiram alcançar o GFE.

A métrica de contagem de erros de conetividade 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 o pedido de RPC do cliente e quando o GFE recebe o primeiro byte da resposta. Esta métrica não tem em conta o tempo necessário 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

Número de operações

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

A métrica Operation count 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ções mede a viagem de ida e volta de uma operação desde a camada gRPC do cliente até ao Spanner e de volta ao cliente.

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

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

O que se segue?