Afficher les journaux dans Cloud Logging

Dans Cloud Logging, vous pouvez afficher les journaux d'exécution de l'intégration contenant des informations sur l'intégration, telles que l'état, les performances, la version de l'intégration, les paramètres de requête et de réponse, ainsi que les configurations de déclencheur et de tâche. Pour en savoir plus sur les journaux d'exécution dans Cloud Logging, consultez Journaux d'exécution d'intégration dans Cloud Logging. Pour en savoir plus sur les limites et les tarifs, consultez Limites et Tarifs.

Par défaut, Cloud Logging est désactivé pour les intégrations. Vous pouvez activer la journalisation pour une intégration en modifiant la version non publiée de l'intégration.

Avant de commencer

Pour stocker les journaux d'exécution de l'intégration dans Cloud Logging, vous devez d'abord activer Cloud Logging pour votre intégration. Pour cela, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Intégrations.

    La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud .

  3. Sélectionnez une intégration existante ou créez-en une pour laquelle vous souhaitez activer Cloud Logging.

    Cela entraîne son ouverture dans l'éditeur d'intégrations.

  4. Sélectionnez la version DRAFT de votre intégration. Vous ne pouvez pas modifier les paramètres d'une version publiée ou non publiée qui n'est pas en mode brouillon. Pour obtenir la liste des versions d'intégration, consultez Versions.
  5. Cliquez sur  (Résumé de l'intégration) dans la barre d'outils du concepteur. La page récapitulative de l'intégration s'affiche.
    1. Dans les Paramètres de journalisation, cliquez sur le bouton Activer Cloud Logging, puis, dans la liste Gravité, sélectionnez le type de gravité des journaux que vous souhaitez stocker dans Cloud Logging :
      • Info : sélectionnez cette option pour capturer tous les états d'exécution : SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED, RETRY_ON_HOLD et CANCELLED.
      • Erreur : sélectionnez cette option pour capturer les états d'exécution suivants : FAILED et CANCELLED.
      • Avertissement : Sélectionnez cette option pour capturer les états d'exécution suivants : FAILED et CANCELLED.

        • Pour obtenir la liste des états d'exécution des intégrations, consultez États d'exécution.

    2. Cliquez sur Enregistrer.

Afficher les journaux

Pour afficher les journaux dans Cloud Logging, vous devez d'abord activer Cloud Logging, puis suivre ces étapes :

  1. Dans la console Google Cloud , accédez à la page Application Integration.

    Accéder à Application Integration

  2. Pour afficher les journaux d'exécution de l'intégration dans Cloud Logging, utilisez l'une des méthodes suivantes :
    • Dans le menu de navigation, cliquez sur Journaux, puis sur Afficher les journaux Cloud.
    • Dans le menu de navigation, cliquez sur Journaux, puis sur Afficher dans le champ Cloud Logging. Si Cloud Logging est activé, ce champ fournit un lien pour afficher les journaux dans Cloud Logging. Si Cloud Logging n'est pas activé, ce champ est défini sur Désactivé.
    • Dans l'éditeur d'intégrations, après avoir testé une intégration, cliquez sur Afficher les journaux Cloud dans le volet Tester l'intégration.

    La page Explorateur de journaux s'affiche. Les journaux des trois dernières heures s'affichent pour la requête par défaut suivante : 

    resource.type=integrations.googleapis.com/IntegrationVersion

    3. Pour comprendre le format des journaux Application Integration, consultez la charge utile log_entries.

Exemples de requêtes

Vous pouvez utiliser les requêtes suivantes pour afficher les journaux dans Cloud Logging :

  • Pour afficher tous les journaux d'exécution d'intégration :

        resource.type="integrations.googleapis.com/IntegrationVersion"

  • Vous pouvez afficher les journaux d'exécution d'intégration pour un ID d'exécution spécifique :

    • Recherche uniquement les exécutions parentes avec l'ID d'exécution donné : 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Recherche les exécutions parent et enfant lancées à partir de l'ID d'exécution donné : 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • Pour afficher les journaux d'exécution d'une intégration spécifique :

        resource.type="integrations.googleapis.com/IntegrationVersion" 
    "INTEGRATION_NAME"
     ou 
        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integration="INTEGRATION_NAME"

  • Pour afficher les exécutions d'intégration ayant échoué pour une intégration spécifique :

        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
    jsonPayload.integration="INTEGRATION_NAME"

  • Pour afficher les journaux avec un nom de paramètre de requête spécifique. Par exemple, la requête suivante demande les journaux pour le paramètre requestUrl :

        resource.type="integrations.googleapis.com/IntegrationVersion"
    "requestUrl"

    • Pour obtenir d'autres exemples de requêtes, consultez Exemples de requêtes Cloud Logging.

Limites

Les journaux d'intégration dans Cloud Logging sont soumis aux limites suivantes :

  • Cloud Logging n'accepte que les entrées de journal d'une taille maximale de 256 Kio. Si vos journaux dépassent cette limite, les paramètres de requête et de réponse ne s'affichent pas dans les détails de journalisation. Pour en savoir plus sur les quotas et les limites de Cloud Logging, consultez Quotas et limites. Pour résoudre cette erreur, mettez à jour les variables d'intégration afin que la valeur ne dépasse pas la limite. Vous pouvez également afficher ces journaux dans Application Integration.
  • Si la journalisation locale est désactivée, les journaux d'exécution ne sont pas envoyés à Cloud Logging, même si Cloud Logging est activé.

Tarifs

Pour en savoir plus sur les tarifs de Cloud Logging, consultez la page Tarifs de Cloud Logging.

Étapes suivantes