Accedere ai log degli errori del connettore Gemini Enterprise con Cloud Logging

Gemini Enterprise fornisce Cloud Logging ai clienti per monitorare errori e avvisi quando collegano i propri dati a Gemini Enterprise.

Questo documento descrive come accedere ai log degli errori dei connettori federati e dei connettori di importazione per Gemini Enterprise utilizzando Cloud Logging.

Concetti fondamentali

Questa sezione introduce i concetti chiave relativi all'osservabilità in Gemini Enterprise.

Concetto	Descrizione
Log degli errori dei connettori Gemini Enterprise	I log degli errori dei connettori Gemini Enterprise acquisiscono gli errori e i guasti 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 API.

Prima di iniziare

Prima di accedere ai log degli errori, assicurati di aver eseguito le seguenti operazioni:

• Per attivare la registrazione, devi disporre del ruolo IAM Amministratore Gemini Enterprise (roles/discoveryengine.agentspaceAdmin).

• Per accedere a Cloud Logging, devi disporre del ruolo IAM Visualizzatore log (roles/logging.viewer).

• Hai creato un'app Gemini Enterprise. Per crearne una, consulta Creare un'app.

• Assicurati che i datastore siano configurati correttamente e attivi. Per ulteriori informazioni sulla configurazione dei datastore, consulta Connettere un'origine dati Google o Connettere un'origine dati di terze parti.

• Hai attivato le impostazioni di osservabilità per visualizzare i log degli errori dei connettori federati. Per ulteriori informazioni, consulta Attivare le impostazioni di osservabilità.

Accedere ai log degli errori dei connettori federati

Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine motore nel contesto delle API. Un motore Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su APP_TYPE_INTRANET.

Per visualizzare i log degli errori dei datastore che si connettono a Gemini Enterprise utilizzando la federazione dei dati:

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

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Seleziona un datastore a tua scelta.

4. Fai clic su Visualizza log. Viene visualizzata la pagina Esplora log.

5. Per visualizzare solo i log dei connettori Gemini Enterprise, inserisci la seguente query nel campo dell'editor di query e fai clic su Esegui query:

    logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fconnector_activity"
    jsonPayload.LogMetadata.name="projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   • LOCATION: la località del connettore. Ad esempio, global.
   • COLLECTION_ID: l'ID della raccolta che contiene il connettore, che è anche l'ID del datastore nella Google Cloud console.

6. Perfeziona l'ambito della query utilizzando un filtro. Ad esempio, fai clic su Tutte le gravità e seleziona Errore e livelli superiori. Per ulteriori informazioni su come perfezionare le query, consulta Query di esempio.

Accedere ai log degli errori dei connettori di importazione

Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine motore nel contesto delle API. Un motore Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su APP_TYPE_INTRANET.

Per visualizzare i log degli errori dei datastore che si connettono a Gemini Enterprise utilizzando importazione dati, segui questi passaggi:

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

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Seleziona un datastore a tua scelta.

4. Fai clic su Visualizza log. Viene visualizzata la pagina Esplora log.

5. Per impostazione predefinita, la pagina Esplora log cerca le voci di log nelle risorse elencate nell' ambito di log predefinito. Per filtrare i log di Gemini Enterprise, esegui una delle seguenti operazioni:

   • Seleziona Tutte le risorse > API utilizzata > API Discovery Engine e poi fai clic su Applica.

   • Inserisci quanto segue nella barra delle query e fai clic su Esegui query:

     resource.type="consumed_api"
     resource.labels.service="discoveryengine.googleapis.com"
     

6. Perfeziona l'ambito della query filtrando i metadati JSON. Ad esempio, per eseguire una query sui log del metodo ImportDocuments, esegui una delle seguenti operazioni:

   • Inserisci quanto segue nella barra delle query:

     jsonPayload.context.reportLocation.functionName=~"ImportDocuments"
     

   • Espandi i metadati JSON e fai clic per filtrare:

     

     Figura 1. Filtra facendo clic sui metadati JSON

7. Per la maggior parte degli avvisi e degli errori, trova i dettagli in jsonPayload.message e jsonPayload.status.

8. Per un'analisi più approfondita dei log, scarica i log in un sink di log come BigQuery. Per informazioni, consulta Instrada i log verso destinazioni supportate nella documentazione di Google Cloud Observability.