Ver y gestionar métricas del lado del cliente

En esta página se ofrece información sobre cómo ver y gestionar las métricas del lado del cliente. Las métricas del lado del cliente ofrecen información sobre la latencia de las solicitudes RPC del cliente a Spanner.

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

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

Antes de empezar

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

    Habilitar la API Monitoring

  2. Para obtener el permiso que necesitas para acceder a las métricas del lado del cliente, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Escritor de métricas de Monitoring (roles/monitoring.metricWriter) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

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

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

Acceder a métricas del lado del cliente

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

  • Java en la versión 6.81.0 y posteriores.
  • Ir en la versión 1.71.0 y posteriores.

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

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

    Ir a Explorador de métricas

  2. Selecciona el proyecto.

  3. Haz clic en Seleccionar una métrica.

  4. Buscar spanner.googleapis.com/client.

  5. Seleccione la métrica y, a continuación, haga clic en Aplicar.

Para obtener más información sobre cómo agrupar o agregar métricas, consulta el artículo Crear consultas con menús.

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

Inhabilitar las métricas del lado del cliente

Si ya usa OpenTelemetry para registrar métricas de cliente personalizadas, puede inhabilitar las métricas del lado 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 lado del cliente en Cloud Monitoring. El uso de la API Monitoring puede conllevar cargos. Para obtener más información, consulta los precios de Google Cloud Observability.

Siguientes pasos