Ce guide explique comment interroger les journaux d'erreurs de l'application Chat dans l'explorateur de journaux Google Cloud. Interrogez les journaux sur:
- 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 et les données de journaux qui vous aideront à 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 quickstart.
- Activez la journalisation des erreurs pour l'application Chat.
Interroger les journaux d'erreurs
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'erreurs 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 Diffuser les journaux. Les journaux d'erreurs 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 sur la rédaction 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 d'erreurs, vous pouvez afficher les journaux individuels, composés d'une charge utile JSON décrivant le journal. Pour les erreurs de l'application Chat, le fichier JSON inclut le message d'erreur dans jsonPayload.error.message
. Par exemple, dans l'exemple de journal suivant, le message d'erreur indique qu'une fonction Apps Script a échoué:
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"
}
Points à prendre en compte
Lorsque vous utilisez les journaux d'erreurs 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 avec les niveaux de gravité suivants, qui permettent de résoudre les problèmes de fonctionnement de l'application:
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 rechercher également les journaux Cloud Functions dans l'explorateur de journaux.
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 la suite Google Cloud Operations.
Articles associés
Après avoir interrogé les journaux d'erreurs, si vous trouvez des erreurs, consultez les guides suivants pour les corriger:
- Découvrez comment corriger les erreurs dans l'application Google Chat telles que "L'application ne répond pas", "L'API Google Chat n'est disponible que pour les utilisateurs Google Workspace" ou "Les utilisateurs peuvent être exclus des espaces".
- Découvrez comment corriger les erreurs de fiches telles que les messages, boîtes de dialogue ou aperçus de liens qui ne s'affichent pas ou ne fonctionnent pas comme prévu.
- En savoir plus sur le débogage