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 agentes individuales con la pestaña Métricas del agente.
Conceptos clave
En esta sección, se presentan 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. |
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 Observabilidad 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.
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 prefijo discoveryengine.googleapis.com/, que se encuentra en el nivel "todas las demás métricas de Google Cloud" y se retiene 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
Para acceder a las métricas, sigue estos pasos:
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 Gemini Enterprise Agent - Gemini Enterprise Agent Session Count La cantidad de sesiones que controla el agente de Gemini Enterprise. Gemini Enterprise Agent - Gemini Enterprise Agent Tool Count La cantidad de veces que el agente de Gemini Enterprise invocó herramientas. Gemini Enterprise Agent - Gemini Enterprise Agent Turn Count La cantidad de turnos de conversación dentro de las sesiones del agente de Gemini Enterprise. Gemini Enterprise Agent - Gemini Enterprise Agent Total Latency La latencia total de las respuestas del agente de Gemini Enterprise. Gemini Enterprise Agent - Gemini Enterprise Agent Tool Total Latency La latencia total que se produce por las ejecuciones de herramientas dentro del agente de Gemini Enterprise. Gemini Enterprise DataConnector - Gemini Enterprise DataConnector Request Count 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). Selecciona la métrica que deseas explorar y haz clic en Aplicar.
De manera opcional, configura 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 operacionales, específicos de herramientas y de sesiones directamente para agentes individuales en la pestaña Métricas 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 Métricas.
La pestaña Métricas proporciona telemetría operacional 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, lo 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 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.