Log error kueri untuk aplikasi Google Chat

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

  • Mengetahui apakah pengguna mengalami error.
  • Melihat seberapa sering error terjadi, dan mana yang paling sering terjadi.
  • Membaca pesan error deskriptif dan data log yang membantu Anda memperbaiki error.

Prasyarat

Membuat kueri log error

  1. Di Konsol Google API, klik Menu > Produk lainnya > Logging > Logs Explorer.

    Buka Logs Explorer

  2. Jika perlu, untuk menampilkan pembuat kueri, aktifkan Tampilkan 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 saat terjadi, klik Streaming log. Log error aplikasi Chat akan muncul di panel "Hasil kueri".

Untuk mempelajari lebih lanjut Logs Explorer Google Cloud dan cara menulis kueri, lihat panduan berikut dalam dokumentasi Logs Explorer:

Membaca pesan error dari log

Setelah membuat kueri log error, Anda dapat melihat log individual yang terdiri dari payload JSON yang menjelaskan log. 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 dieksekusi:

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 Logs Explorer Google Cloud, perhatikan pertimbangan berikut:

  • Untuk aplikasi Google Chat, Logs Explorer 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 Anda men-deploy aplikasi Chat menggunakan fungsi Google Cloud Run, periksa juga log fungsi Cloud Run di Logs Explorer.

  • Pesan error selalu ditulis dalam bahasa Inggris.

  • Cloud Logging dikenai biaya. Untuk mengetahui informasi lebih lanjut 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: