Metriche di accesso

Questo documento descrive come accedere alle metriche generate dalla tua app Gemini Enterprise. Queste metriche forniscono insight sulle prestazioni 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 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.
Metriche con ambito agente	Metriche che misurano l'attività di un singolo agente, ad esempio le sue sessioni, i turni di conversazione e le chiamate degli strumenti. Sono elencate nel tipo di risorsa Gemini Enterprise Agent e vengono raccolte solo quando l'impostazione di osservabilità Abilita l'instrumentazione di tracce e log OpenTelemetry è attiva per l'agente.
Metriche con ambito 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 elencati nel tipo di risorsa Gemini Enterprise Engine, dove Engine è il nome dell'API per un'app Gemini Enterprise, e vengono raccolti indipendentemente dalle impostazioni di osservabilità.

Prima di iniziare

Assicurati di disporre di quanto segue:

• Il ruolo Gemini Enterprise Admin o il ruolo Gemini Enterprise User della console Google Cloud .

• Un'app web Gemini Enterprise esistente. Per informazioni sulla creazione di una nuova app, consulta Crea un'app.

• Per accedere a Metrics Explorer, devi disporre del ruolo Visualizzatore Monitoring (roles/monitoring.viewer).

• Attiva l'impostazione di osservabilità Abilita l'instrumentazione di tracce e log OpenTelemetry. A seconda del tipo di agente, attiva questa opzione nelle configurazioni a livello di app (per l'agente Core Assistant) o nella scheda Configurazione dell'agente (per gli agenti creati dai dipendenti con Workflow Builder e gli agenti Deep Research). Per saperne di più, consulta Gestisci le impostazioni di osservabilità. Questa impostazione è obbligatoria per le metriche con ambito agente. Le metriche con ambito app, elencate nel tipo di risorsa Gemini Enterprise Engine, vengono raccolte senza.

Conservazione dei dati

Le metriche generate dalla tua app Gemini Enterprise vengono archiviate in Cloud Monitoring nel tuo progetto Google Cloud e la loro conservazione è regolata da Cloud Monitoring. Le metriche di Gemini Enterprise vengono pubblicate con il prefisso discoveryengine.googleapis.com/, che rientra nel livello "tutte le altre metricheGoogle Cloud " e viene conservato per 6 settimane per impostazione predefinita. I dati precedenti al periodo di conservazione vengono eliminati automaticamente. Per i valori di conservazione più autorevoli e aggiornati, consulta Conservazione dei dati nella documentazione Quote e limiti di Cloud Monitoring.

Accedi alle metriche in Metrics Explorer

Per accedere alle metriche, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Esplora metriche.

   Vai a Esplora metriche

2. Seleziona il progetto Google Cloud in cui è stata creata l'app Gemini Enterprise.

3. Fai clic su Seleziona una metrica per aprire una barra di ricerca.

4. Nella barra di ricerca, cerca le seguenti metriche:

   Nota: i dati delle metriche vengono aggiornati ogni minuto. I nomi delle metriche sono preceduti dalla risorsa a cui sono associate. La tua app è rappresentata dal tipo di risorsa Gemini Enterprise Engine, che è il nome dell'API per un'app Gemini Enterprise.

   Nome metrica	Descrizione
   Gemini Enterprise Agent - Gemini Enterprise Agent Session Count	Il numero di sessioni gestite dall'agente Gemini Enterprise.
   Gemini Enterprise Agent - Gemini Enterprise Agent Tool Count	Il numero di volte in cui gli strumenti sono stati richiamati dall'agente Gemini Enterprise.
   Gemini Enterprise Agent - Gemini Enterprise Agent Turn Count	Il numero di turni di conversazione all'interno delle sessioni di Gemini Enterprise Agent.
   Gemini Enterprise Agent - Latenza totale dell'agente Gemini Enterprise	La latenza totale delle risposte dell'agente Gemini Enterprise.
   Gemini Enterprise Agent - Gemini Enterprise Agent Tool Total Latency	La latenza totale generata dalle esecuzioni degli strumenti all'interno dell'agente Gemini Enterprise.
   Connettore dati Gemini Enterprise - Conteggio delle richieste del connettore dati Gemini Enterprise	Il numero totale di richieste effettuate ai connettori dati di Gemini Enterprise (noti anche come datastore nella console Google Cloud ).
   Gemini Enterprise DataConnector - Latenze delle richieste di Gemini Enterprise DataConnector	(Beta) La latenza delle richieste effettuate ai connettori dati di Gemini Enterprise (noti anche come datastore nella console Google Cloud ) in millisecondi.
   Motore Gemini Enterprise - Conteggio delle richieste del motore Gemini Enterprise	Il numero totale di richieste ricevute dalla tua app Gemini Enterprise, in tutto il traffico verso l'app, anziché da un singolo agente. Suddivise per metodo API, codice di risposta gRPC canonico, classe del codice di risposta, tipo di query e modello.
   Gemini Enterprise Engine - Latenza totale delle richieste di Gemini Enterprise Engine	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.
   Gemini Enterprise Engine - Latenza del tempo di risposta iniziale del motore Gemini Enterprise	La distribuzione della latenza tra la ricezione di una richiesta e lo streaming del primo token di risposta. Registrato solo per le richieste che producono almeno un token di risposta.
   Gemini Enterprise Engine - Latenza del tempo di risposta del primo token del 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 ragionamento del modello o di una risposta finale. Registrato solo per le richieste che producono almeno un token in streaming.

5. Seleziona la metrica che vuoi esplorare e fai clic su Applica.

6. Facoltativamente, imposta filtri aggiuntivi per le etichette, elementi di aggregazione e regola l'intervallo di tempo.

   Nota: per ulteriori informazioni sull'utilizzo di Metrics Explorer, consulta Crea grafici con Esplora metriche.

   

Accedi alle metriche per gli agenti

Puoi anche visualizzare le dashboard delle metriche operative, specifiche degli strumenti e delle sessioni direttamente per i singoli agenti nella scheda Osservabilità dell'agente nella console Google Cloud .

Nota: la scheda Osservabilità è disponibile per l'agente Core Assistant, gli agenti Workflow Builder e gli agenti Deep Research.

Per accedere alle metriche di un agente:

1. Nella console Google Cloud , vai alla tua app e fai clic su Agenti.
2. Seleziona l'agente che vuoi ispezionare, quindi fai clic sulla scheda Osservabilità.

La scheda Osservabilità fornisce dati di telemetria operativi chiave suddivisi in quattro visualizzazioni: Panoramica, Strumenti, Latenza e Tasso di errore.

Metriche della panoramica

Questa visualizzazione fornisce una dashboard che riassume i dati standard sullo stato della sessione e dell'agente, tra cui:

• Sessioni: numero totale di sessioni utente.
• Tempo medio per sessione: tempo medio trascorso durante una sessione.
• Chiamate all'agente: il numero totale di volte in cui l'agente è stato chiamato.
• 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 particolare sull'utilizzo e sulla latenza degli strumenti collegati all'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 numero totale di chiamate suddiviso tra i diversi strumenti.
• Percentuale di errori per strumento: la percentuale di errori delle esecuzioni per strumento.
• Tariffa "Nessuna chiamata allo strumento": la frequenza con cui le interazioni non hanno attivato l'esecuzione di alcuno strumento.

Metriche di latenza

Questa visualizzazione mostra la latenza di risposta dell'agente. Ogni metrica viene visualizzata come scheda riepilogativa p50 e p95 per l'intervallo di tempo selezionato e come grafico delle serie temporali che mostra le tendenze nel tempo. Puoi anche filtrare le metriche di latenza per funzionalità. La visualizzazione mostra le seguenti metriche:

• Tempo al primo token (TTFT): la latenza tra la ricezione di una richiesta e lo streaming del primo token, indipendentemente dal fatto che questo token faccia parte del processo di pensiero del modello o della risposta.
• Tempo alla prima risposta (TTFA): la latenza tra la ricezione di una richiesta e lo streaming del primo token di risposta, ovvero il primo token che non fa parte del ragionamento del modello. Se l'agente chiama uno strumento dopo aver iniziato a rispondere, la misurazione viene riavviata, quindi il TTFA riflette il momento in cui è iniziato lo streaming della risposta letta dall'utente, non la narrazione provvisoria.
• Tempo all'ultimo token (TTLT): la latenza tra la ricezione di una richiesta e lo streaming dell'ultimo token, ovvero quando la risposta è completa.

Filtra le metriche di latenza per funzionalità

Una funzionalità è il tipo di interazione rappresentato da un turno, ad esempio una ricerca web o la generazione di un'immagine. Filtra le metriche di latenza in base alla funzionalità per vedere quali tipi di interazione sono più lenti e per evitare che una funzionalità lenta influisca sulla latenza complessiva.

Per filtrare le metriche di latenza in base alla funzionalità:

1. Nella scheda Osservabilità dell'agente, fai clic sulla visualizzazione Latenza.
2. Fai clic su Filtra per funzionalità.
3. Seleziona la caratteristica che vuoi ispezionare.

Le schede riepilogative e i grafici delle serie temporali mostrano quindi solo i turni per quella funzionalità.

Per confrontare tutte le funzionalità contemporaneamente, utilizza la tabella Telemetria delle funzionalità, che elenca quanto segue per ogni funzionalità:

• Quota di traffico: la percentuale di turni attribuita alla funzionalità.
• TTFT, TTFA e TTLT: la latenza p50 e p95 per la funzionalità.

Puoi filtrare i dati utilizzando le seguenti funzionalità:

• Parametriche: interazioni che inviano richieste al modello solo per l'output di testo, senza strumenti, ad esempio attività di traduzione.
• Generazione di contenuti multimediali: attività di generazione di immagini e video.
• Solo ricerca web: interazioni che inviano richieste al modello utilizzando lo strumento di ricerca web.
• Analisi del file caricato: interazioni che inviano richieste al modello insieme ai file caricati dall'utente.
• Connettore: query che inviano richieste a connettori interni o di terze parti.
• Canvas: attività di generazione che utilizzano Canvas.
• Skill: interazioni che richiamano una skill.
• Altro: una categoria generica per le svolte che riguardano più funzionalità o che non sono ancora state classificate.

Metriche del tasso di errore

Questa visualizzazione mostra come vengono risolte le richieste dell'agente, raggruppate per classe di risposta: OK (2xx), Errori client (4xx), Errori del server (5xx) e Annullate. Comprende:

• Volume delle richieste per classe di risposta: numero di richieste in entrata nel tempo, impilate per classe di risposta.
• Tasso di errori per classe di risposta: la percentuale di richieste non riuscite nel tempo, suddivisa per classe di risposta.
• Codici di errore del client (4xx) e Codici di errore del server (5xx): i singoli codici di risposta gRPC canonici nel tempo, ad esempio INVALID_ARGUMENT o INTERNAL, in modo da poter identificare gli errori specifici che causano un picco.
• Totali: il numero di richieste e la percentuale di richieste totali per ogni risultato nell'intervallo di tempo selezionato, con tabelle separate che classificano i singoli codici di errore del client e del server.

Passaggi successivi

• Crea dashboard con le metriche di Gemini Enterprise. Per saperne di più, consulta 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 Disattiva le impostazioni di osservabilità.