Gestire le impostazioni di osservabilità

Questo documento descrive come configurare le impostazioni di osservabilità per l'app Gemini Enterprise utilizzando la console Google Cloud . Dopo aver attivato 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 durate 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 passa attraverso diversi servizi e componenti.

Ad esempio, una traccia rappresenta l'intero ciclo di vita di una richiesta. Ciò include una domanda posta da un utente all'assistente Gemini Enterprise, la risposta dell'assistente Gemini Enterprise e qualsiasi azione successiva attivata dalla risposta, ad esempio l'invio di un'email.
Intervallo Uno span è una singola unità di lavoro temporizzata all'interno di una traccia. Rappresenta un'operazione specifica, ad esempio una chiamata di funzione, una richiesta API o una query del database. Ogni intervallo include dettagli come l'ora di inizio e di fine, un ID univoco e la sua relazione con gli altri intervalli. Queste relazioni insieme formano una traccia.
Log degli span I log di intervallo sono messaggi o eventi in formato libero con timestamp associati a un intervallo specifico. Forniscono informazioni contestuali dettagliate sull'esecuzione di uno span, 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.
Log di controllo dell'utilizzo I log di controllo dell'utilizzo sono record delle attività amministrative e degli accessi all'interno delle tue risorse Google Cloud . Forniscono informazioni dettagliate su chi ha eseguito quale azione, quando e da dove. Questi log sono essenziali per l'audit della sicurezza, la conformità e la comprensione di come vengono utilizzate le tue risorse.
Log degli errori del connettore Gemini Enterprise I log degli errori del connettore Gemini Enterprise acquisiscono gli errori e gli esiti negativi riscontrati durante l'integrazione di Gemini Enterprise con origini dati di terze parti come Jira e Microsoft OneDrive. Questi log includono problemi di connessione, problemi di trasformazione dei dati ed errori dell'API.

Prima di iniziare

Assicurati di disporre di quanto segue:

Attivare le impostazioni di osservabilità

Per attivare l'osservabilità per l'app Gemini Enterprise, puoi utilizzare la consoleGoogle Cloud o l'API REST.

Console

Per attivare le impostazioni di osservabilità utilizzando la console Google Cloud , segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic sul nome dell'app che vuoi configurare.

  3. Fai clic su Configurazioni e poi sulla scheda Osservabilità.

  4. 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, log di intervallo e metriche associati ai tuoi log in Cloud Logging.
    Abilita il logging degli input dei prompt e degli output delle risposte Se abilitato, Cloud Logging registra i contenuti completi dei prompt e delle risposte degli utenti. Ciò include 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.

REST

Per configurare le impostazioni di osservabilità utilizzando l'API REST, consulta le seguenti sezioni:

Attivare l'osservabilità durante la creazione di un'app

Per creare una nuova app con l'osservabilità attivata, esegui questo comando:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines?engineId=APP_ID" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
  "displayName": "APP_DISPLAY_NAME",
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
    "searchTier": "SEARCH_TIER_ENTERPRISE",
    "searchAddOns": ["SEARCH_ADD_ON_LLM"],
    "requiredSubscriptionTier": "SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT"
  },
  "industryVertical": "GENERIC",
  "appType": "APP_TYPE_INTRANET",
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

Sostituisci quanto segue:

  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • PROJECT_ID: l'ID progetto.
  • LOCATION: la regione multipla del datastore: global, us o eu
  • APP_ID: l'ID dell'app che vuoi creare.
  • APP_DISPLAY_NAME: il nome visualizzato dell'app che vuoi creare.

Attivare l'osservabilità per un'app esistente

Per attivare l'osservabilità su un'app esistente, esegui questo comando:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

Sostituisci quanto segue:

  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • PROJECT_ID: l'ID progetto.
  • LOCATION: la regione multipla del datastore: global, us o eu
  • APP_ID: l'ID dell'app.

Disattivare le impostazioni di osservabilità

Per disattivare le impostazioni di osservabilità per l'app Gemini Enterprise, puoi utilizzare la console Google Cloud o l'API REST.

Console

Per disattivare le impostazioni di osservabilità utilizzando la console Google Cloud , segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic sul nome dell'app per cui vuoi disattivare le impostazioni di osservabilità.

  3. Fai clic su Configurazioni e poi sulla scheda Osservabilità.

  4. Puoi disattivare le seguenti impostazioni:

    Impostazione di osservabilità Descrizione
    Abilita l'instrumentazione di tracce e log OpenTelemetry Se disattivata, questa impostazione interrompe la raccolta di tracce, intervalli, log degli intervalli e metriche. Disattiva anche l'impostazione Abilita il logging degli input dei prompt e degli output delle risposte, il che significa che nessun log viene inviato a Cloud Logging.
    Abilita il logging degli input dei prompt e degli output delle risposte Se disattivato, Cloud Logging non registra gli input dei prompt e gli output delle risposte.

REST

Per disattivare le impostazioni di osservabilità utilizzando l'API REST, esegui questo comando:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": false,
    "sensitiveLoggingEnabled": false
  }
}'

Sostituisci quanto segue:

  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • PROJECT_ID: l'ID progetto.
  • LOCATION: la regione multipla del datastore: global, us o eu
  • APP_ID: l'ID dell'app.

Passaggi successivi