En este documento, se describe cómo ver las métricas de uso y la telemetría de las herramientas de IA para desarrolladores de tu organización, como Google Antigravity y la CLI de Antigravity. Estas métricas muestran la adopción por parte 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 de IA para desarrolladores, asegúrate de cumplir con los siguientes requisitos:
Activar las herramientas de IA para desarrolladores: Para ver las métricas de las herramientas de IA para desarrolladores, tu organización debe activar las herramientas de IA para desarrolladores del proyecto. Consulta Cómo activar las herramientas de IA para desarrolladores.
Cuenta de Facturación de Cloud: Tu proyecto necesita que la Facturación de Cloud esté habilitada y que tengas una cuenta facturada. 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 o de pago por uso.
Roles obligatorios: Para acceder a la página Métricas de herramientas para desarrolladores en la Google Cloud consola, 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 de IA para desarrolladores en la Google Cloud consola, haz lo siguiente:
En la Google Cloud consola de, ve a la página Gemini Enterprise.
Selecciona el Google Cloud proyecto en el que habilitaste las herramientas de IA para desarrolladores.
En el menú de navegación, haz clic en Métricas de herramientas para desarrolladores.
Usa los controles de intervalo de tiempo 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 de Ú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, o1w). - Selecciona un período relativo preestablecido: 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 el período del informe.
- 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 Desplaza 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 Último día está seleccionado, al hacer clic ense desplazan los gráficos un día hacia atrás.Alejar el intervalo de tiempo Haz clic en para alejar un intervalo de tiempo específico. Todos los gráficos se actualizan para mostrar los datos del intervalo de tiempo alejado. Para acercar y restablecer la vista, selecciona una duración en el menú del selector de intervalo de tiempo. Actualización automática Activa o desactiva la actualización automática en vivo de los datos del panel cuando veas 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), la actualización automática se inhabilita porque no es compatible con los intervalos de tiempo absolutos. -
Escribe una duración personalizada directamente en el campo de filtro Tiempo relativo (por ejemplo,
Explora los datos de los gráficos
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 detalles sobre los filtros, las agrupaciones y las propiedades de agregación aplicadas a la consulta de métricas del gráfico. |
| Crear 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 con la consulta de series temporales del gráfico completada previamente. Luego, puedes configurar las condiciones de umbral y los canales de notificación canales 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 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 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 llenar la pantalla para una inspección detallada de las series temporales y los datos de 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:
|
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 herramienta de IA para desarrolladores (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 de 28 días) durante el período seleccionado. | |
| Usuarios activos por hora | 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 | 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 | Un gráfico de líneas de tendencia que muestra la cantidad de usuarios activos únicos por mes (usuarios activos de 28 días) durante el período seleccionado | |
| Herramientas y llamadas a la API | Tokens totales | La cantidad total de tokens de entrada y salida combinados que consumieron las herramientas de IA para desarrolladores 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 diarias a la API |
Un gráfico de líneas que muestra el recuento diario de llamadas a la API realizadas por las herramientas de IA para desarrolladores
, incluido un desglose de errores por etiqueta error_type
(por ejemplo, límites de cuota, errores de autenticación o errores del cliente).
|
|
| Llamadas diarias a herramientas | Un gráfico de líneas que muestra el recuento diario de llamadas a herramientas iniciadas por las herramientas de IA para desarrolladores. | |
| Llamadas diarias a herramientas aceptadas | 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. | |
Limitaciones
Las siguientes limitaciones se aplican a las métricas de las herramientas de IA para desarrolladores:
- Las métricas Llamadas diarias a herramientas y Llamadas diarias a herramientas aceptadas no muestran datos.
¿Qué sigue?
- Obtén más información sobre las herramientas y capacidades disponibles en la descripción general de las herramientas de IA para desarrolladores.
- Obtén información para configurar los parámetros de configuración de las herramientas para desarrolladores. Para obtener más información, consulta Cómo configurar los parámetros de configuración de las herramientas de IA para desarrolladores.
- Obtén información para administrar el acceso con roles personalizados. Para obtener más información, consulta Cómo crear roles personalizados para las herramientas de IA para desarrolladores.