Usa las métricas del cliente de gRPC

En esta página, se describe cómo emitir métricas del cliente gRPC a Cloud Monitoring cuando usas gRPC para interactuar con Cloud Storage con una de las siguientes interfaces compatibles:

Las métricas del cliente se pueden usar para supervisar el rendimiento de la aplicación cliente que interactúa con Cloud Storage a través de gRPC. La métrica del cliente difiere de las métricas del servidor, que proporcionan estadísticas sobre el rendimiento de Cloud Storage desde la perspectiva del servidor.

Cómo funciona

Puedes habilitar la emisión de métricas del cliente a Cloud Monitoring cuando uses gRPC para interactuar con Cloud Storage con una de las interfaces compatibles. Puedes ver las métricas del cliente con el Explorador de métricas para ayudarte a supervisar y optimizar las interacciones entre Cloud Storage y el cliente de gRPC, administrar el uso y solucionar problemas técnicos y cuellos de botella de rendimiento.

Precios

Las métricas del cliente de Cloud Storage no son facturables, lo que significa que puedes emitir, almacenar y acceder a ellas sin incurrir en cargos de supervisión de Cloud. Para obtener más información sobre los precios, consulta los precios de Google Cloud Observability.

Antes de comenzar

Para usar métricas del cliente, primero debes completar los siguientes pasos:

  1. Verifica que la biblioteca cliente o el conector de Cloud Storage que deseas usar admitan gRPC. Los siguientes conectores y bibliotecas cliente de Cloud Storage admiten gRPC:

  2. Configura la autenticación.

  3. Habilita la API de Cloud Monitoring.

  4. Habilita la API de Cloud Storage.

    Ir a la API de Cloud Storage

  5. Configura los roles y permisos necesarios para emitir métricas del cliente.

Roles obligatorios

Para establecer los permisos que necesitas para emitir métricas del cliente gRPC a Cloud Monitoring, otorga el rol de IAM de escritor de métricas de Monitoring (roles/monitoring.metricWriter) en la cuenta de servicio que usa el cliente gRPC.

Este rol predefinido contiene los permisos necesarios para emitir métricas del cliente gRPC a Cloud Monitoring. Para ver los permisos exactos que son necesarios, consulta la sección Permisos requeridos:

Permisos necesarios

  • monitoring.timeSeries.create

También puedes obtener estos permisos con otros roles personalizados o roles predefinidos. Para obtener más información sobre el rol de escritor de métricas de supervisión, consulta la documentación de IAM sobre roles/monitoring.metricWriter.

Consideraciones

Visualiza métricas en el Explorador de métricas

Usa las siguientes instrucciones para ver las métricas del cliente de gRPC de Cloud Storage 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. Selecciona el proyecto del que deseas ver las métricas.

  3. En el menú desplegable Métrica, haz clic en Seleccionar una métrica.

  4. En la barra de búsqueda Filtrar por nombre de recurso o métrica, ingresa storage.googleapis.com/Client o busca la métrica que deseas aplicar por nombre de métrica y haz clic en Aplicar. Para agregar más de una métrica, haz clic en Agregar consulta.

    Cloud Storage aplica las métricas a tu proyecto. Puedes filtrar o aggregarlas con los siguientes menús desplegables:

    • Para seleccionar y ver un subconjunto de tus datos según criterios especificados, usa el menú desplegable Filtrar.

    • Para combinar varios datos en un solo valor y ver una vista resumida de tus métricas, usa el menú desplegable Agregación.

    Permite que la aplicación se ejecute durante al menos un minuto antes de verificar si hay métricas publicadas.

Para ver las métricas que agregaste a tu proyecto con un panel, consulta Descripción general de los paneles.

Descripciones de las métricas

En las siguientes secciones, se describen las métricas del cliente de Cloud Storage que se pueden usar para supervisar el rendimiento del cliente de gRPC.

Métricas por intento del cliente

Las siguientes métricas recopilan datos de rendimiento sobre los intentos individuales que realiza un cliente para comunicarse con un servidor. Las métricas por intento del cliente pueden ayudarte a medir el comportamiento de reintento, los cuellos de botella y optimizar la comunicación entre un cliente y un servidor.

Métrica completa Descripción Tipo de instrumento Unidad Atributos
storage.googleapis.com/client/grpc/client/attempt/started Preview: Es la cantidad total de intentos de RPC iniciados, incluidos los que no se completaron. Contador {attempt}
  • grpc.method: Es el nombre completo del método gRPC, incluidos el paquete, el servicio y el método.
  • grpc.target: Es el URI de destino canónico que se usa cuando se crea el canal de gRPC.
