Cómo ver y administrar las métricas del cliente

En esta página, se ofrece información para ver y administrar las métricas del cliente. Las métricas del cliente ofrecen información de latencia sobre las solicitudes de RPC del cliente a Spanner.

Spanner proporciona métricas del cliente que puedes usar junto con las métricas del servidor para optimizar el rendimiento y solucionar problemas de rendimiento si se producen.

Las métricas del cliente se miden desde el momento en que una solicitud sale de tu aplicación hasta el momento en que tu aplicación recibe la respuesta. En cambio, las métricas del servidor se miden desde el momento en que Spanner recibe una solicitud hasta que se envía el último byte de datos al cliente.

Antes de comenzar

  1. Las métricas del cliente están disponibles después de que habilitas la API de Cloud Monitoring.

    Habilita la API de Monitoring

  2. Para obtener el permiso que necesitas para acceder a las métricas del cliente, pídele a tu administrador que te otorgue el rol de IAM de Escritor de métricas de Monitoring (roles/monitoring.metricWriter) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

    Este rol predefinido contiene el permiso monitoring.timeSeries.create, que se requiere para acceder a las métricas del cliente.

    También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Accede a las métricas del cliente

Puedes acceder a las métricas del cliente con las siguientes bibliotecas cliente:

  • Java, en la versión 6.81.0 y posteriores
  • Go en la versión 1.71.0 y posteriores

Para ver las métricas del cliente en el Explorador de métricas, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Explorador de métricas.

    Ir al Explorador de métricas

  2. Elige tu proyecto.

  3. Haz clic en Selecciona una métrica.

  4. Busca spanner.googleapis.com/client.

  5. Selecciona la métrica y, luego, haz clic en Aplicar.

Para obtener más información sobre cómo agrupar o agregar tu métrica, consulta Compila consultas con menús.

Tu aplicación debe ejecutarse durante al menos un minuto antes de que puedas ver las métricas publicadas.

Cómo inhabilitar las métricas del cliente

Si ya usas OpenTelemetry para capturar métricas personalizadas del cliente, puedes inhabilitar el uso de métricas del cliente con el siguiente código:

Java 

Spanner spanner =
  SpannerOptions.newBuilder()
    .setProjectId("test-project")
    .setBuiltInMetricsEnabled(false)
    .build()
    .getService();

Go

    client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
    DisableNativeMetrics: true,
    })

Precios

No se cobra por ver las métricas del cliente en Cloud Monitoring. El uso de la API de Monitoring puede generar cargos. Para obtener más información, consulta los precios de Google Cloud Observability.

¿Qué sigue?