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

Gemini Enterprise fournit Cloud Logging aux clients pour 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 aux journaux d'erreurs 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 des connecteurs 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.

• Vous vous êtes assuré 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 des connecteurs fédérés. Pour en savoir plus, consultez Activer les paramètres d'observabilité.

Accéder aux journaux d'erreurs des connecteurs fédérés

Terme clé : Dans Gemini Enterprise, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dans lequel 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 Google Cloud console, 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'ouvre.

5. Pour n'afficher que les journaux des connecteurs 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 : par l'emplacement de votre connecteur. Par exemple, global.
   • COLLECTION_ID : par l'ID de la collection contenant votre connecteur, qui correspond également à l'ID du data store dans la console.Google 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'affinage de vos requêtes, consultez Exemples de requêtes.

Accéder aux journaux d'erreurs des connecteurs d'ingestion

Terme clé : Dans Gemini Enterprise, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dans lequel 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 Google Cloud console, 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'ouvre.

5. Par défaut, la page Explorateur de journaux recherche les entrées de journal dans les ressources listées dans le champ d'application 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 le code suivant 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 les métadonnées JSON. Par exemple, pour interroger les journaux de la méthode ImportDocuments, effectuez l'une des opérations suivantes :

   • Saisissez le code suivant 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 informations détaillées dans jsonPayload.message et jsonPayload.status.

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