Consultez la liste des connecteurs compatibles avec Application Integration.

Afficher les journaux dans Cloud Logging

Cette page explique comment activer Cloud Logging pour une intégration et comment afficher les journaux dans Cloud Logging, ainsi que des exemples de requêtes permettant d'afficher les journaux d'intégration dans Cloud Logging.

Présentation

Dans Cloud Logging, vous pouvez afficher les journaux d'exécution de l'intégration contenant des détails sur l'intégration, tels 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 du déclencheur et des tâches. Pour en savoir plus sur les journaux d'exécution dans Cloud Logging, consultez la page Journaux d'exécution d'intégration dans Cloud Logging. Pour en savoir plus sur les limites et les tarifs, consultez les sections 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.

Activer Cloud Logging

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 Integrations (Intégrations).

    La page Intégrations s'affiche, listant 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.

    La page de l'éditeur d'intégration s'affiche.

  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 la section 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 la section Paramètres des journaux, 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 :
      • Informations : sélectionnez cette option pour enregistrer tous les états d'exécution (SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED, RETRY_ON_HOLD et CANCELLED).
      • Erreur: sélectionnez cette option pour enregistrer les états d'exécution suivants: FAILED et CANCELLED.
      • Avertissement: sélectionnez cette option pour enregistrer les états d'exécution suivants: FAILED et CANCELLED.

        • Pour obtenir la liste des états d'exécution de l'intégration, consultez la section États de l'exécution.

    2. Cliquez sur Enregistrer.

Afficher les journaux

Pour afficher les journaux dans Cloud Logging, vous devez d'abord activer Cloud Logging, puis procéder comme suit:

  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 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 sont affichés au cours des trois dernières heures 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 de l'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 parents ayant l'ID d'exécution donné : 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Recherche les exécutions parentes et enfants 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"

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

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

    • Pour voir d'autres exemples de requêtes, consultez la page 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 sont pas affichés dans les détails de journalisation. Pour en savoir plus sur les quotas et les limites de Cloud Logging, consultez la page 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é.

Tarification

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

Étapes suivantes