Ce guide explique comment interroger les journaux d'erreur de l'application Chat dans l'explorateur de journaux Google Cloud. Interrogez les journaux 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 et les données de journalisation qui vous aident à corriger les erreurs.
Prérequis
- Un compte Google Workspace ayant accès à Google Chat
- Une application Chat. Pour créer une application Chat, suivez ce guide de démarrage rapide.
- Activez la journalisation des erreurs pour l'application Chat.
Journaux d'erreurs de requête
Dans la console Google Cloud, cliquez sur Menu > Plus de produits > Journalisation > Explorateur de journaux.
Si nécessaire, activez Afficher la requête pour afficher le générateur de requêtes.
Pour les journaux d'erreur de l'application Chat, saisissez la requête suivante:
severity=ERROR resource.type="chat.googleapis.com/Project"
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 Journaux de diffusion. Les journaux d'erreur de l'application Chat s'affichent dans le volet "Résultats de la requête".
Pour en savoir plus sur l'explorateur de journaux Google Cloud et l'écriture de requêtes, consultez les guides suivants dans la documentation de l'explorateur de journaux:
- Afficher les journaux à l'aide de l'explorateur de journaux
- Créer des requêtes dans l'explorateur de journaux
Lire un message d'erreur à partir d'un journal
Après avoir interrogé un journal des erreurs, vous pouvez afficher des journaux individuels qui consistent en une charge utile JSON décrivant le journal. Pour les erreurs de l'application Chat, le message d'erreur est inclus dans le fichier JSON à l'emplacement jsonPayload.error.message
. Par exemple, dans l'exemple de journal suivant, le message d'erreur indique qu'une fonction Apps Script n'a pas pu s'exécuter:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
Remarques
Lorsque vous travaillez avec les journaux d'erreur de l'application Chat dans l'explorateur de journaux Google Cloud, tenez compte des points suivants:
Pour les applications Google Chat, l'explorateur de journaux inclut actuellement les journaux de gravité suivantes, qui aident à résoudre les problèmes d'une application dysfonctionnante:
ERROR
Les journaux des services associés peuvent également aider à déboguer une application Chat. Par exemple, si une application Chat est déployée à l'aide de Google Cloud Functions, il est recommandé de consulter également les journaux Cloud Functions dans l'explorateur de journaux.
Les messages d'erreur sont toujours rédigés en anglais.
Cloud Logging entraîne des coûts. Pour en savoir plus sur la tarification de Cloud Logging, consultez la page Tarifs de la suite Google Cloud Operations.
Articles associés
Si vous trouvez des erreurs après avoir interrogé les journaux d'erreurs, consultez les guides suivants pour les corriger:
- Découvrez comment résoudre les erreurs de l'application Google Chat, comme "L'application ne répond pas", "L'API Google Chat n'est disponible que pour les utilisateurs de Google Workspace" ou "Les utilisateurs peuvent être exclus des espaces".
- Découvrez comment résoudre les erreurs liées aux cartes, par exemple lorsque les messages, les boîtes de dialogue ou les aperçus de liens ne s'affichent pas ou ne fonctionnent pas comme prévu.
- Découvrez comment déboguer.