Interroger les journaux d'erreurs pour les applications Google Chat

Ce guide explique comment interroger les journaux d'erreurs de l'application Chat dans l'explorateur de journaux de Google Cloud. Interrogez les journaux pour :

  • déterminer si les utilisateurs rencontrent des erreurs ;
  • déterminer la fréquence des erreurs et les plus fréquentes ;
  • lire des messages d'erreur descriptifs et des données de journal qui vous aident à corriger les erreurs.

Prérequis

Interroger les journaux d'erreurs

  1. Dans la console Google API, cliquez sur Menu > Plus de produits > Logging > Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Si nécessaire, pour afficher le générateur de requêtes, activez Afficher la requête.

  3. Pour les journaux d'erreurs de l'application Chat, saisissez la requête suivante :

    severity=ERROR
resource.type="chat.googleapis.com/Project"

  4. 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 de Google Cloud et sur la création de requêtes, consultez les guides suivants dans la documentation de l'explorateur de journaux :

Lire un message d'erreur à partir d'un journal

Après avoir interrogé un journal d'erreurs, vous pouvez afficher des journaux individuels qui se composent d'une charge utile JSON décrivant le journal. Pour les erreurs de l'application Chat, le code 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 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 utilisez les journaux d'erreurs de l'application Chat dans l'explorateur de journaux de Google Cloud, tenez compte des points suivants :

  • Pour les applications Google Chat, l'explorateur de journaux inclut des journaux avec les niveaux de gravité suivants, qui vous aident à résoudre les problèmes liés à une application défectueuse :

    • ERROR

    Les journaux des services associés peuvent également vous aider à déboguer une application Chat. Par exemple, si vous déployez votre application Chat à l'aide des fonctions Google Cloud Run, consultez également l'explorateur de journaux pour les journaux des fonctions Cloud Run.

  • 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 la page Tarifs de la suite Operations de Google Cloud.

Après avoir interrogé les journaux d'erreurs, si vous en trouvez, consultez les guides suivants pour obtenir de l'aide sur la correction des erreurs :