Descripciones de las métricas del cliente

En esta página, se proporciona una descripción detallada de cada métrica del cliente que ofrece Spanner. Para obtener más información sobre cómo ver y administrar las métricas del cliente, consulta Visualiza y administra las métricas del cliente.

Las métricas del cliente ofrecen información de latencia sobre los intentos y las operaciones de solicitud de RPC del cliente a Spanner.

Un intento es una sola solicitud de RPC del cliente a Spanner. El cliente puede realizar varios intentos si falla una solicitud.

Una operación representa la finalización de todas las solicitudes de RPC, incluidos todos los intentos que el cliente realizó en Spanner. Una operación se completa cuando el cliente recibe una respuesta o agota todos los intentos.

Una solicitud de RPC llega primero a Google Front End (GFE) y, luego, al frontend de la API de Spanner (AFE). Para obtener más información, consulta Puntos de latencia en una solicitud de Spanner.

El cliente calcula las métricas de latencias de GFE y de AFE a partir de la información de tiempo que GFE y AFE agregan a los encabezados de respuesta. Si un intento finaliza antes de que el cliente reciba los encabezados de respuesta, el cliente no registra una muestra de latencia de GFE o AFE para ese intento. Por ejemplo, esto sucede cuando vence el plazo de la solicitud y el cliente devuelve un error DEADLINE_EXCEEDED. En su lugar, el cliente incrementa la métrica de recuento de errores de conectividad correspondiente. Como resultado, las distribuciones de latencia de GFE y AFE solo incluyen los intentos que recibieron encabezados de respuesta y pueden parecer normales incluso cuando se agota el tiempo de espera de muchos intentos.

El cliente registra las métricas de GFE solo para las solicitudes que pasan por GFE. Si una solicitud usa DirectPath (directpath_used es true), el cliente no registra la latencia de GFE ni el recuento de errores de conectividad de GFE para esa solicitud.

Estas métricas incluyen los tipos de valores de métricas DISTRIBUTION y INT64. Para obtener más información, consulta Tipos de valores y clases de métricas.

Puedes acceder a las métricas del cliente con las bibliotecas cliente de Spanner para Java, Go, Node.js y Python.

Las métricas del cliente admiten todos los métodos de Spanner en la API de RPC de google.spanner.v1.Spanner.

Todas las métricas del cliente tienen las siguientes dimensiones:

  • project ID: Es el ID del proyecto de Google Cloud .
  • instance ID: Es el ID de la instancia de Spanner.
  • database ID: Es el ID de la base de datos de Spanner.
  • location: Es la región de Google Cloud en la que se publican las métricas del cliente. Si tu aplicación se implementa fuera de Google Cloud, las métricas se publican en la región global.
  • method: Es el nombre del método de RPC, por ejemplo, spanner.commit.
  • status: el estado de la RPC, por ejemplo, OK o INTERNAL.
  • client_name: el nombre y la versión de la biblioteca, por ejemplo, spanner-java/6.70.1.
  • directpath_enabled: Indica si la biblioteca cliente está configurada para acceder directamente a Spanner sin pasar por el frontend.
  • directpath_used: indica si la solicitud actual se envió directamente a Spanner sin pasar por el frontend. Un valor false mientras directpath_enabled es true indica que la solicitud recurrió a la ruta estándar que pasa por el GFE.

Recuento de errores de conectividad de AFE

La métrica de recuento de errores de conectividad de AFE registra la cantidad de intentos para los que el cliente no recibió información de tiempo de AFE de Spanner en los encabezados de respuesta. Esto sucede, por ejemplo, cuando la solicitud no llega al AFE o cuando se agota el tiempo de espera del intento antes de que el cliente reciba los encabezados de respuesta. La métrica Latencias de AFE no registra una muestra para estos intentos.

La métrica de recuento de errores de conectividad de AFE tiene los siguientes atributos:

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

Latencias de AFE

La métrica de latencias de AFE mide el tiempo entre que el AFE de Spanner recibe la solicitud de RPC del cliente y el AFE de Spanner comienza a escribir la respuesta.

El cliente calcula este valor a partir de la información de tiempo en los encabezados de respuesta. Si un intento finaliza antes de que el cliente reciba los encabezados de respuesta, el cliente no registra una muestra y, en su lugar, incrementa la métrica Recuento de errores de conectividad de AFE.

La métrica de latencias de AFE tiene los siguientes atributos:

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

Recuento de intentos

La métrica de recuento de intentos registra la cantidad de intentos realizados. Por lo general, el valor attempt_count es idéntico al valor operation_count. Si el cliente recibe errores transitorios, el valor de attempt_count es la suma de todos los intentos.

La métrica Recuento de intentos tiene los siguientes atributos:

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

Latencias de los intentos

La métrica de latencias de intentos mide la duración de un solo intento de RPC, desde que el cliente envía la solicitud hasta que el intento se completa correctamente o falla. Por lo general, el valor attempt_latencies es idéntico al valor operation_latencies. Si el cliente recibe errores transitorios, el valor de operation_latencies es una suma de todos los valores de attempt_latencies.

La métrica Latencias de intentos tiene los siguientes atributos:

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

Recuento de errores de conectividad de GFE

La métrica de recuento de errores de conectividad de GFE registra la cantidad de intentos para los que el cliente no recibió información de tiempo de GFE en los encabezados de respuesta. Esto sucede, por ejemplo, cuando la solicitud no llega al GFE o cuando se agota el tiempo de espera del intento antes de que el cliente reciba los encabezados de respuesta. La métrica Latencias de GFE no registra una muestra para estos intentos.

La métrica de recuento de errores de conectividad de GFE tiene los siguientes atributos:

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

Latencias de GFE

La métrica de latencias de GFE mide el tiempo entre el momento en que GFE recibe la solicitud de RPC del cliente y el momento en que GFE recibe el primer byte de la respuesta. Esta métrica no incluye el tiempo que se tarda en realizar cualquier protocolo de enlace TCP o TLS.

El cliente calcula este valor a partir de la información de tiempo en los encabezados de respuesta. Si un intento finaliza antes de que el cliente reciba los encabezados de respuesta, el cliente no registra una muestra y, en su lugar, incrementa la métrica Recuento de errores de conectividad de GFE. Si aumenta el recuento de errores de conectividad de GFE, las latencias de GFE que parecen normales no significan que la latencia sea baja.

La métrica de latencias de GFE tiene los siguientes atributos:

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

Recuento de operaciones

La métrica de recuento de operaciones registra la cantidad de operaciones que se realizan cada 60 segundos.

La métrica Recuento de operaciones tiene los siguientes atributos:

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

Latencias de las operaciones

La métrica de latencias de operaciones mide el recorrido de ida y vuelta de una operación desde la capa gRPC del cliente hasta Spanner y de vuelta al cliente.

La métrica Latencias de la operación tiene los siguientes atributos:

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

¿Qué sigue?