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

Gemini Enterprise fornisce Cloud Logging per consentire ai clienti di monitorare errori e avvisi durante il collegamento dei dati con Gemini Enterprise.

Questo documento descrive come accedere ai log degli errori del connettore federato e ai log degli errori del connettore 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 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

Prima di accedere ai log degli errori, assicurati di aver completato 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 Crea un'app.

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

• Attivato le impostazioni di osservabilità per visualizzare i log degli errori del connettore federato. Per ulteriori informazioni, vedi Attivare le impostazioni di osservabilità.

Accedere ai log degli errori del connettore federato

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, 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 a 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 posizione 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 superiori. Per saperne di più su come perfezionare le query, consulta Query di esempio.

Accedere 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 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 console Google Cloud , 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 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, trovi i dettagli in jsonPayload.message e jsonPayload.status.

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