Interroger les journaux d'erreurs pour les modules complémentaires Google Workspace

Lorsqu'un module complémentaire Google Workspace publié renvoie une erreur, son interface affiche le message générique "Un problème est survenu lors de l'exécution du module complémentaire". Cependant, ces erreurs sont consignées dans l'explorateur de journaux Cloud.

Ce guide explique comment interroger les journaux d'erreurs des modules complémentaires dans l'explorateur de journaux Cloud pour:

  • Découvrez si les utilisateurs rencontrent des erreurs.
  • Déterminez à quelle fréquence les erreurs se produisent et lesquelles sont les plus fréquentes.
  • Lisez les messages d'erreur descriptifs qui vous aideront à les corriger.

Prérequis

Avant d'interroger les journaux d'erreurs des modules complémentaires:

  • Activez l'API Cloud Logging dans le projet Google Cloud du module complémentaire. Pour activer une API, consultez la page Créer un projet Cloud et activer l'API.
  • Publier le module complémentaire sur Google Workspace Marketplace Pour publier un module complémentaire sur Marketplace, consultez la page Publier une application.

Journaux d'erreurs des modules complémentaires de requête

Pour obtenir les journaux d'un module complémentaire:

  1. Ouvrez Google Cloud Console.
  2. À côté de "Google Cloud Platform", cliquez sur la flèche vers le bas et sélectionnez le projet complémentaire.
  3. En haut à gauche, cliquez sur Menu > Journalisation. L'explorateur de journaux s'ouvre.
  4. Pour les journaux d'erreurs des modules complémentaires, saisissez la requête suivante dans le générateur de requêtes:

    severity>=ERROR
    protoPayload.serviceName="gsuiteaddons.googleapis.com"
    
  5. Pour afficher les erreurs récentes, cliquez sur Exécuter la requête. Pour afficher les erreurs au fur et à mesure qu'elles se produisent, cliquez sur Diffuser les journaux. Les journaux d'erreurs des modules complémentaires s'affichent dans le volet "Résultats de la requête".

Pour en savoir plus sur l'explorateur de journaux Cloud et l'écriture de requêtes, consultez les ressources suivantes:

Activer ou désactiver la journalisation des erreurs

La journalisation des erreurs est activée par défaut. Lorsque la journalisation des erreurs est activée, le fichier manifeste contient les éléments suivants:

"exceptionLogging": "STACKDRIVER",

Pour désactiver la journalisation des erreurs, remplacez "exceptionLogging": "STACKDRIVER", par la ligne suivante dans le fichier manifeste:

// Disable error logging
"exceptionLogging": "NONE"

Pour réactiver la journalisation des erreurs, remplacez "exceptionLogging": "NONE" par "exceptionLogging": "STACKDRIVER",.

Remarques

Lorsque vous utilisez des journaux d'erreurs des modules complémentaires dans l'explorateur de journaux Cloud, tenez compte des points suivants:

  • Les modules complémentaires ne consignent que les erreurs dans l'explorateur de journaux. Les autres types de journaux ne sont pas enregistrés.
  • Les messages d'erreur sont toujours rédigés en anglais.
  • L'utilisation de Cloud Logging entraîne des frais. Pour en savoir plus sur les tarifs de Cloud Logging, consultez les tarifs de l'observabilité Google Cloud.