Questo documento descrive come configurare le impostazioni di osservabilità per l'app Gemini Enterprise utilizzando la Google Cloud console. Dopo aver abilitato le impostazioni, puoi visualizzare i seguenti dati delle tue interazioni con l'assistente nell'app web Gemini Enterprise:
- Visualizza le metriche in Metrics Explorer.
- Visualizza tracce e span in Esplora tracce.
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 formano insieme 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 contestuali dettagliate sull'esecuzione di un intervallo, aiutando gli utenti a eseguire il debug dei problemi e a comprendere il flusso di una richiesta. |
| 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 avere:
Il ruolo di amministratore di Discovery Engine.
Un'app web Gemini Enterprise esistente. Per informazioni sulla creazione di una nuova app, vedi Creare un'app.
Configurare le impostazioni di osservabilità
Per configurare le impostazioni di osservabilità:
Nella Google Cloud console, vai alla pagina Gemini Enterprise.
Fai clic sul nome dell'app che vuoi configurare.
Fai clic su Configurazioni e poi sulla scheda Osservabilità.
Puoi attivare o disattivare le seguenti impostazioni:
Impostazione di osservabilità Descrizione Abilita l'instrumentazione di tracce e log OpenTelemetry Se questa opzione è abilitata, puoi visualizzare tracce, intervalli e metriche associati a i log in Cloud Logging. Abilita il logging degli input dei prompt e degli output delle risposte Se questa opzione è abilitata, Cloud Logging registra i contenuti completi dei prompt e delle risposte degli utenti come parte dei log degli intervalli. Sono inclusi dati sensibili o informazioni che consentono l'identificazione personale (PII). Per abilitare questa impostazione, devi prima abilitare Abilita l'instrumentazione di tracce e log OpenTelemetry.
Passaggi successivi
- Per scoprire di più su come accedere ai log di Gemini Enterprise, vedi Configurare il logging di audit dell'utilizzo per Gemini Enterprise.
- Per scoprire di più su come accedere ai dati di tracce e span di Gemini Enterprise, vedi Accedere a tracce e span in Esplora tracce.
- Per scoprire di più su come accedere alle metriche di Gemini Enterprise, vedi Accedere alle metriche in Esplora metriche.