Accéder aux journaux d'erreurs du connecteur Gemini Enterprise avec Cloud Logging

Gemini Enterprise fournit Cloud Logging aux clients pour qu'ils puissent surveiller les erreurs et les avertissements lorsqu'ils connectent leurs données à Gemini Enterprise.

Ce document explique comment accéder aux journaux d'erreurs des connecteurs fédérés et des connecteurs d'ingestion pour Gemini Enterprise à l'aide de Cloud Logging.

Concepts clés

Cette section présente les concepts clés liés à l'observabilité dans Gemini Enterprise.

Concept	Description
Journaux d'erreurs du connecteur Gemini Enterprise	Les journaux d'erreurs des connecteurs Gemini Enterprise capturent les erreurs et les échecs rencontrés lors de l'intégration de Gemini Enterprise à des sources de données tierces telles que Jira et Microsoft OneDrive. Ces journaux incluent les problèmes de connexion, les problèmes de transformation des données et les erreurs d'API.

Avant de commencer

Avant d'accéder aux journaux d'erreurs, assurez-vous d'avoir effectué les opérations suivantes :

• Pour activer la journalisation, vous devez disposer du rôle IAM Administrateur Gemini Enterprise (roles/discoveryengine.agentspaceAdmin).

• Pour accéder à Cloud Logging, vous devez disposer du rôle IAM Lecteur de journaux (roles/logging.viewer).

• Vous avez créé une application Gemini Enterprise. Pour en créer une, consultez Créer une application.

• Assurez-vous que vos datastores sont correctement configurés et actifs. Pour en savoir plus sur la configuration des datastores, consultez Connecter une source de données Google ou Connecter une source de données tierce.

• Vous avez activé les paramètres d'observabilité pour afficher les journaux d'erreurs du connecteur fédéré. Pour en savoir plus, consultez Activer les paramètres d'observabilité.

Accéder aux journaux d'erreurs du connecteur fédéré

Terme clé : Dans Gemini Enterprise, le terme app (application) peut être utilisé de manière interchangeable avec le terme engine (moteur) dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dont le champ app_type est défini sur APP_TYPE_INTRANET.

Pour afficher les journaux d'erreurs de vos datastores qui se connectent à Gemini Enterprise à l'aide de la fédération de données, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

   Gemini Enterprise

2. Dans le menu de navigation, cliquez sur Datastores.

3. Sélectionnez le data store de votre choix.

4. Cliquez sur View logs (Afficher les journaux). La page Explorateur de journaux s'affiche.

5. Pour n'afficher que les journaux du connecteur Gemini Enterprise, saisissez la requête suivante dans le champ de l'éditeur de requête, puis cliquez sur Exécuter la requête :

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

   Remplacez les éléments suivants :

   • PROJECT_ID : par l'ID du projet.
   • LOCATION : emplacement de votre connecteur. Exemple :global
   • COLLECTION_ID : ID de la collection contenant votre connecteur, qui est également l'ID du data store dans la consoleGoogle Cloud .

6. Affinez le champ d'application de votre requête à l'aide d'un filtre. Par exemple, cliquez sur Tous les niveaux de gravité, puis sélectionnez Erreur et plus. Pour en savoir plus sur l'affinement de vos requêtes, consultez Exemples de requêtes.

Accéder aux journaux d'erreurs du connecteur d'ingestion

Terme clé : Dans Gemini Enterprise, le terme app (application) peut être utilisé de manière interchangeable avec le terme engine (moteur) dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dont le champ app_type est défini sur APP_TYPE_INTRANET.

Pour afficher les journaux d'erreurs de vos datastores qui se connectent à Gemini Enterprise à l'aide de l'ingestion de données, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

   Gemini Enterprise

2. Dans le menu de navigation, cliquez sur Datastores.

3. Sélectionnez le data store de votre choix.

4. Cliquez sur View logs (Afficher les journaux). La page Explorateur de journaux s'affiche.

5. Par défaut, la page de l'explorateur de journaux recherche les entrées de journal dans les ressources listées dans le champ d'action des journaux par défaut. Pour filtrer les journaux Gemini Enterprise, effectuez l'une des opérations suivantes :

   • Sélectionnez Toutes les ressources > API consommée > API Discovery Engine, puis cliquez sur Appliquer.

   • Saisissez la requête suivante dans la barre de requête, puis cliquez sur Exécuter la requête :

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

6. Affinez le champ d'application de votre requête en filtrant sur les métadonnées JSON. Par exemple, pour interroger les journaux de la méthode ImportDocuments, effectuez l'une des opérations suivantes :

   • Saisissez ce qui suit dans la barre de requête :

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

   • Développez les métadonnées JSON, puis cliquez pour filtrer :

     

     Figure 1. Filtrer en cliquant sur les métadonnées JSON

7. Pour la plupart des avertissements et des erreurs, vous trouverez des détails dans jsonPayload.message et jsonPayload.status.

8. Pour une analyse plus approfondie des journaux, videz-les dans un récepteur de journaux tel que BigQuery. Pour en savoir plus, consultez Acheminer les journaux vers des destinations compatibles dans la documentation Google Cloud Observability.