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

Esta página fornece 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 as 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.

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

As métricas do lado do cliente estão disponíveis quando você usa a biblioteca 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 disponíveis na API RPC google.spanner.v1.Spanner.

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.

Essa métrica tem os seguintes atributos:

  • Metric name : spanner.googleapis.com/client/operation_latencies
  • Metric value type: DISTRIBUTION
  • Dimensões disponíveis:
    • 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 em que as métricas do lado do cliente são publicadas. Se o aplicativo for implantado fora do 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 operações

A métrica "Contagem de operações" registra o número de operações realizadas.

Essa métrica tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/operation_count
  • Metric value type: INT64
  • Dimensões disponíveis:
    • 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 em que as métricas do lado do cliente são publicadas. Se o aplicativo for implantado fora do 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.

Latências de tentativa

A métrica de latência da tentativa mede o tempo que uma única solicitação de RPC leva para chegar ao Spanner do cliente. O valor attempt_latencies normalmente é idêntico ao valor operation_latencies. Se o cliente receber erros transitórios, o valor de operation_latencies será a soma de todos os valores de attempt_latencies.

Essa métrica tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/attempt_latencies
  • Metric value type: DISTRIBUTION
  • Dimensões disponíveis:
    • 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 em que as métricas do lado do cliente são publicadas. Se o aplicativo for implantado fora do 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 tentativas

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

Essa métrica tem os seguintes atributos:

  • Metric name: spanner.googleapis.com/client/attempt_count
  • Metric value type: INT64
  • Dimensões disponíveis:
    • 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 em que as métricas do lado do cliente são publicadas. Se o aplicativo for implantado fora do 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.

A seguir