storage.googleapis.com/client/grpc/client/attempt/duration Preview: Es el tiempo de extremo a extremo que se tarda en completar un intento de RPC, incluido el tiempo que lleva elegir un subcanal. Histograma s
  • grpc.method: Es el nombre completo del método gRPC, incluidos el paquete, el servicio y el método.
  • grpc.target: Es el URI de destino canónico que se usa cuando se crea el canal de gRPC.
  • grpc.status: Código de estado del servidor de gRPC recibido, como OK, CANCELLED o DEADLINE_EXCEEDED.
  • grpc.lb.locality: Es la localidad a la que se envía el tráfico. Se establecerá en el atributo resolver que se pasa desde la política weighted_target o en la cadena vacía si no se establece el atributo resolver.
storage.googleapis.com/client/grpc/client/attempt/sent_total_compressed_message_size Preview: Es el total de bytes, comprimidos pero no encriptados, que se envían en todos los mensajes de solicitud, excepto los metadatos por intento de RPC. Esto no incluye los bytes de enmarcado de gRPC ni de transporte. Histograma By
  • grpc.method: Es el nombre completo del método gRPC, incluidos el paquete, el servicio y el método.
  • grpc.target: Es el URI de destino canónico que se usa cuando se crea el canal de gRPC.
  • grpc.status: Código de estado del servidor de gRPC recibido, como OK, CANCELLED o DEADLINE_EXCEEDED.
  • grpc.lb.locality: Es la localidad a la que se envía el tráfico. Se establecerá en el atributo del solucionador que se pasa desde la política weighted_target o en la cadena vacía si no se establece el atributo del solucionador.
storage.googleapis.com/client/grpc/client/attempt/rcvd_total_compressed_message_size Preview: Es el total de bytes, comprimidos pero no encriptados, que se reciben en todos los mensajes de respuesta, excepto los metadatos por intento de RPC. Esto no incluye los bytes de enmarcado de gRPC ni de transporte. Histograma By
  • grpc.method: Es el nombre completo del método gRPC, incluidos el paquete, el servicio y el método.
  • grpc.target: Es el URI de destino canónico que se usa cuando se crea el canal de gRPC.
  • grpc.status: Código de estado del servidor de gRPC recibido, como OK, CANCELLED o DEADLINE_EXCEEDED.
  • grpc.lb.locality: Es la localidad a la que se envía el tráfico. Se establecerá en el atributo del solucionador que se pasa desde la política weighted_target o en la cadena vacía si no se establece el atributo del solucionador.

Para obtener más información sobre los instrumentos por intento del cliente, consulta la documentación de métricas de OpenTelemetry en GitHub.

Métricas por llamada del cliente

Las siguientes métricas proporcionan una vista agregada de todo el ciclo de vida de una llamada de cliente a un servidor. Las métricas por llamada del cliente proporcionan datos de alto nivel sobre las llamadas del cliente, proporcionan métricas de seguimiento para comprender los patrones de llamadas y te ayudan a identificar las frecuencias de los errores.

Métrica completa Descripción Tipo de instrumento Unidad Atributos
storage.googleapis.com/client/grpc/client/call/duration Preview: Mide el tiempo de extremo a extremo que tarda la biblioteca de gRPC en completar una RPC desde la perspectiva de la aplicación. Histograma s
  • grpc.method: Es el nombre completo del método gRPC, incluidos el paquete, el servicio y el método.
  • grpc.target: Es el URI de destino canónico que se usa cuando se crea el canal de gRPC.
  • grpc.status: Código de estado del servidor de gRPC recibido, como OK, CANCELLED o DEADLINE_EXCEEDED.

Para obtener más información sobre los instrumentos por llamada del cliente, consulta la documentación de métricas de OpenTelemetry en GitHub.

Solicita métricas de detección de carga

Las siguientes métricas proporcionan estadísticas sobre la eficacia del uso que hace tu aplicación cliente del sensor de carga de solicitudes. Las métricas de detección de carga de solicitudes pueden ayudarte a equilibrar las cargas del servidor, optimizar el uso de recursos y mejorar los tiempos de respuesta del cliente. Las siguientes métricas solo están disponibles con conectividad directa.

