Cómo ver y administrar 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.

Accede a las métricas del cliente

Las métricas del cliente están disponibles en las siguientes bibliotecas cliente:

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

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

Habilita la API de Monitoring

Las métricas del cliente están disponibles para los usuarios o las cuentas de servicio a los que se les otorga el permiso monitoring.timeSeries.create de Identity and Access Management (IAM). Este permiso se incluye en los siguientes roles de IAM de Spanner:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener el permiso de monitoring.timeSeries.create de IAM necesario a través de roles personalizados.

Visualiza métricas en el Explorador de métricas

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

    Ir al Explorador de métricas

  2. Elige tu proyecto.

  3. Haz clic en Elige 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?