Log error kueri untuk aplikasi Google Chat

Panduan ini menjelaskan cara membuat kueri log error aplikasi Chat di Google Cloud Logs Explorer. Log kueri ke:

  • Ketahui apakah pengguna mengalami error.
  • Lihat seberapa sering error terjadi, dan mana yang paling sering terjadi.
  • Baca pesan error deskriptif dan data log yang membantu Anda memperbaiki error.

Prasyarat

  • Akun Google Workspace dengan akses ke Google Chat.
  • Aplikasi Chat. Untuk membangun aplikasi Chat, ikuti quickstart ini.
  • Aktifkan logging error untuk aplikasi Chat.

Log error kueri

  1. Di konsol Google Cloud, klik Menu > More products > Logging > Logs Explorer.

    Buka Log Explorer

  2. Jika perlu, aktifkan Tampilkan kueri untuk menampilkan pembuat kueri.

  3. Untuk log error aplikasi Chat, masukkan kueri berikut:

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

  4. Untuk melihat error terbaru, klik Jalankan kueri. Atau, untuk melihat error yang terjadi, klik Stream logs. Log error aplikasi Chat akan muncul di panel "Query results".

Untuk mempelajari Google Cloud Logs Explorer dan menulis kueri lebih lanjut, lihat panduan ini di dokumentasi Logs Explorer:

Membaca pesan error dari log

Setelah membuat kueri log error, Anda dapat melihat masing-masing log berisi payload JSON yang menjelaskan log tersebut. Untuk error aplikasi Chat, JSON menyertakan pesan error di jsonPayload.error.message. Misalnya, dalam contoh log berikut, pesan error menyatakan bahwa fungsi Apps Script gagal dijalankan:

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"
}

Pertimbangan

Saat Anda menggunakan log error aplikasi Chat di Google Cloud Logs Explorer, perhatikan pertimbangan berikut:

  • Untuk aplikasi Google Chat, Logs Explorer saat ini menyertakan log dengan tingkat keparahan berikut, yang membantu memecahkan masalah aplikasi yang tidak berfungsi:

    • ERROR

    Log layanan terkait juga dapat membantu men-debug aplikasi Chat. Misalnya, jika aplikasi Chat di-deploy menggunakan Google Cloud Functions, sebaiknya periksa juga log Logs Explorer untuk Cloud Functions.

  • Pesan error selalu ditulis dalam bahasa Inggris.

  • Cloud Logging menimbulkan biaya. Untuk mengetahui informasi selengkapnya tentang harga Cloud Logging, lihat harga Google Cloud Operations Suite.

Setelah membuat kueri log error, jika Anda menemukan error, lihat panduan berikut untuk mendapatkan bantuan dalam memperbaiki error: