Afficher les journaux dans Cloud Logging

Dans Cloud Logging, vous pouvez consulter 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 du déclencheur et de la tâche. Pour en savoir plus sur les journaux d'exécution dans Cloud Logging, consultez la section Journaux d'exécution d'intégration dans Cloud Logging. Pour en savoir plus sur les limites et les tarifs, consultez les pages 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 :

Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
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 .
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.
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.
Cliquez sur (Récapitulatif de l'intégration) dans la barre d'outils du concepteur. La page récapitulative de l'intégration s'affiche.

Dans Paramètres des journaux, cliquez sur l'option Activer Cloud Logging, puis dans la liste Sévérité, sélectionnez le niveau 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.
  Remarque:Actuellement, les niveaux de gravité Error (Erreur) et Warning (Avertissement) capturent les états d'exécution FAILED et CANCELLED.
Cliquez sur Enregistrer.

Afficher les journaux

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

Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
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 dans le champ Cloud Logging, cliquez sur Afficher. 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, dans le volet Tester l'intégration, cliquez sur Afficher les journaux Cloud.
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
```

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 parents 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"

    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 des journaux pour le paramètre requestUrl:
```
    resource.type="integrations.googleapis.com/IntegrationVersion"
    "requestUrl"
```

Pour obtenir d'autres exemples de requêtes, consultez la section 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 Ko. 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 la journalisation. Pour en savoir plus sur les quotas et les limites de Cloud Logging, consultez la section 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 l'intégration d'applications.
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 section Tarifs de Cloud Logging.

Étape suivante

Découvrez les journaux d'exécution dans Cloud Logging.
Découvrez comment interroger et afficher des journaux.
En savoir plus sur les métriques basées sur les journaux
Découvrez comment les journaux sont stockés et acheminés, et comment les exporter vers différentes destinations.
Découvrez comment créer des alertes sur des métriques basées sur les journaux.