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, Go, Node.js e Python.

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 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 de RPC do cliente e a AFE do Spanner começar a escrever 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

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 de operation_latencies é a soma de todos os valores de 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?