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. |
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.
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 pertenece al 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
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ó las 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 la herramienta del agente de Gemini Enterprise Latencia La latencia total que se produce por 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). 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 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 del agente: 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 del agente: 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.