Métrica completa Descripción Tipo de instrumento Unidad Atributos
storage.googleapis.com/client/grpc/lb/rls/cache_entries Preview: Es la cantidad de entradas en la caché de detección de carga de solicitudes. Indicador {entry}
  • grpc.target: Indica el objetivo del canal de gRPC en el que se usa WRR.
  • grpc.lb.rls.server_target: Es el URI de destino con el que se comunica el servidor de detección de carga de la solicitud.
  • grpc.lb.rls.instance_uuid: Un identificador único universal (UUID) para una instancia de cliente de detección de carga de solicitudes individual. El valor no es significativo por sí solo, pero es útil para diferenciar entre instancias de cliente de detección de carga de solicitudes en los casos en que hay varias instancias en el mismo canal de gRPC o cuando hay varios canales para el mismo objetivo.
storage.googleapis.com/client/grpc/lb/rls/cache_size Preview: Es el tamaño actual de la caché de detección de carga de la solicitud. Indicador By
  • grpc.target: Es el objetivo del canal de gRPC en el que se usa WRR.
  • grpc.lb.rls.server_target: Es el URI de destino con el que se comunica el servidor de detección de carga de la solicitud.
  • grpc.lb.rls.instance_uuid: Es un UUID para una instancia de cliente de detección de carga de solicitudes individual. El valor no es significativo por sí solo, pero es útil para diferenciar entre instancias de cliente de detección de carga de solicitudes en los casos en que hay varias instancias en el mismo canal de gRPC o cuando hay varios canales para el mismo destino.
storage.googleapis.com/client/grpc/lb/rls/default_target_picks Preview: Es la cantidad de selecciones del balanceador de cargas (LB) que se envían al destino predeterminado. Contador {pick}
  • grpc.target: Indica el objetivo del canal de gRPC en el que se usa el sensor de carga de solicitudes.
  • grpc.lb.rls.server_target: Es el URI de destino del servidor de detección de carga de la solicitud con el que se debe comunicar.
  • grpc.lb.rls.data_plane_target: Es una cadena de destino que usa la detección de carga de solicitudes para enrutar el tráfico del plano de datos. El valor lo muestra el servidor de detección de carga de solicitudes para una clave en particular o se configura como el objetivo predeterminado en la configuración de detección de carga de solicitudes.
  • grpc.lb.pick_result:Es el resultado de una selección de LB, como "complete", "fail" o "drop".
storage.googleapis.com/client/grpc/lb/rls/target_picks Preview: Es la cantidad de selecciones de LB que se envían a cada objetivo de detección de carga de solicitudes. Si el servidor de detección de carga de solicitudes también muestra el destino predeterminado, las RPC que se envían a ese destino desde la caché se cuentan en esta métrica, no en grpc.rls.default_target_picks. Contador {pick}
  • grpc.target: Es el objetivo del canal de gRPC en el que se usa el sensor de carga de solicitudes.
  • grpc.lb.rls.server_target: Es el URI de destino del servidor de detección de carga de la solicitud con el que se debe comunicar.
  • grpc.lb.rls.data_plane_target: Es una cadena de destino que usa el sensor de carga de solicitudes para enrutar el tráfico del plano de datos. El valor lo muestra el servidor de detección de carga de solicitudes para una clave en particular o se configura como el objetivo predeterminado en la configuración de detección de carga de solicitudes.
  • grpc.lb.pick_result: Es el resultado de una selección de LB, como "complete", "fail" o "drop".
storage.googleapis.com/client/grpc/lb/rls/failed_picks Preview: Es la cantidad de selecciones de LB que fallaron debido a una solicitud de detección de carga de solicitud fallida o a que se limitó el canal de detección de carga de solicitud. Contador {pick}
  • grpc.target: Es el objetivo del canal de gRPC en el que se usa el sensor de carga de solicitudes.
  • grpc.lb.rls.server_target: Es el URI de destino del servidor de detección de carga de la solicitud con el que se comunica.

Métricas del cliente del servicio de xDiscovery

Las siguientes métricas proporcionan estadísticas sobre cómo tu aplicación cliente interactúa con el plano de control del servicio de xDiscovery (xDS) para descubrir y configurar conexiones a servicios de backend. Las métricas de xDS pueden ayudarte a hacer un seguimiento de la latencia de las solicitudes de servicio, supervisar las actualizaciones de configuración y optimizar el rendimiento general de xDS.

