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 Métricas 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).En la configuración de la app de Gemini Enterprise, habilita el parámetro de configuración Habilitar la instrumentación de seguimientos y registros de OpenTelemetry. Para obtener más información, consulta Administra la configuración de observabilidad.
Accede a las métricas en el Explorador de métricas
Para acceder a las métricas, sigue estos pasos:
En la consola de Google Cloud , ve a la página Explorador de métricas.
Selecciona el proyecto Google Cloud en el que se creó tu app de Gemini Enterprise.
Haz clic en Selecciona 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 Es la cantidad de sesiones que controla el agente de Gemini Enterprise. Agente de Gemini Enterprise: Recuento de herramientas del agente de Gemini Enterprise Cantidad de veces que el agente de Gemini Enterprise invocó herramientas. Agente de Gemini Enterprise: Recuento de turnos del agente de Gemini Enterprise Es la cantidad de turnos de conversación en las sesiones del agente de Gemini Enterprise. Agente de Gemini Enterprise: Latencia total del agente de Gemini Enterprise Es la latencia total de las respuestas del agente de Gemini Enterprise. Agente de Gemini Enterprise: Latencia total de la herramienta del agente de Gemini Enterprise Es la latencia total que se genera por las ejecuciones de herramientas dentro del agente de Gemini Enterprise. Gemini Enterprise DataConnector - Gemini Enterprise DataConnector Request Count Es el recuento total de solicitudes realizadas a los conectores de datos de Gemini Enterprise (también denominados almacenes de datos en la consola de Google Cloud ). Selecciona la métrica que deseas explorar y haz clic en Aplicar.
De manera opcional, puedes establecer filtros de etiquetas y elementos de agregación adicionales, y ajustar el intervalo de tiempo.
Métricas de acceso para agentes
También puedes ver los paneles de métricas operativas, específicas de la herramienta y de la sesión directamente para los agentes individuales en la pestaña Métricas del agente en la consola de Google Cloud .
Para acceder a las métricas de un agente, sigue estos pasos:
- En la consola de Google Cloud , 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 operativa clave dividida en dos vistas: Resumen y Herramientas.
Métricas generales
En esta vista, se proporciona un panel que resume los datos estándar de la sesión y el estado del agente, incluidos los siguientes:
- Sesiones: Es el recuento total de sesiones de usuarios.
- Tiempo promedio por sesión: Es el tiempo promedio transcurrido durante una sesión.
- Invocaciones de agentes: Es la cantidad total de veces que se llamó al agente.
- Latencia del agente: Es la latencia a lo largo del tiempo y en métricas específicas.
- Tráfico de agentes: Es el volumen de solicitudes entrantes.
- Tasa de errores de agentes: Es el porcentaje de invocaciones de agentes fallidas.
Métricas de herramientas
Esta vista se enfoca específicamente en el uso y la latencia de las herramientas conectadas a tu agente, lo que incluye lo siguiente:
- Llamadas totales: Es la cantidad de solicitudes de ejecución de herramientas.
- Duración de P95 por herramienta: Es la latencia del percentil 95 de las ejecuciones, categorizada por herramienta.
- Recuento de llamadas por herramienta: Es el recuento total de llamadas dividido entre las diferentes herramientas.
- Tasa de errores por herramienta: Es la tasa de fallas de las ejecuciones por herramienta.
- Tasa de"No se llamó a ninguna herramienta": Es la tasa a la que las interacciones no activaron la ejecución de ninguna herramienta.
¿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 Cómo desactivar la configuración de observabilidad.