Menyiapkan dan mengirimkan notifikasi kustom ke saluran notifikasi kustom

Firebase menawarkan pemberitahuan Crashlytics default (lihat halaman ringkasan pemberitahuan). Namun, pemberitahuan default ini dan saluran notifikasinya mungkin tidak cukup untuk memenuhi kebutuhan Anda.

Dalam kasus ini, Anda dapat menggunakan Cloud Monitoring untuk mengirim pemberitahuan kustom ke saluran notifikasi kustom berdasarkan data Crashlytics (dan secara opsional data sesi Firebase) yang telah Anda ekspor ke Cloud Logging.

Untuk menggunakan Cloud Monitoring untuk pemberitahuan kustom, Anda menyiapkan kebijakan pemberitahuan, yang menjelaskan situasi saat Anda ingin mendapatkan pemberitahuan dan cara mendapatkan pemberitahuan.

Misalnya, jika rasio bebas error Anda turun di bawah nilai minimum tertentu, Cloud Monitoring dapat mengirim pesan pemberitahuan yang disesuaikan ke alamat email tertentu atau mempostingnya ke layanan pihak ketiga, seperti Discord, Slack, atau Jira. Anda juga dapat menyesuaikan sepenuhnya informasi yang dikirim dalam pemberitahuan, seperti menyertakan deep link berguna ke Firebase console atau informasi pemecahan masalah spesifik per perusahaan.

Dalam dokumentasi Google Cloud, pelajari lebih lanjut Cloud Monitoring dan pemberitahuan, termasuk harga.

Prasyarat

1. Pastikan project Firebase Anda menggunakan paket harga Blaze bayar sesuai penggunaan.

2. Siapkan ekspor data Crashlytics dan (opsional) data sesi Firebase ke Cloud Logging.

3. Siapkan saluran notifikasi.

Menyiapkan kebijakan pemberitahuan

Berikut adalah petunjuk umum; untuk petunjuk mendetail, lihat dokumentasi Google Cloud (misalnya: Membuat kebijakan pemberitahuan batas metrik atau Menggunakan PromQL untuk membuat kebijakan pemberitahuan).

Sebagai bagian dari menjalankan kueri, Anda dapat menyiapkan pemberitahuan berbasis log atau pemberitahuan berbasis SQL:

• Menyiapkan pemberitahuan berbasis log:

  1. Menjalankan kueri di Logs Explorer.

  2. Klik tombol Tambahkan pemberitahuan yang muncul.

  3. Ikuti petunjuk di layar untuk menambahkan pemberitahuan berbasis log.

• Menyiapkan pemberitahuan berbasis SQL:

  1. Jalankan kueri di Log Analytics.

  2. Klik tombol Tambahkan pemberitahuan yang muncul.

  3. Ikuti petunjuk di layar untuk menambahkan pemberitahuan berbasis SQL.

Atau, Anda dapat menyiapkan pemberitahuan untuk metrik berbasis log dengan menggunakan alat konfigurasi kebijakan di konsol Google Cloud, tempat Anda dapat memilih salah satu opsi berikut:

• Builder: UI konsol menyediakan alur kerja terpandu untuk membuat kebijakan pemberitahuan.

• PromQL: Anda memberikan kueri PromQL untuk kebijakan pemberitahuan

  Contoh kueri PromQL

  Misalnya, Anda telah membuat dua metrik berbasis log untuk data sesi Firebase dan Crashlytics yang diekspor:

  • Satu metrik bernama firebase/crashlytics_events dengan label errorType, dan ditentukan sebagai:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Metrik lain bernama firebase/session_events dengan label eventType, dan ditentukan sebagai:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  Berikut contoh kueri PromQL yang menggunakan metrik berbasis log ini untuk memicu pemberitahuan saat persentase bebas error Anda turun di bawah 70%:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7