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 ocurren.

Las métricas del cliente se miden desde el momento en que una solicitud sale de tu aplicación hasta el momento en que la 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.

Cómo acceder 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 estarán disponibles después de que habilites 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 otorgó 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 IAM monitoring.timeSeries.create requerido a través de roles personalizados.

Visualiza métricas en el Explorador de métricas

  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 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 Cómo compilar consultas con menús.

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

Inhabilita 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,
    })

Costos

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 Precios de Google Cloud Observability.

¿Qué sigue?