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.

Acceder a métricas del lado del cliente

Las métricas del lado del cliente están disponibles en 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.

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

Habilitar la API Monitoring

Las métricas del lado del cliente están disponibles para los usuarios o las cuentas de servicio a los que se les haya concedido el permiso monitoring.timeSeries.createde Gestión de Identidades y Accesos (IAM). Este permiso se incluye en los siguientes roles de IAM de Spanner:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir el monitoring.timeSeries.create permiso de gestión de identidades y accesos necesario a través de roles personalizados.

Ver métricas en el explorador de métricas

  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