Questo documento descrive come visualizzare le metriche di utilizzo e la telemetria per gli strumenti per sviluppatori AI in 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 Attivare gli strumenti per sviluppatori AI.
Account di fatturazione Cloud mensile non automatica: il progetto deve avere la fatturazione Cloud abilitata e un account mensile non automatica. Consulta Tipi di account di fatturazione Cloud.
Versioni supportate: gli utenti devono avere un abbonamento alla versione Gemini Enterprise Standard, Plus, Standard Emerging Market o con pagamento a consumo.
Ruoli richiesti: per accedere alla pagina Metriche degli strumenti per sviluppatori nella Google Cloud console, devi avere il ruolo Amministratore di Gemini Enterprise (
roles/discoveryengine.agentspaceAdmin).
Accedere alla dashboard delle metriche
Per visualizzare le metriche degli strumenti per sviluppatori AI nella Google Cloud console, procedi nel seguente modo:
Nella Google Cloud console, vai alla pagina Gemini Enterprise.
Seleziona il Google Cloud progetto 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 modificare l'intervallo 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 abilitato. 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,1d, o1w). - Seleziona un intervallo 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 fine per specificare una data e un'ora di inizio e fine personalizzate per la finestra di reporting.
- Fai clic su Intorno a un'ora per specificare una data e un'ora e visualizzare le metriche centrate 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 l'intervallo di tempo dei report indietro ( ) o in avanti () nel tempo in base alla durata selezionata nel menu. Ad esempio, se Ultimo giorno è selezionato, facendo clic sui grafici vengono spostati indietro di un giorno.Riduci lo zoom dell'intervallo di tempo Fai clic su per ridurre lo zoom di un intervico di tempo specifico. Tutti i grafici vengono aggiornati per mostrare i dati relativi all'intervallo di tempo con zoom ridotto Per aumentare lo zoom e reimpostare la visualizzazione, seleziona una durata dal menu del selettore dell'intervallo di tempo. Aggiornamento automatico Attiva o disattiva l'aggiornamento automatico in tempo reale dei dati della dashboard quando visualizzi un intervallo di tempo relativo. Quando viene selezionato un intervallo di tempo assoluto (ad esempio, orari di inizio e fine personalizzati o una finestra cronologica), l'aggiornamento automatico è disabilitato perché l'aggiornamento automatico non è supportato per gli intervalli di tempo assoluti. -
Digita una durata personalizzata direttamente nel
campo del filtro Tempo relativo (ad esempio,
Esplorare i dati dei grafici
Ogni grafico nella dashboard Metriche degli strumenti per sviluppatori fornisce controlli interattivi per aiutarti a esaminare le serie temporali, correlare le metriche con i log e analizzare i dati sottostanti:
| Controllo | Descrizione |
|---|---|
| Informazioni | Accanto al titolo del grafico, fai clic su Informazioni per visualizzare i dettagli sui filtri, i raggruppamenti e le proprietà di aggregazione applicate alla query della metrica del grafico. |
| Crea criterio di avviso | Nei grafici a linee delle metriche, fai clic su Crea criterio di avviso in nella barra degli strumenti del grafico per aprire il flusso di lavoro di avviso in Cloud Monitoring precompilato con la query della serie temporale 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 i dati per aprire la query della metrica in Esplora metriche. In Esplora metriche, puoi esaminare, filtrare, raggruppare e modificare la query della serie temporale sottostante in base a diverse dimensioni oppure salvare le visualizzazioni personalizzate in una dashboard personalizzata. |
| Visualizza a schermo intero | Nella barra degli strumenti del grafico, fai clic su Altre opzioni del grafico e poi seleziona Visualizza a schermo intero per espandere il grafico in modo che occupi l'intero schermo per un'ispezione dettagliata delle serie temporali e dei dati della legenda. |
| Ispeziona i log correlati |
Puoi correlare i dati delle metriche con le voci di log scritte nello stesso intervallo di tempo per risolvere i problemi relativi ad attività ed errori:
|
Metriche disponibili
La seguente tabella 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 AI (ad esempio una richiesta API, un prompt o l'esecuzione di uno strumento) durante l'intervallo di tempo dei report. | |
| Utenti attivi orari (media) | Mostra il numero medio di utenti attivi unici all'ora nell'intervallo 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 nell'intervallo di tempo selezionato. | |
| Utenti attivi mensili (media) | Mostra il numero medio di utenti attivi unici al mese (utenti attivi in 28 giorni) nell'intervallo di tempo selezionato. | |
| Utenti attivi orari | Un grafico a linee di tendenza che mostra il numero di utenti attivi unici all'ora nell'intervallo di tempo selezionato. | |
| Utenti attivi giornalieri | Un grafico a linee di tendenza che mostra il numero di utenti attivi unici al giorno nell'intervallo di tempo selezionato. | |
| Utenti attivi settimanali | Un grafico a linee di tendenza che mostra il numero di utenti attivi unici alla 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 in 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 nell'intervallo 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 conteggio giornaliero delle 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 giornaliere degli strumenti | Un grafico a linee che mostra il conteggio giornaliero delle chiamate degli strumenti avviate dagli strumenti per sviluppatori AI. | |
| Chiamate giornaliere degli strumenti accettate | Un grafico a linee che mostra il conteggio giornaliero dei suggerimenti di chiamata degli strumenti proposti dall'agente che gli utenti hanno accettato ed eseguito. | |
Limitazioni
Alle metriche degli strumenti per sviluppatori AI si applicano le seguenti limitazioni:
- Le metriche Chiamate giornaliere degli strumenti e Chiamate giornaliere degli strumenti accettate non mostrano i dati.
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 ulteriori informazioni, consulta Configurare le impostazioni degli strumenti per sviluppatori AI.
- Scopri come gestire l'accesso con i ruoli personalizzati. Per ulteriori informazioni, consulta Creare ruoli personalizzati per gli strumenti per sviluppatori AI.