Menyiapkan pemberitahuan lanjutan ke saluran notifikasi kustom

Firebase menawarkan dua opsi untuk mengonfigurasi pemberitahuan dan mengirimkannya ke saluran notifikasi kustom.

(Direkomendasikan) Menyiapkan dan mengirimkan notifikasi kustom ke saluran notifikasi kustom

Anda dapat menggunakan Cloud Monitoring untuk mengirim notifikasi yang sepenuhnya disesuaikan ke saluran notifikasi kustom berdasarkan data Crashlytics dan (opsional) data sesi Firebase yang telah Anda ekspor ke Cloud Logging.
Mengirim pemberitahuan Crashlytics default ke saluran notifikasi kustom

Anda dapat menggunakan Cloud Functions untuk mengirim pemberitahuan Crashlytics default ke saluran notifikasi kustom.

(Direkomendasikan) Menyiapkan dan mengirimkan pemberitahuan 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

Pastikan project Firebase Anda menggunakan paket harga Blaze bayar sesuai penggunaan.
Siapkan ekspor data Crashlytics dan (opsional) data sesi Firebase ke Cloud Logging.
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
```

Mengirim notifikasi Crashlytics default ke saluran notifikasi kustom

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

Dalam kasus ini, Anda dapat menggunakan Cloud Functions for Firebase untuk mengirim pemberitahuan Crashlytics default ini ke saluran notifikasi kustom. Misalnya, Anda dapat menulis fungsi yang menangkap peristiwa pemberitahuan untuk pemberitahuan kecepatan dan memposting informasi pemberitahuan tersebut ke layanan pihak ketiga, seperti Discord, Slack, atau Jira.

Dengan mekanisme pemberitahuan lanjutan ini, Anda juga dapat menyesuaikan informasi yang dikirim ke layanan pihak ketiga. Misalnya, selain informasi default yang disediakan oleh Firebase, Anda juga dapat menyertakan deep link berguna ke Firebase console atau informasi pemecahan masalah spesifik per perusahaan.

Untuk menyiapkan kemampuan pemberitahuan lanjutan menggunakan Cloud Functions for Firebase, ikuti langkah-langkah berikut:

Siapkan Cloud Functions for Firebase, yang mencakup tugas berikut:
1. Menyiapkan lingkungan pengembangan untuk Node.js atau Python.
2. Menginstal dan login ke Firebase CLI.
3. Melakukan inisialisasi Cloud Functions for Firebase menggunakan CLI Firebase.
Menulis dan men-deploy fungsi yang menangkap peristiwa pemberitahuan dari Crashlytics dan menangani payload peristiwa (misalnya memposting informasi pemberitahuan dalam pesan di Discord).

Untuk mempelajari semua peristiwa pemberitahuan Crashlytics yang dapat Anda tangkap, buka dokumentasi referensi untuk pemberitahuan Crashlytics.

Pelajari lebih lanjut cara menangani pemberitahuan Crashlytics menggunakan Cloud Functions for Firebase