Questo documento descrive come accedere alle metriche generate dalla tua app Gemini Enterprise. Queste metriche forniscono informazioni sul rendimento e sull'integrità della tua applicazione.
Puoi visualizzare la telemetria delle metriche utilizzando Esplora metriche o direttamente all'interno dei singoli agenti utilizzando la scheda Osservabilità 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 il rendimento, 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. |
| Metriche con ambito dell'agente | Metriche che misurano l'attività di un singolo agente, ad esempio le sessioni, i turni di conversazione e le chiamate degli strumenti. Sono elencate sotto il tipo di risorsa Agente Gemini Enterprise e vengono raccolte solo quando l'impostazione di osservabilità Abilita l'instrumentazione di tracce e log OpenTelemetry è attivata per l'agente. |
| Metriche con ambito dell'app | Metriche che misurano tutto il traffico verso un'app anziché verso un singolo agente, ad esempio il conteggio delle richieste e la latenza end-to-end. Sono elencate nel tipo di risorsa Motore Gemini Enterprise , dove Motore è il nome API di un'app Gemini Enterprise e vengono raccolte indipendentemente dalle impostazioni di osservabilità. |
Prima di iniziare
Assicurati di avere quanto segue:
Il ruolo Amministratore Gemini Enterprise o il ruolo Utente Gemini Enterprise della Google Cloud console.
Un'app web Gemini Enterprise esistente. Per informazioni sulla creazione di una nuova app, vedi Creare un'app.
Per accedere a Metrics Explorer, devi disporre del ruolo Monitoring Viewer (
roles/monitoring.viewer).Abilita l'impostazione di osservabilità Abilita l'instrumentazione di tracce e log OpenTelemetry. A seconda del tipo di agente, abilita questa impostazione nelle configurazioni a livello di app (per l'agente Core Assistant ) o nella scheda Configurazione dell'agente (per gli agenti creati dai dipendenti di Agent Designer e gli agenti di ricerca approfondita). Per saperne di più, consulta Gestire le impostazioni di osservabilità. Questa impostazione è obbligatoria per le metriche con ambito dell'agente. Le metriche con ambito dell'app, elencate nel tipo di risorsa Motore Gemini Enterprise, vengono raccolte senza questa impostazione.
Conservazione dei dati
Le metriche generate dalla tua app Gemini Enterprise vengono archiviate in
Cloud Monitoring nel tuo Google Cloud progetto e la loro conservazione è regolata
da Cloud Monitoring. Le metriche di Gemini Enterprise vengono pubblicate con il
discoveryengine.googleapis.com/ prefisso, che rientra nel livello "tutte le altre
Google Cloud metriche" e viene conservato per 6 settimane per impostazione predefinita. I dati precedenti al periodo di conservazione vengono eliminati automaticamente. Per i valori di conservazione autorevoli
e più recenti, consulta
Conservazione dei dati nella
documentazione Quote e limiti di Cloud Monitoring.
Accedere alle metriche in Metrics Explorer
Per accedere alle metriche:
Nella Google Cloud console, vai alla pagina Esplora metriche.
Seleziona il Google Cloud progetto 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 - Conteggio sessioni agente Gemini Enterprise Il numero di sessioni gestite dall'agente Gemini Enterprise. Agente Gemini Enterprise - Conteggio strumenti agente Gemini Enterprise Il numero di volte in cui gli strumenti sono stati chiamati dall'agente Gemini Enterprise. Agente Gemini Enterprise - Conteggio turni agente Gemini Enterprise Il numero di turni di conversazione all'interno delle sessioni dell'agente Gemini Enterprise. Agente Gemini Enterprise - Latenza totale agente Gemini Enterprise La latenza totale delle risposte dell'agente Gemini Enterprise. Agente Gemini Enterprise - Latenza totale strumenti agente Gemini Enterprise La latenza totale generata dalle esecuzioni degli strumenti all'interno del l'agente Gemini Enterprise. Connettore dati Gemini Enterprise - Connettore dati Gemini Enterprise Conteggio richieste Il conteggio totale delle richieste effettuate ai connettori dati Gemini Enterprise (chiamati anche datastore nella Google Cloud console). Connettore dati Gemini Enterprise - Connettore dati Gemini Enterprise Latenze richieste (Beta) La latenza in millisecondi delle richieste effettuate ai connettori dati Gemini Enterprise (chiamati anche datastore nella Google Cloud console). Motore Gemini Enterprise - Conteggio richieste motore Gemini Enterprise Il numero totale di richieste ricevute dalla tua app Gemini Enterprise, per tutto il traffico verso l'app anziché verso un singolo agente. Suddivise per metodo API, codice di risposta gRPC codice di risposta, classe di codice di risposta, tipo di query e modello. Motore Gemini Enterprise - Latenza totale richieste motore Gemini Enterprise La distribuzione della latenza delle richieste end-to-end per la tua app Gemini Enterprise. Registrata per ogni richiesta, incluse quelle che restituiscono un errore. Motore Gemini Enterprise - Latenza al primo token di risposta motore Gemini Enterprise La distribuzione della latenza tra la ricezione di una richiesta e lo streaming del primo token di risposta. Registrata solo per le richieste che producono almeno un token di risposta. Motore Gemini Enterprise - Latenza al primo token motore Gemini Enterprise La distribuzione della latenza tra la ricezione di una richiesta e lo streaming del primo token, indipendentemente dal fatto che il token faccia parte del processo di pensiero del modello o di una risposta finale. Registrata solo per richieste che producono almeno un token trasmesso. Seleziona la metrica che vuoi esplorare e fai clic su Applica.
Facoltativamente, imposta filtri di etichette aggiuntivi, elementi di aggregazione e regola l'intervallo di tempo.
Accedere alle metriche degli agenti
Puoi anche visualizzare le dashboard delle metriche operative, specifiche per gli strumenti e delle sessioni direttamente per i singoli agenti nella scheda Osservabilità dell'agente nella Google Cloud console.
Per accedere alle metriche di un agente:
- Nella Google Cloud console, vai all'app e fai clic su Agenti.
- Seleziona l'agente che vuoi esaminare e fai clic sulla scheda Osservabilità.
La scheda Osservabilità 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 di sessione e di integrità dell'agente, tra cui:
- Sessioni: conteggio totale delle sessioni utente.
- Tempo medio per sessione: tempo medio trascorso durante una sessione.
- Chiamate dell'agente: 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 dell'agente non riuscite.
Metriche degli strumenti
Questa visualizzazione si concentra in modo specifico sull'utilizzo e sulla latenza degli strumenti connessi all'agente, tra cui:
- Chiamate totali: numero di richieste di esecuzione degli strumenti.
- Durata P95 per strumento: la latenza del 95° percentile delle esecuzioni, suddivisa per strumento.
- Conteggio delle chiamate per strumento: conteggio totale delle chiamate suddiviso tra i diversi strumenti.
- Percentuale di errori per strumento: la percentuale di errori delle esecuzioni per strumento.
- Tariffa "Nessuno strumento chiamato": la frequenza con cui le interazioni non hanno attivato l'esecuzione di alcuno strumento.
Passaggi successivi
- Crea dashboard con le metriche di Gemini Enterprise. Per saperne di più, consulta Creare e gestire dashboard personalizzate.
- Crea avvisi quando le metriche superano una soglia. Per saperne di più, consulta Creare policy di avviso basate su soglie metriche.
- Per disattivare il monitoraggio di Metrics Explorer, consulta Disattivare le impostazioni di osservabilità.