Las siguientes métricas solo están disponibles con conectividad directa.

Métrica completa Descripción Tipo de instrumento Unidad Atributos
storage.googleapis.com/client/grpc/xds_client/connected Preview. Mide si el cliente de xDS tiene o no una transmisión de ADS en funcionamiento al servidor de xDS. Para un servidor determinado, esta métrica se establece en 1 cuando se crea el flujo inicialmente. Si hay una falla de conectividad o cuando el flujo de ADS falla sin ver un mensaje de respuesta según A57, la métrica se establece en 0. Una vez establecida en 0, la métrica se restablecerá a 1 cuando se reciba la primera respuesta en un flujo de ADS. Esta métrica solo está disponible para las bibliotecas cliente de Cloud para C++. Indicador {bool}
  • grpc.target: En el caso de los clientes, indica el objetivo del canal de gRPC en el que se usa XdsClient. Para los servidores, será la cadena "#server".
  • grpc.xds.server: El URI de destino del servidor xDS con el que se comunica XdsClient.
storage.googleapis.com/client/grpc/xds_client/resource_updates_invalid Preview: Es la cantidad de recursos recibidos que se consideraron no válidos. Esta métrica solo está disponible para las bibliotecas cliente de Cloud para C++. Contador {resource}
  • grpc.target: En el caso de los clientes, indica el objetivo del canal de gRPC en el que se usa XdsClient. Para los servidores, será la cadena "#server".
  • grpc.xds.server: El URI de destino del servidor de xDS con el que se comunica XdsClient.
  • grpc.xds.resource_type: Indica un tipo de recurso xDS, como "envoy.config.listener.v3.Listener".
storage.googleapis.com/client/grpc/xds_client/resource_updates_valid Preview: Es la cantidad de recursos recibidos que se consideraron válidos, incluso si no se modificaron. Esta métrica solo está disponible para las bibliotecas cliente de Cloud para C++. Contador {resource}
  • grpc.target: En el caso de los clientes, indica el objetivo del canal de gRPC en el que se usa XdsClient. Para los servidores, será la cadena "#server".
  • grpc.xds.server: El URI de destino del servidor de xDS con el que se comunica XdsClient.
  • grpc.xds.resource_type: Indica un tipo de recurso xDS, como "envoy.config.listener.v3.Listener".
storage.googleapis.com/client/grpc/xds_client/resources Preview: Es la cantidad de recursos xDS. Esta métrica solo está disponible para las bibliotecas cliente de Cloud para C++. Indicador {resource}
  • grpc.target: En el caso de los clientes, indica el objetivo del canal de gRPC en el que se usa XdsClient. Para los servidores, será la cadena "#server".
  • grpc.xds.authority: La autoridad de xDS. El valor será "#old" para los nombres de recursos que no sean de xdstp que se identificaron en la API de xDS, antes de la introducción de la representación de URI xdstp://.
  • grpc.xds.cache_state: Indica el estado de la caché de un recurso xDS.
  • grpc.xds.resource_type indica un tipo de recurso de xDS, como "envoy.config.listener.v3.Listener".
storage.googleapis.com/client/grpc/xds_client/server_failure Preview: Es la cantidad de servidores xDS que ya no funcionan correctamente y que dejaron de estar disponibles, se sobrecargaron o proporcionan datos de configuración incorrectos o no válidos. Esta métrica solo está disponible para las bibliotecas cliente de Cloud para C++. Contador {failure}
  • grpc.target: Es el URI de destino del servidor de xDS con el que se comunica XdsClient.
  • grpc.xds.server: Para los clientes, indica el objetivo del canal de gRPC en el que se usa XdsClient. Para los servidores, esta es la cadena "#server".

Para obtener más información sobre las métricas de clientes de xDS, consulta la documentación sobre el balanceo de cargas global basado en xDS en GitHub.

Cómo inhabilitar las métricas del cliente

Si es necesario, puedes inhabilitar las métricas del cliente.

Java

public GrpcStorageOptions.Builder setEnableGrpcClientMetrics(false enableGrpcClientMetrics)

Para obtener más información, consulta el método GrpcStorageOptions.Builder de la clase de bibliotecas cliente de Cloud para Java para las métricas del cliente de gRPC.

C++

Para inhabilitar las métricas del cliente para la API de gRPC con las bibliotecas cliente de Cloud para C++, consulta Estructura EnableGrpcMetricsOption.

¿Qué sigue?