Consulta las métricas de las herramientas de IA para desarrolladores

En este documento, se describe cómo ver las métricas de uso y la telemetría de las herramientas para desarrolladores de IA en tu organización, como Google Antigravity y la CLI de Antigravity. Estas métricas muestran la adopción de los usuarios, el consumo de tokens, las llamadas a la API y la ejecución de herramientas.

Antes de comenzar

Antes de ver las métricas de las herramientas para desarrolladores de IA, asegúrate de cumplir con los siguientes requisitos previos:

  • Activa las herramientas para desarrolladores de IA: Para ver las métricas de las herramientas para desarrolladores de IA, tu organización debe activar las herramientas para desarrolladores de IA en el proyecto. Consulta Activa las herramientas de IA para desarrolladores.

  • Cuenta de Facturación de Cloud: Tu proyecto debe tener habilitada la Facturación de Cloud. Consulta Tipos de cuentas de Facturación de Cloud.

  • Ediciones compatibles: Los usuarios necesitan una suscripción a la edición Gemini Enterprise Standard, Plus, Standard Emerging Market o Pay-as-you-go.

  • Roles obligatorios: Para acceder a la página Métricas de las herramientas para desarrolladores en la consola deGoogle Cloud , necesitas el rol de administrador de Gemini Enterprise (roles/discoveryengine.agentspaceAdmin).

Accede al panel de métricas

Para ver las métricas de las herramientas para desarrolladores de IA en la consola de Google Cloud , haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Gemini Enterprise.

    Ir a Gemini Enterprise

  2. Selecciona el proyecto de Google Cloud en el que habilitaste las herramientas para desarrolladores de IA.

  3. En el menú de navegación, haz clic en Métricas de herramientas para desarrolladores.

  4. Usa los controles de período que se encuentran en la esquina superior derecha del panel para ajustar el período del informe:

    Control Descripción
    Menú del selector de intervalo de tiempo De forma predeterminada, el panel muestra los datos del Último día con la actualización automática en vivo habilitada. Haz clic en el menú para realizar cualquiera de las siguientes acciones:
    • Escribe una duración personalizada directamente en el campo de filtro Tiempo relativo (por ejemplo, 15m, 1h, 1d o 1w).
    • Selecciona un período relativo predeterminado: Hoy, Ayer, Últimos 15 minutos, Últimos 30 minutos, Última hora, Últimas 3 horas, Últimas 6 horas, Últimas 12 horas, Último día, Últimos 2 días, Últimos 7 días o Últimos 14 días.
    • Haz clic en Horas de inicio y finalización para especificar una fecha y hora de inicio y finalización personalizadas para la ventana de informes.
    • Haz clic en Alrededor de una hora para especificar una fecha y hora, y mostrar las métricas centradas en esa marca de tiempo.
    • Haz clic en Zona horaria para seleccionar una zona horaria de visualización diferente para los gráficos (por ejemplo, PDT (UTC-7)).
    Flechas hacia la izquierda y la derecha Cambia el período del informe hacia atrás () o hacia adelante () en el tiempo según la duración seleccionada en el menú. Por ejemplo, si se selecciona Último día, hacer clic en desplaza los gráficos un día hacia atrás.
    Alejar el período Haz clic en para alejarte de un período específico. Todos los gráficos se actualizan para mostrar los datos del período alejado. Para acercar y restablecer la vista, selecciona una duración en el menú del selector de período.
    Actualización automática Activa o desactiva la actualización automática en tiempo real de los datos del panel cuando visualices un período relativo. Cuando se selecciona un intervalo de tiempo absoluto (como horas de inicio y finalización personalizadas o un período histórico), se inhabilita la actualización automática, ya que no es compatible con los intervalos de tiempo absolutos.

Explora los datos del gráfico

Cada gráfico del panel Métricas de herramientas para desarrolladores proporciona controles interactivos para ayudarte a inspeccionar series temporales, correlacionar métricas con registros y analizar los datos subyacentes:

