Cette page a été traduite par l'API Cloud Translation.

Interroger les journaux d'erreur des modules complémentaires Google Workspace

Lorsqu'un module complémentaire Google Workspace publié renvoie une erreur, l'interface du module complémentaire renvoie un message générique indiquant "Une erreur s'est produite lors de l'exécution du module complémentaire". Toutefois, ces erreurs sont consignées dans l'explorateur de journaux Cloud.

Remarque:Pour Apps Script, si votre module complémentaire est déployé à des fins de test, les erreurs sont signalées à la fois dans l'explorateur de journaux Cloud et dans l'interface du module complémentaire.

Par exemple, un déploiement de test d'un module complémentaire peut afficher un message d'erreur semblable à celui-ci dans son interface: TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn].

Bien que des messages d'erreur comme celui-ci soient utiles, des informations supplémentaires sont disponibles dans l'explorateur de journaux. Nous vous recommandons d'interroger les journaux d'erreurs pour en savoir plus. Pour en savoir plus sur les tests des déploiements de modules complémentaires, consultez Tester et déboguer les modules complémentaires Google Workspace.

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

Découvrez si les utilisateurs rencontrent des erreurs.
Découvrez la fréquence à laquelle les erreurs se produisent et celles qui sont les plus fréquentes.
Lisez les messages d'erreur descriptifs qui vous aident à les résoudre.

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 section 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 la place de marché, consultez Publier une application.

Interroger les journaux d'erreur des modules complémentaires

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 , puis sélectionnez le projet du module complémentaire.
En haut à gauche, cliquez sur Menu > Journalisation. L'explorateur de journaux s'ouvre.
Pour les journaux d'erreurs des modules complémentaires, dans le générateur de requêtes, saisissez la requête suivante:
```
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, cliquez sur Diffuser les journaux. Les journaux d'erreur 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

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",.

Remarques

Lorsque vous travaillez avec les journaux d'erreur 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 coûts. Pour en savoir plus sur les tarifs de Cloud Logging, consultez les tarifs de Google Cloud Observability.