Mit Cloud Logging auf Fehlerlogs für Gemini Enterprise-Connectors zugreifen

Gemini Enterprise bietet Cloud Logging, damit Kunden Fehler und Warnungen beim Verbinden ihrer Daten mit Gemini Enterprise überwachen können.

In diesem Dokument wird beschrieben, wie Sie mit Cloud Logging auf Fehlerlogs für föderierte Connectors und Fehlerlogs für Ingestion-Connectors für Gemini Enterprise zugreifen.

Wichtige Konzepte

In diesem Abschnitt werden wichtige Konzepte im Zusammenhang mit der Beobachtbarkeit in Gemini Enterprise vorgestellt.

Konzept	Beschreibung
Fehlerlogs für Gemini Enterprise-Connectors	In den Fehlerlogs für Gemini Enterprise-Connectors werden Fehler und Ausfälle erfasst, die bei der Einbindung von Gemini Enterprise in Datenquellen von Drittanbietern wie Jira und Microsoft OneDrive auftreten. Diese Logs enthalten Informationen zu Verbindungsproblemen , Problemen bei der Datentransformation und API-Fehlern.

Hinweis

Bevor Sie auf die Fehlerlogs zugreifen, müssen Sie Folgendes getan haben:

• Zum Aktivieren des Loggings benötigen Sie die IAM-Rolle „Gemini Enterprise-Administrator“ (roles/discoveryengine.agentspaceAdmin).

• Für den Zugriff auf Cloud Logging benötigen Sie die IAM-Rolle „Logs Viewer“ (roles/logging.viewer).

• Sie haben eine Gemini Enterprise-App erstellt. Informationen zum Erstellen einer App finden Sie unter App erstellen.

• Sie haben dafür gesorgt, dass Ihre Datenspeicher richtig konfiguriert und aktiv sind. Weitere Informationen zum Einrichten von Datenspeichern finden Sie unter Google-Datenquelle verbinden oder Datenquelle eines Drittanbieters verbinden.

• Sie haben die Einstellungen für die Beobachtbarkeit aktiviert, um die Fehlerlogs für föderierte Connectors zu sehen. Weitere Informationen finden Sie unter Einstellungen für die Beobachtbarkeit aktivieren.

Auf Fehlerlogs für föderierte Connectors zugreifen

Wichtiger Begriff: In Gemini Enterprise kann der Begriff App im Zusammenhang mit APIs synonym mit dem Begriff Engine verwendet werden. Eine Gemini Enterprise-Engine ist eine generische Suchmaschine, bei der das Feld app_type auf APP_TYPE_INTRANET festgelegt ist.

So rufen Sie die Fehlerlogs Ihrer Datenspeicher auf, die über die Datenföderation mit Gemini Enterprise verbunden sind:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Wählen Sie einen Datenspeicher aus.

4. Klicken Sie auf Logs ansehen. Die Seite Log-Explorer wird geöffnet.

5. Wenn Sie nur Gemini Enterprise-Connector-Logs sehen möchten, geben Sie die folgende Abfrage in das Feld des Abfrageeditors ein und klicken Sie auf Abfrage ausführen:

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

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die Projekt-ID.
   • LOCATION: der Standort Ihres Connectors. Beispiel: global.
   • COLLECTION_ID: die ID der Collection, die Ihren Connector enthält. Dies ist auch die ID des Datenspeichers in der Console.Google Cloud

6. Grenzen Sie den Umfang Ihrer Abfrage mit einem Filter ein. Klicken Sie beispielsweise auf Alle Schweregrade und wählen Sie Fehler und höher aus. Weitere Informationen zum Eingrenzen von Abfragen finden Sie unter Beispielabfragen.

Auf Fehlerlogs für Ingestion-Connectors zugreifen

Wichtiger Begriff: In Gemini Enterprise kann der Begriff App im Zusammenhang mit APIs synonym mit dem Begriff Engine verwendet werden. Eine Gemini Enterprise-Engine ist eine generische Suchmaschine, bei der das Feld app_type auf APP_TYPE_INTRANET festgelegt ist.

So rufen Sie die Fehlerlogs Ihrer Datenspeicher auf, die über die Datenaufnahme mit Gemini Enterprise verbunden sind:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Wählen Sie einen Datenspeicher aus.

4. Klicken Sie auf Logs ansehen. Die Seite Log-Explorer wird geöffnet.

5. Standardmäßig werden auf der Seite „Log-Explorer“ die Ressourcen, die im Standard-Logbereich aufgeführt sind, nach Logeinträgen durchsucht. Führen Sie einen der folgenden Schritte aus, um nach Gemini Enterprise-Logs zu filtern:

   • Wählen Sie Alle Ressourcen > Consumed API > Discovery Engine API aus und klicken Sie dann auf Übernehmen.

   • Geben Sie Folgendes in die Abfrageleiste ein und klicken Sie auf Abfrage ausführen:

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

6. Grenzen Sie den Umfang Ihrer Abfrage ein, indem Sie nach JSON-Metadaten filtern. Wenn Sie beispielsweise Logs für die Methode ImportDocuments abfragen möchten, führen Sie einen der folgenden Schritte aus:

   • Geben Sie Folgendes in die Abfrageleiste ein:

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

   • Maximieren Sie die JSON-Metadaten und klicken Sie darauf, um einen Filter anzuwenden:

     

     Abbildung 1. Filtern durch Klicken auf JSON-Metadaten

7. Nähere Informationen zu den meisten Warnungen und Fehlern finden Sie unter jsonPayload.message und jsonPayload.status.

8. Für eine detailliertere Protokollanalyse können Sie die Logs in eine Logsenke wie BigQuery verschieben. Weitere Informationen finden Sie in der Dokumentation zu Google Cloud Observability unter Logs an unterstützte Ziele weiterleiten.