Control Descripción
Información Junto al título del gráfico, haz clic en Información para ver los detalles sobre los filtros, las agrupaciones y las propiedades de agregación que se aplican a la consulta de métricas del gráfico.
Crear una política de alertas En los gráficos de líneas de métricas, haz clic en Crear política de alertas en la barra de herramientas del gráfico para abrir el flujo de trabajo de alertas en Cloud Monitoring prepropagado con la consulta de series temporales del gráfico. Luego, puedes configurar las condiciones de umbral y los canales de notificación para la métrica.
Explorar datos En la barra de herramientas del gráfico, haz clic en Explorar datos para abrir la consulta de métricas en el Explorador de métricas. En el Explorador de métricas, puedes inspeccionar, filtrar, agrupar y modificar la consulta de series temporales subyacente en diferentes dimensiones, o bien guardar vistas personalizadas en un panel personalizado.
Ver en pantalla completa En la barra de herramientas del gráfico, haz clic en Más opciones de gráfico y, luego, selecciona Ver en pantalla completa para expandir el gráfico y completar la pantalla para una inspección detallada de los datos de la serie temporal y la leyenda.
Inspeccionar registros relacionados Puedes correlacionar los datos de las métricas con las entradas de registro escritas en el mismo período para solucionar problemas de actividad y errores:
  • Vista de panel: En la barra de herramientas del gráfico, haz clic en Más opciones de gráfico y, luego, selecciona Inspeccionar registros relacionados para abrir un panel de vista dividida que muestre el gráfico junto con las entradas de registro correlacionadas.
  • Cuadro de información de datos: En cualquier serie temporal de gráfico, mantén el puntero sobre un dato específico y, luego, selecciona Inspeccionar registros relacionados en el cuadro de información. En este modo, el panel de vista dividida filtra las entradas de registro en una ventana de cinco minutos antes y después de la marca de tiempo seleccionada.

Métricas disponibles

En la siguiente tabla, se enumeran todas las métricas disponibles en el panel.

Sección Nombre de la métrica Descripción
Usuarios activos (adopción) Un usuario activo es un usuario único que inició, al menos, una acción de la herramienta para desarrolladores de IA (como una solicitud a la API, una instrucción o la ejecución de una herramienta) durante el período del informe.
Usuarios activos por hora (promedio) Muestra la cantidad promedio de usuarios activos únicos por hora durante el período seleccionado.
Usuarios activos por día (promedio) Muestra la cantidad promedio de usuarios activos únicos por día durante el período seleccionado.
Usuarios activos por semana (promedio) Muestra la cantidad promedio de usuarios activos únicos por semana durante el período seleccionado.
Usuarios activos por mes (promedio) Muestra la cantidad promedio de usuarios activos únicos por mes (usuarios activos en un período de 28 días) durante el período seleccionado.
Usuarios activos por hora Es un gráfico de líneas de tendencia que muestra la cantidad de usuarios activos únicos por hora durante el período seleccionado.
Usuarios activos por día Es un gráfico de líneas de tendencia que muestra la cantidad de usuarios activos únicos por día durante el período seleccionado.
Usuarios activos por semana Un gráfico de líneas de tendencia que muestra la cantidad de usuarios activos únicos por semana durante el período seleccionado.
Usuarios activos por mes Es un gráfico de líneas de tendencia que muestra la cantidad de usuarios activos únicos por mes (usuarios activos en un período de 28 días) durante el período seleccionado.
Herramientas y llamadas a la API Total de tokens Es la cantidad total de tokens de entrada y salida combinados que consumieron las herramientas para desarrolladores de IA durante el período seleccionado.
Uso diario de tokens Un gráfico de líneas que muestra el consumo diario de tokens a lo largo del tiempo.
Llamadas a la API diarias Un gráfico de líneas que muestra el recuento diario de llamadas a la API que realizan las herramientas para desarrolladores de IA, incluido un desglose de errores por etiqueta error_type (por ejemplo, límites de cuota, errores de autenticación o errores del cliente).
Llamadas a herramientas diarias Un gráfico de líneas que muestra el recuento diario de llamadas a herramientas iniciadas por herramientas para desarrolladores de IA.
Llamadas a herramientas diarias aceptadas Es un gráfico de líneas que muestra el recuento diario de sugerencias de llamadas a herramientas propuestas por el agente que los usuarios aceptaron y ejecutaron.

¿Qué sigue?