Questo documento descrive come accedere alle metriche generate dall'app Gemini Enterprise. Queste metriche forniscono informazioni sul rendimento e sull'integrità dell'applicazione.
Puoi visualizzare la telemetria delle metriche utilizzando Esplora metriche o direttamente all'interno dei singoli agenti utilizzando la scheda Metriche dell'agente.
Concetti fondamentali
Questa sezione introduce i concetti chiave relativi all'osservabilità in Gemini Enterprise.
| Concetto | Descrizione |
|---|---|
| Metriche | Le metriche sono misurazioni numeriche che i sistemi raccolgono nel tempo. Queste misurazioni rappresentano le prestazioni, l'utilizzo delle risorse o il comportamento di un sistema. Gli ingegneri utilizzano le metriche per monitorare l'integrità del sistema, identificare le tendenze e attivare gli avvisi. |
Prima di iniziare
Assicurati di disporre di quanto segue:
Il ruolo Amministratore Gemini Enterprise o il ruolo Utente Gemini Enterprise della console Google Cloud .
Un'app web Gemini Enterprise esistente. Per informazioni sulla creazione di una nuova app, consulta Creare un'app.
Per accedere a Metrics Explorer, devi disporre del ruolo Visualizzatore Monitoring (
roles/monitoring.viewer).Nelle configurazioni dell'app Gemini Enterprise, abilita l'impostazione Abilita l'instrumentazione di tracce e log OpenTelemetry. Per ulteriori informazioni, vedi Gestire le impostazioni di osservabilità.
Accedere alle metriche in Metrics Explorer
Per accedere alle metriche, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Esplora metriche.
Seleziona il progetto Google Cloud in cui è stata creata l'app Gemini Enterprise.
Fai clic su Seleziona una metrica per aprire una barra di ricerca.
Nella barra di ricerca, cerca le seguenti metriche:
Nome metrica Descrizione Agente Gemini Enterprise - Numero di sessioni dell'agente Gemini Enterprise Il numero di sessioni gestite dall'agente Gemini Enterprise. Agente Gemini Enterprise - Numero di strumenti dell'agente Gemini Enterprise Il numero di volte in cui gli strumenti sono stati richiamati dall'agente Gemini Enterprise. Agente Gemini Enterprise - Conteggio turni dell'agente Gemini Enterprise Il numero di turni conversazionali all'interno delle sessioni dell'agente Gemini Enterprise. Agente Gemini Enterprise - Latenza totale dell'agente Gemini Enterprise La latenza totale delle risposte dell'agente Gemini Enterprise. Agente Gemini Enterprise - Latenza totale dello strumento dell'agente Gemini Enterprise La latenza totale generata dalle esecuzioni degli strumenti all'interno dell'agente Gemini Enterprise. Connettore dati Gemini Enterprise - Conteggio richieste del connettore dati Gemini Enterprise Il conteggio totale delle richieste effettuate ai connettori dati di Gemini Enterprise (chiamati anche datastore nella console Google Cloud ). Seleziona la metrica che vuoi esplorare e fai clic su Applica.
(Facoltativo) Imposta filtri per le etichette, elementi di aggregazione e regola l'intervallo di tempo.
Accedere alle metriche per gli agenti
Puoi anche visualizzare le dashboard delle metriche operative, specifiche degli strumenti e di sessione direttamente per i singoli agenti nella scheda Metriche dell'agente nella console Google Cloud .
Per accedere alle metriche di un agente:
- Nella console Google Cloud , vai alla tua app e poi fai clic su Agenti.
- Seleziona l'agente che vuoi esaminare, quindi fai clic sulla scheda Metriche.
La scheda Metriche fornisce la telemetria operativa chiave suddivisa in due visualizzazioni: Panoramica e Strumenti.
Metriche della panoramica
Questa visualizzazione fornisce una dashboard che riepiloga i dati standard su sessioni e stato dell'agente, tra cui:
- Sessioni: conteggio totale delle sessioni utente.
- Tempo medio per sessione: tempo medio trascorso durante una sessione.
- Chiamate all'agente: il numero totale di volte in cui è stato chiamato l'agente.
- Latenza dell'agente: latenza nel tempo e metriche specifiche.
- Traffico dell'agente: volume delle richieste in entrata.
- Percentuale di errori dell'agente: percentuale di chiamate all'agente non riuscite.
Metriche degli strumenti
Questa visualizzazione si concentra in modo specifico sull'utilizzo e sulla latenza degli strumenti connessi al tuo agente, tra cui:
- Chiamate totali: numero di richieste di esecuzione dello strumento.
- Durata P95 per strumento: la latenza del 95° percentile delle esecuzioni, suddivisa per strumento.
- Conteggio delle chiamate per strumento: il conteggio totale delle chiamate suddiviso tra i diversi strumenti.
- Percentuale di errori per strumento: il tasso di errori di esecuzione per strumento.
- Tariffa "Nessuno strumento chiamato": il tasso in base al quale le interazioni non hanno attivato l'esecuzione di alcun strumento.
Passaggi successivi
- Crea dashboard con le metriche di Gemini Enterprise. Per saperne di più, vedi Crea e gestisci dashboard personalizzate.
- Crea avvisi quando le metriche superano una soglia. Per saperne di più, consulta Crea policy di avviso basate su soglie metriche.
- Per disattivare il monitoraggio di Metrics Explorer, consulta Disattivare le impostazioni di osservabilità.