En este documento, se describe cómo acceder a las métricas que genera tu app de Gemini Enterprise. Estas métricas proporcionan estadísticas sobre el rendimiento y el estado de tu aplicación.
Puedes ver la telemetría de las métricas con el Explorador de métricas o directamente en los agentes individuales con la pestaña Observabilidad del agente.
Conceptos clave
En esta sección, se presentan los conceptos clave relacionados con la observabilidad en Gemini Enterprise.
| Concepto | Descripción |
|---|---|
| Métricas | Las métricas son mediciones numéricas que los sistemas recopilan con el tiempo. Estas mediciones representan el rendimiento, el uso de recursos o el comportamiento de un sistema. Los ingenieros usan métricas para supervisar el estado del sistema, identificar tendencias y activar alertas. |
| Métricas centradas en el agente | Métricas que miden la actividad de un agente individual, como sus sesiones, turnos de conversación e invocaciones de herramientas. Se enumeran bajo el tipo de recurso Agente de Gemini Enterprise y se recopilan solo cuando la configuración de observabilidad Habilitar la instrumentación de seguimientos y registros de OpenTelemetry está activada para ese agente. |
| Métricas centradas en la app | Métricas que miden todo el tráfico a una app en lugar de a un solo agente, como el recuento de solicitudes y la latencia de extremo a extremo. Se enumeran en el tipo de recurso Motor de Gemini Enterprise, en el que Motor es el nombre de la API para una app de Gemini Enterprise, y se recopilan independientemente de la configuración de observabilidad. |
Antes de comenzar
Asegúrate de tener lo siguiente:
El rol de Administrador de Gemini Enterprise o el rol de Usuario de Gemini Enterprise de la consola de. Google Cloud
Una app web de Gemini Enterprise existente. Para obtener información sobre cómo crear una app nueva, consulta Crea una app.
Para acceder al Explorador de métricas, debes tener el rol de Visualizador de Monitoring (
roles/monitoring.viewer).Habilita el parámetro de configuración de observabilidad Habilitar la instrumentación de seguimientos y registros de OpenTelemetry. Según el tipo de agente, habilita esta opción en las configuraciones a nivel de la app (para el agente Core Assistant) o dentro de la pestaña Configuración del agente (para los agentes creados por empleados de Agent Designer y los agentes de Deep Research). Para obtener más información, consulta Administra la configuración de observabilidad. Este parámetro de configuración es obligatorio para las métricas centradas en el agente. Las métricas centradas en la app, que se enumeran en el tipo de recurso Motor de Gemini Enterprise, se recopilan sin él.
Retención de datos
Las métricas que genera tu app de Gemini Enterprise se almacenan en
Cloud Monitoring en tu Google Cloud proyecto, y su retención se rige
por Cloud Monitoring. Las métricas de Gemini Enterprise se publican con el
discoveryengine.googleapis.com/ prefijo, que pertenece al nivel "todas las demás
Google Cloud métricas" y se conserva durante 6 semanas de forma predeterminada. Los datos anteriores al período de retención se borran automáticamente. Para obtener los valores de retención autorizados
y más recientes, consulta
Retención de datos en la
documentación de cuotas y límites de Cloud Monitoring.
Accede a las métricas en el Explorador de métricas
Sigue estos pasos para acceder a las métricas:
En la Google Cloud consola de, ve a la página Explorador de métricas.
Selecciona el Google Cloud proyecto en el que se creó tu app de Gemini Enterprise.
Haz clic en Seleccionar una métrica para abrir una barra de búsqueda.
En la barra de búsqueda, busca las siguientes métricas:
Nombre de la métrica Descripción Agente de Gemini Enterprise - Recuento de sesiones del agente de Gemini Enterprise La cantidad de sesiones que controla el agente de Gemini Enterprise. Agente de Gemini Enterprise - Recuento de herramientas del agente de Gemini Enterprise La cantidad de veces que el agente de Gemini Enterprise invocó herramientas. Agente de Gemini Enterprise - Recuento de turnos del agente de Gemini Enterprise La cantidad de turnos de conversación dentro de las sesiones del agente de Gemini Enterprise. Agente de Gemini Enterprise - Total del agente de Gemini Enterprise Latencia La latencia total de las respuestas del agente de Gemini Enterprise. Agente de Gemini Enterprise - Total de herramientas del agente de Gemini Enterprise Latencia La latencia total que generan las ejecuciones de herramientas dentro del agente de Gemini Enterprise. Conector de datos de Gemini Enterprise - Conector de datos de Gemini Enterprise Recuento de solicitudes El recuento total de solicitudes realizadas a los conectores de datos de Gemini Enterprise (también denominados almacenes de datos en la Google Cloud consola de). Conector de datos de Gemini Enterprise - Conector de datos de Gemini Enterprise Latencias de solicitudes (Beta) La latencia de las solicitudes realizadas a los conectores de datos de Gemini Enterprise (también denominados almacenes de datos en la Google Cloud consola de) en milisegundos. Motor de Gemini Enterprise - Recuento de solicitudes del motor de Gemini Enterprise La cantidad total de solicitudes que recibió tu app de Gemini Enterprise, en todo el tráfico a la app en lugar de a un solo agente. Se desglosa por método de API, código de respuesta canónico de gRPC código de respuesta, clase de código de respuesta, tipo de consulta y modelo. Motor de Gemini Enterprise - Latencia total de solicitudes del motor de Gemini Enterprise La distribución de la latencia de solicitudes de extremo a extremo para tu app de Gemini Enterprise. Se registra para cada solicitud, incluidas las que muestran un error. Motor de Gemini Enterprise - Latencia de tiempo hasta la primera respuesta del motor de Gemini Enterprise La distribución de la latencia entre la recepción de una solicitud y la transmisión del primer token de respuesta. Se registra solo para las solicitudes que producen al menos un token de respuesta. Motor de Gemini Enterprise - Latencia de tiempo hasta el primer token del motor de Gemini Enterprise La distribución de la latencia entre la recepción de una solicitud y la transmisión del primer token, ya sea que ese token forme parte del proceso de pensamiento del modelo o de una respuesta final. Se registra solo para solicitudes que producen al menos un token transmitido. Selecciona la métrica que deseas explorar y haz clic en Aplicar.
De manera opcional, establece filtros de etiquetas adicionales, elementos de agregación y ajusta el intervalo de tiempo.
Accede a las métricas de los agentes
También puedes ver los paneles de métricas operativas, específicas de herramientas y de sesiones directamente para agentes individuales en la pestaña Observabilidad del agente en la Google Cloud consola.
Para acceder a las métricas de un agente, haz lo siguiente:
- En la Google Cloud consola de, navega a tu app y, luego, haz clic en Agentes.
- Selecciona el agente que deseas inspeccionar y, luego, haz clic en la pestaña Observabilidad.
La pestaña Observabilidad proporciona telemetría operativa clave dividida en dos vistas: Descripción general y Herramientas.
Métricas generales
Esta vista proporciona un panel que resume los datos estándar de estado de la sesión y del agente, que incluye lo siguiente:
- Sesiones: Recuento total de sesiones de usuario.
- Tiempo promedio por sesión: Tiempo promedio transcurrido durante una sesión.
- Invocaciones de agentes: Cantidad total de veces que se llamó al agente.
- Latencia del agente: Latencia en el tiempo y métricas específicas.
- Tráfico del agente: Volumen de solicitudes entrantes.
- Tasa de errores de agentes: Porcentaje de invocaciones de agentes fallidas.
Métricas de herramientas
Esta vista se centra específicamente en el uso y la latencia de las herramientas conectadas a tu agente, que incluye lo siguiente:
- Total de llamadas: Cantidad de solicitudes de ejecución de herramientas.
- Duración de P95 por herramienta: El percentil 95 de la latencia de las ejecuciones, categorizado por herramienta.
- Recuento de llamadas por herramienta: Recuento total de llamadas dividido entre diferentes herramientas.
- Tasa de errores por herramienta: La tasa de fallas de las ejecuciones por herramienta.
- Tasa de"No se llamó a ninguna herramienta": La tasa a la que las interacciones no activaron ninguna ejecución de herramientas.
¿Qué sigue?
- Crea paneles con las métricas de Gemini Enterprise. Para obtener más información, consulta Crea y administra paneles personalizados.
- Crea alertas cuando las métricas superen un umbral. Para obtener más información, consulta Crea políticas de alertas de umbral de métrica.
- Para desactivar el seguimiento del Explorador de métricas, consulta Desactiva la configuración de observabilidad.