Questo documento descrive come visualizzare le metriche di utilizzo e la telemetria per gli strumenti per sviluppatori AI della tua organizzazione, come Google Antigravity e l'interfaccia a riga di comando Antigravity. Queste metriche mostrano l'adozione da parte degli utenti, il consumo di token, le chiamate API e l'esecuzione degli strumenti.
Prima di iniziare
Prima di visualizzare le metriche degli strumenti per sviluppatori AI, assicurati di soddisfare i seguenti prerequisiti:
Attiva gli strumenti per sviluppatori AI: per visualizzare le metriche degli strumenti per sviluppatori AI, la tua organizzazione deve attivare gli strumenti per sviluppatori AI per il progetto. Consulta Attiva gli strumenti per sviluppatori AI.
Account di fatturazione Cloud: per il tuo progetto deve essere abilitata la fatturazione Cloud. Consulta Tipi di account di fatturazione Cloud.
Versioni supportate: gli utenti devono disporre di un abbonamento a Gemini Enterprise Standard, Plus, Standard per i mercati emergenti o con pagamento a consumo.
Ruoli obbligatori: per accedere alla pagina Metriche degli strumenti per sviluppatori nella consoleGoogle Cloud , devi disporre del ruolo Gemini Enterprise Admin(
roles/discoveryengine.agentspaceAdmin).
Accedi alla dashboard delle metriche
Per visualizzare le metriche degli strumenti per sviluppatori AI nella console Google Cloud , segui questi passaggi:
Nella console Google Cloud , vai alla pagina Gemini Enterprise.
Seleziona il progetto Google Cloud in cui hai abilitato gli strumenti per sviluppatori AI.
Nel menu di navigazione, fai clic su Metriche degli strumenti per sviluppatori.
Utilizza i controlli dell'intervallo di tempo nell'angolo in alto a destra della dashboard per regolare il periodo di tempo dei report:
Controllo Descrizione Menu del selettore dell'intervallo di tempo Per impostazione predefinita, la dashboard mostra i dati relativi all'ultimo giorno con l'aggiornamento automatico in tempo reale attivato. Fai clic sul menu per eseguire una delle seguenti operazioni: -
Digita una durata personalizzata direttamente nel campo del filtro Tempo relativo (ad esempio,
15m,1h,1do1w). - Seleziona un periodo di tempo relativo preimpostato: Oggi, Ieri, Ultimi 15 minuti, Ultimi 30 minuti, Ultima ora, Ultime 3 ore, Ultime 6 ore, Ultime 12 ore, Ultimo giorno, Ultimi 2 giorni, Ultimi 7 giorni o Ultimi 14 giorni.
- Fai clic su Orari di inizio e di fine per specificare una data e un'ora di inizio e di fine personalizzate per la finestra dei report.
- Fai clic su In un determinato momento per specificare una data e un'ora e visualizzare le metriche incentrate su quel timestamp.
- Fai clic su Fuso orario per selezionare un fuso orario di visualizzazione diverso per i grafici (ad esempio, PDT (UTC-7)).
Frecce sinistra e destra Shift il periodo di tempo del report indietro ( ) o avanti () nel tempo in base alla durata selezionata nel menu. Ad esempio, se è selezionato Ultimo giorno, facendo clic sui grafici vengono spostati indietro di un giorno.Diminuisci lo zoom sull'intervallo di tempo Fai clic su per diminuire lo zoom di un intervallo di tempo specifico. Tutti i grafici vengono aggiornati per mostrare i dati relativi all'intervallo di tempo con lo zoom indietro. Per aumentare lo zoom e reimpostare la visualizzazione, seleziona una durata dal menu di selezione dell'intervallo di tempo. Aggiornamento automatico Attiva o disattiva l'aggiornamento automatico in tempo reale dei dati della dashboard quando visualizzi un periodo di tempo relativo. Quando viene selezionato un intervallo di tempo assoluto (ad esempio, ore di inizio e di fine personalizzate o una finestra storica), l'aggiornamento automatico viene disattivato perché non è supportato per gli intervalli di tempo assoluti. -
Digita una durata personalizzata direttamente nel campo del filtro Tempo relativo (ad esempio,
Esplora i dati dei grafici
Ogni grafico della dashboard Metriche degli strumenti per sviluppatori fornisce controlli interattivi per aiutarti a ispezionare le serie temporali, correlare le metriche ai log e analizzare i dati sottostanti:
| Controllo | Descrizione |
|---|---|
| Informazioni | Accanto al titolo del grafico, fai clic su Informazioni per visualizzare i dettagli sui filtri, sui raggruppamenti e sulle proprietà di aggregazione applicati alla query della metrica del grafico. |
| Crea policy di avviso | Nei grafici a linee delle metriche, fai clic su Crea policy di avviso nella barra degli strumenti del grafico per aprire il flusso di lavoro di avviso in Cloud Monitoring precompilato con la query delle serie temporali del grafico. Puoi quindi configurare le condizioni di soglia e i canali di notifica per la metrica. |
| Esplora i dati | Nella barra degli strumenti del grafico, fai clic su Esplora dati per aprire la query della metrica in Esplora metriche. In Esplora metriche puoi ispezionare, filtrare, raggruppare e modificare la query delle serie temporali sottostante in diverse dimensioni o salvare visualizzazioni personalizzate in una dashboard personalizzata. |
| Visualizza a schermo intero | Nella barra degli strumenti del grafico, fai clic su Altre opzioni del grafico, quindi seleziona Visualizza a schermo intero per espandere il grafico in modo che riempia lo schermo per un'ispezione dettagliata dei dati delle serie temporali e della legenda. |
| Ispeziona i log correlati |
Puoi correlare i dati delle metriche con le voci di log scritte nello stesso periodo di tempo per risolvere i problemi relativi ad attività ed errori:
|
Metriche disponibili
La tabella seguente elenca tutte le metriche disponibili nella dashboard.
| Sezione | Nome metrica | Descrizione |
|---|---|---|
| Utenti attivi (adozione) | Un utente attivo è un utente unico che ha avviato almeno un'azione dello strumento per sviluppatori di AI (ad esempio una richiesta API, un prompt o l'esecuzione di uno strumento) durante il periodo di tempo del report. | |
| Utenti attivi orari (media) | Mostra il numero medio di utenti attivi unici all'ora nel periodo di tempo selezionato. | |
| Utenti attivi giornalieri (media) | Mostra il numero medio di utenti attivi unici al giorno nell'intervallo di tempo selezionato. | |
| Utenti attivi settimanali (media) | Mostra il numero medio di utenti attivi unici alla settimana nel periodo di tempo selezionato. | |
| Utenti attivi mensili (media) | Mostra il numero medio di utenti attivi unici al mese (utenti attivi per 28 giorni) nel periodo di tempo selezionato. | |
| Utenti attivi orari | Un grafico a linee di tendenza che mostra il numero di utenti attivi unici per ora nel periodo di tempo selezionato. | |
| Utenti attivi giornalieri | Un grafico a linee di tendenza che mostra il numero di utenti attivi unici per giorno nell'intervallo di tempo selezionato. | |
| Utenti attivi settimanali | Un grafico a linee di tendenza che mostra il numero di utenti attivi unici per settimana nell'intervallo di tempo selezionato. | |
| Utenti attivi mensili | Un grafico a linee di tendenza che mostra il numero di utenti attivi unici al mese (utenti attivi per 28 giorni) nell'intervallo di tempo selezionato. | |
| Strumenti e chiamate API | Token totali | Il numero totale di token di input e output combinati utilizzati dagli strumenti per sviluppatori AI nel periodo di tempo selezionato. |
| Utilizzo giornaliero dei token | Un grafico a linee che mostra il consumo giornaliero di token nel tempo. | |
| Chiamate API giornaliere |
Un grafico a linee che mostra il numero giornaliero di chiamate API effettuate dagli strumenti per sviluppatori AI, inclusa una suddivisione degli errori in base all'etichetta error_type (ad esempio, limiti di quota, errori di autenticazione o errori del client).
|
|
| Chiamate agli strumenti giornaliere | Un grafico a linee che mostra il numero giornaliero di chiamate allo strumento avviate dagli strumenti per sviluppatori di AI. | |
| Chiamate allo strumento giornaliere accettate | Un grafico a linee che mostra il numero giornaliero di suggerimenti di chiamate allo strumento proposti dall'agente che gli utenti hanno accettato ed eseguito. | |
Passaggi successivi
- Scopri di più sugli strumenti e sulle funzionalità disponibili nella panoramica degli strumenti per sviluppatori AI.
- Scopri come configurare le impostazioni degli strumenti per sviluppatori. Per saperne di più, consulta Configura le impostazioni degli strumenti per sviluppatori AI.
- Scopri come gestire l'accesso con i ruoli personalizzati. Per saperne di più, consulta Crea ruoli personalizzati per gli strumenti per sviluppatori AI.