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 vous permettre d'effectuer les opérations suivantes:
- 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.
Conditions préalables
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 Créer un projet Cloud et activer l'API.
- Publiez le module complémentaire sur Google Workspace Marketplace. Pour publier un module complémentaire sur Marketplace, consultez la section Publier une application.
Journaux d'erreurs des modules complémentaires de requête
Pour obtenir les journaux d'un module complémentaire:
- Ouvrez Google Cloud Console.
- À côté de "Google Cloud Platform", cliquez sur la flèche vers le bas et sélectionnez le projet complémentaire.
- En haut à gauche, cliquez sur Menu > Logging (Journalisation). L'explorateur de journaux s'ouvre.
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"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 sur l'écriture de requêtes, consultez les pages suivantes:
Activer ou désactiver la journalisation des erreurs
Par défaut, la journalisation des erreurs est activée. 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",.
Points à prendre en compte
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.
- Cloud Logging entraîne des frais. Pour en savoir plus sur les tarifs de Cloud Logging, consultez la page Tarifs de la suite Google Cloud Operations.