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

Gemini Enterprise fornisce Cloud Logging ai clienti per monitorare errori e avvisi durante la connessione dei dati con 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 del connettore Gemini Enterprise	I log degli errori del connettore Gemini Enterprise acquisiscono gli errori e i problemi 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

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

• Per attivare il logging, devi disporre del ruolo IAM Gemini Enterprise Admin (roles/discoveryengine.agentspaceAdmin).

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

• Aver creato un'app Gemini Enterprise. Per crearne una, consulta Crea un'app.

• Assicurati che i datastore siano configurati correttamente e attivi. Per saperne di più sulla configurazione dei datastore, consulta Connetti un'origine dati Google o Connetti un'origine dati di terze parti.

• Attivato le impostazioni di osservabilità per visualizzare i log degli errori del connettore federato. Per saperne di più, consulta Attiva le impostazioni di osservabilità.

Accedi ai log degli errori del connettore federato

Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine engine nel contesto delle API. Un motore di 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, segui questi passaggi:

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

   Gemini Enterprise

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

3. Seleziona un datastore di tua scelta.

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

5. Per visualizzare solo i log del connettore 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 consoleGoogle Cloud .

6. Perfeziona l'ambito della query utilizzando un filtro. Ad esempio, fai clic su Tutte le gravità e seleziona Errore e superiore. Per saperne di più su come perfezionare le query, consulta Query di esempio.

Accedi ai log degli errori del connettore di importazione

Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine engine nel contesto delle API. Un motore di 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 console Google Cloud , vai alla pagina Gemini Enterprise.

   Gemini Enterprise

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

3. Seleziona un datastore di 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 dei log predefinito. Per filtrare i log di Gemini Enterprise, esegui una delle seguenti operazioni:

   • Seleziona Tutte le risorse > API utilizzata > API Discovery Engine, quindi 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 in base ai metadati JSON. Ad esempio, per eseguire 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, i dettagli sono disponibili in jsonPayload.message e jsonPayload.status.

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