Lorsqu'un module complémentaire Google Workspace publié renvoie une erreur, le l'interface du module complémentaire renvoie un message générique "Un problème est survenu lors de l'exécution du module complémentaire." Cependant, ces erreurs sont consigné dans l'explorateur de journaux Cloud.
<ph type="x-smartling-placeholder">Ce guide explique comment interroger les journaux d'erreurs des modules complémentaires dans Explorateur de journaux Cloud, ce qui vous permet 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.
Prérequis
Avant d'interroger les journaux d'erreurs du module complémentaire:
- Activer l'API Cloud Logging dans le module complémentaire projet Google Cloud. Pour activer une API, consultez Créez un projet Cloud et activez l'API.
- Publiez le module complémentaire sur Google Workspace Marketplace. Pour publier un module complémentaire sur Place de marché, consultez Publiez une application.
Journaux d'erreurs du module complémentaire de requête
Pour obtenir les journaux d'un module complémentaire, procédez comme suit:
- Ouvrez Google Cloud Console.
- À côté de "Google Cloud Platform", cliquez sur la flèche vers le bas et sélectionnez un projet complémentaire.
- En haut à gauche, cliquez sur Menu . > Journalisation. L'explorateur de journaux s'ouvre.
Pour les journaux d'erreurs du module complémentaire, saisissez dans le générateur de requêtes la requête suivante:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Pour afficher les erreurs récentes, cliquez sur Exécuter la requête. ou pour voir les erreurs lorsqu'elles cliquez sur Diffuser les journaux. Les journaux d'erreurs des modules complémentaires apparaissent dans "Résultats de la requête" volet.
Pour en savoir plus sur l'explorateur de journaux Cloud et la rédaction de requêtes, consultez les éléments suivants:
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, fichier manifeste présente les caractéristiques suivantes:
"exceptionLogging": "STACKDRIVER",
Pour désactiver la journalisation des erreurs, remplacez
"exceptionLogging": "STACKDRIVER", par la ligne suivante dans
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 Cloud Logs Explorer, tenez compte des points suivants:
- Les modules complémentaires ne consignent les erreurs que dans l'explorateur de journaux. Les autres types de journaux sont non enregistrées.
- 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 Cloud Logging, consultez les tarifs de Google Cloud Observability.