Questo documento descrive come accedere e visualizzare le tracce e gli intervalli generati dall'app Gemini Enterprise. Le tracce e gli intervalli forniscono informazioni dettagliate sul rendimento e sul flusso di esecuzione delle richieste all'interno dell'applicazione, ad esempio quando si utilizza l'assistente o gli agenti.
Puoi visualizzare i dati delle tracce utilizzando Esplora tracce o direttamente all'interno dei singoli agenti utilizzando la scheda Tracce dell'agente.
Concetti fondamentali
Questa sezione introduce i concetti chiave relativi all'osservabilità in Gemini Enterprise.
| Concetto | Descrizione |
|---|---|
| Trace |
Una traccia è una raccolta di intervalli che rappresenta una singola richiesta o
transazione mentre scorre attraverso diversi servizi e componenti.
Ad esempio, una traccia rappresenta l'intero ciclo di vita di una richiesta. Ciò include un utente che pone una domanda all'assistente Gemini Enterprise, l'assistente Gemini Enterprise che risponde, e qualsiasi azione successiva attivata dalla risposta, ad esempio l'invio di un'email. |
| Intervallo | Un intervallo è una singola unità di lavoro temporizzata all'interno di una traccia. Rappresenta un' operazione specifica, come una chiamata di funzione, una richiesta API o una query di database. Ogni intervallo include dettagli come l'ora di inizio e di fine, un ID univoco e la sua relazione con altri intervalli. Queste relazioni insieme formano una traccia. |
| Log degli intervalli | I log degli intervalli sono messaggi o eventi in formato libero con timestamp associati a un intervallo specifico. Forniscono informazioni dettagliate e contestuali sull'esecuzione di un intervallo, aiutando gli utenti a eseguire il debug dei problemi e a comprendere il flusso di una richiesta. |
Prima di iniziare
Assicurati di avere:
Il ruolo di amministratore di Gemini Enterprise o il ruolo di utente di Gemini Enterprise nella console. Google Cloud
Un'app web Gemini Enterprise esistente. Per informazioni sulla creazione di una nuova app, vedi Creare un'app.
Per accedere alle tracce, devi avere il ruolo di utente di Cloud Trace (
roles/cloudtrace.user).Abilita l'impostazione di osservabilità Abilita l'instrumentazione di tracce e log OpenTelemetry. A seconda del tipo di agente, puoi abilitarla nelle configurazioni a livello di app (per l'agente Core Assistant) o all'interno della scheda Configurazione dell'agente (per gli agenti creati dai dipendenti di Agent Designer e gli agenti Deep Research). Per ulteriori informazioni, vedi Gestire le impostazioni di osservabilità.
Conservazione dei dati
Le tracce e gli intervalli generati dall'app Gemini Enterprise vengono archiviati in Cloud Trace nel tuo Google Cloud progetto e la loro conservazione è regolata da Cloud Trace. Per impostazione predefinita, Cloud Trace conserva i dati degli intervalli per 30 giorni; i dati precedenti al periodo di conservazione vengono eliminati automaticamente. Per i valori di conservazione autorevoli e più recenti, consulta Periodi di conservazione di Cloud Trace nella documentazione relativa a quote e limiti di Cloud Trace.
Accedere alle tracce in Esplora tracce
Per accedere alle tracce e agli intervalli utilizzando Esplora tracce:
Nella Google Cloud console, vai alla pagina Esplora tracce.
Seleziona il Google Cloud progetto in cui è stata creata l'app Gemini Enterprise. Vengono visualizzati tutti gli intervalli del progetto.
Nella tabella, fai clic su un ID intervallo per visualizzare i dettagli della traccia, inclusa la durata dell'intervallo e altri attributi.
Accedere alle tracce per gli agenti
Puoi anche visualizzare gli intervalli di traccia direttamente per i singoli agenti nella scheda Tracce dell'agente, che mostra un riepilogo cronologico dettagliato dei record di traccia degli intervalli e delle strutture di esecuzione padre-figlio.
Per accedere alle tracce di un agente:
- Nella Google Cloud console, vai all'app, quindi fai clic su Agenti.
- Seleziona l'agente che vuoi esaminare, quindi fai clic sulla scheda Tracce.
Tabella di riepilogo delle Trace
La tabella principale nella scheda Tracce mostra le seguenti informazioni per ogni intervallo di traccia:
- Stato: lo stato attuale della traccia (al momento viene visualizzato Non impostato).
- ID intervallo di traccia: l'identificatore univoco dell'intervallo di traccia. Fai clic sul link dell'ID intervallo per visualizzarne i dettagli.
- Nome intervallo: una breve descrizione del lavoro svolto dall'intervallo.
- Tipo di intervallo: il tipo di intervallo. Le opzioni includono:
Agent to Tool: una chiamata dall'agente a uno strumento esterno.Invoke Agent: una chiamata di un agente.Agent to Model: una richiesta dell'agente a un modello linguistico di grandi dimensioni.
- Durata: il tempo impiegato per completare l'intervallo di traccia (in minuti).
- Input: i dati di input o il messaggio inviato all'intervallo, se presenti.
- Output: il risultato di output restituito dall'intervallo, se presente.
- Ora di inizio: il timestamp esatto in cui è iniziata l'esecuzione dell'intervallo.
Visualizzazione dettagliata delle tracce
Se fai clic su un ID intervallo di traccia , si apre una pagina dettagliata con:
- Riepilogo: visualizza i metadati di base, tra cui Ora di inizio, Durata e il numero totale di Intervalli. Puoi fare clic su Visualizza in Cloud Trace o passare dai pulsanti di visualizzazione Grafico e Sequenza temporale.
- Visualizzazioni: passa da una gerarchia grafica a una visualizzazione cronologica che mostra le relazioni padre-figlio di tutti gli span di traccia.
- Dettagli intervallo selezionato: seleziona un singolo intervallo per visualizzare le sezioni dettagliate, che possono includere:
- Riepilogo: mostra il nome dell'intervallo, il servizio di destinazione, il conteggio degli intervalli totali con questa azione e la durata totale (in secondi).
- Log: visualizza i dettagli degli eventi pertinenti, se configurati. Fai clic su Visualizza log per passare direttamente ai log standard.
- Valutazione: mostra eventuali risultati di valutazione, se configurati.
- Input e output: payload completi di richiesta e risposta.
- Log ed eventi: elenco degli eventi che si sono verificati durante l'esecuzione di questo intervallo.
- Stacktrace: dettagli dell'errore se l'esecuzione di un intervallo non riesce.
- Metadati e link: link che fanno riferimento alle entità di Cloud Explorer correlate.
- Attributi: tag delle risorse e parametri di osservabilità aggiuntivi in coppia chiave-valore.
