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 Google Cloud. Interroger 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.
  • lire les messages d'erreur descriptifs et les données de journaux qui vous aident à corriger les erreurs ;

Prérequis

Journaux d'erreurs de requête

  1. Dans la console Google Cloud, cliquez sur Menu. > Autres produits > Journalisation > Explorateur de journaux.

    Accéder à l'explorateur de journaux

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

  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 voir les erreurs à mesure qu'elles se produisent, cliquez sur Diffuser les journaux. Les journaux d'erreurs des applications de chat s'affichent dans "Résultats de la requête" volet.

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:

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

Après avoir interrogé un journal d'erreurs, vous pouvez afficher des journaux individuels constitué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 à l'emplacement jsonPayload.error.message. Par exemple, dans l'exemple de journal suivant, le message d'erreur indique que l'exécution d'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"
}

Remarques

Lorsque vous utilisez les journaux d'erreurs des applications 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 d'une 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 également recommandé de vérifier également les journaux de l'Explorateur de journaux pour Cloud Functions.

  • 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.

Si vous trouvez des erreurs après avoir interrogé les journaux d'erreurs, consultez les guides suivants pour obtenir de l'aide: