Pemberitahuan saat ini dalam versi beta.
Pemberitahuan memungkinkan Anda untuk secara proaktif memantau metrik kinerja kritis untuk pengalaman Anda dan menerima notifikasi waktu nyata ketika mereka melampaui ambang batas yang Anda tetapkan. Alih-alih memeriksa dasbor secara manual, Anda dapat mengatur pemberitahuan yang memberi tahu Anda secara otomatis ketika metrik seperti tingkat crash, penggunaan memori yang berlebihan, atau penurunan frame rate terjadi.
Sebagai contoh, alur kerja berikut adalah cara umum menggunakan pemberitahuan untuk menangkap regresi kinerja:
- Buat pemberitahuan - Atur pemberitahuan untuk "Tingkat crash klien di atas 5%" dengan durasi 5 menit dan tingkat keparahan kritis.
- Tambahkan webhook - Hubungkan ke webhook PagerDuty atau Discord tim Anda.
- Dorong pembaruan Anda - Terapkan versi baru Anda.
- Terima pemberitahuan - Jika tingkat crash naik di atas 5% selama 5 menit berturut-turut, tim Anda segera diberitahu dengan nilai metrik dan tautan ke dasbor.
- Investigasi dan perbaiki - Klik tautan dasbor dalam payload webhook untuk melihat grafik kinerja dan mendiagnosis masalah.
Anda dapat membuat hingga 20 pemberitahuan per pengalaman. Membuat pemberitahuan memerlukan izin Buat dan konfigurasi pemberitahuan.
Lihat halaman pemberitahuan
Untuk mengakses halaman pemberitahuan, Anda harus menjadi pemilik pengalaman atau memiliki izin Lihat semua analitik izin.
- Pilih pengalaman Anda di Creator Hub.
- Di bawah Konfigurasi, pilih Pemberitahuan.
Tab Konfigurasi memungkinkan Anda membuat dan mengelola aturan pemberitahuan. Gunakan halaman Analitik untuk meninjau riwayat pemberitahuan, pemberitahuan aktif, dan peristiwa.
Izin
Pemberitahuan memerlukan izin tertentu untuk berbagai tindakan:
| Tindakan | Izin yang dibutuhkan |
|---|---|
| Buat, edit, hapus, atau alihkan pemberitahuan | Buat dan konfigurasi pemberitahuan |
| Lihat halaman analitik pemberitahuan | Lihat semua analitik |
| Buat webhook tingkat pengalaman | Daftar, buat, perbarui, dan hapus webhook |
Buat pemberitahuan
Untuk membuat pemberitahuan, klik Buat di halaman konfigurasi pemberitahuan.
Bidang pemberitahuan
Setiap pemberitahuan memiliki opsi konfigurasi berikut.
| Bidang | Deskripsi |
|---|---|
| Nama | Nama unik untuk pemberitahuan yang ditampilkan pada notifikasi, anotasi, dan dasbor. |
| Deskripsi | Deskripsi opsional untuk memberikan konteks tambahan. |
| Metrik | Metrik target untuk dipantau. |
| Granularitas waktu | Seberapa sering metrik dievaluasi (menit, setengah jam, per jam, atau harian). |
| Kondisi pemicu | Kondisi yang memicu pemberitahuan (misalnya, nilai > 500) |
| Filter | Filter opsional untuk mempersempit metrik, seperti versi tempat, sistem operasi, atau platform. Semua filter yang tersedia di dasbor didukung. |
| Pemisahan | Pemisahan opsional untuk memeriksa apakah kondisi dipenuhi untuk setiap segmen secara terpisah. |
| Durasi | Seberapa sering kondisi harus dipenuhi secara berturut-turut sebelum pemberitahuan memicu (1-10). |
| Keparahan | Tingkat keparahan (kritis, sedang, atau rendah). |
| Saluran pengiriman | Tempat untuk mengirim pemberitahuan. Lihat Pengiriman Webhook. |
Metrik yang Didukung
Pemberitahuan mendukung semua metrik kinerja yang tersedia di dasbor Kinerja, termasuk:
- Frame rate klien
- Tingkat crash klien
- Penggunaan memori klien (GB)
- Persentase penggunaan memori klien
- Keluar tak terduga karena kehabisan memori
- Waktu CPU server
- Frame rate server
- Penggunaan memori server (GB)
- Pengguna bersamaan
- Waktu sesi
Kondisi Pemicu
Anda dapat menetapkan salah satu dari dua jenis kondisi pemicu:
Nilai metrik - Memicu ketika metrik melampaui ambang batas numerik statis. Nilai menggunakan satuan yang sama dengan metrik (persentase, milidetik, MB, dll.).
Perubahan per periode - Memicu ketika tingkat perubahan metrik melebihi ambang batas persentase.
- Minggu ke minggu - Memeriksa perubahan persentase antara waktu yang sama minggu lalu (misalnya, 17:00 Jumat ini dibandingkan dengan 17:00 Jumat lalu).
- Hari ke hari - Memeriksa perubahan persentase antara waktu yang sama kemarin (misalnya, 09:00 hari ini dibandingkan dengan 09:00 kemarin).
- Jam ke jam - Memeriksa perubahan persentase antara jam terakhir dan jam sebelumnya (misalnya, 09:05 vs. 08:05).
Sebagai contoh, Anda dapat menetapkan kondisi nilai metrik seperti "tingkat crash klien di atas 5%" atau kondisi per periode seperti "perubahan per jam di atas 50%."
Durasi
Pengaturan durasi mengontrol berapa lama kondisi pemicu harus terpenuhi secara terus-menerus sebelum pemberitahuan memicu. Ini membantu mengurangi kebisingan dari fluktuasi sementara. Jika Anda memilih 1, pemberitahuan akan memicu segera setelah satu titik data memenuhi kondisi Anda. Jika Anda memilih 5, lima titik data berturut-turut harus memenuhi kondisi tersebut. Untuk pemberitahuan dengan granularitas menit, durasi minimum adalah 5 menit untuk mengurangi kebisingan.
Tingkat Keparahan
Setiap pemberitahuan memiliki tingkat keparahan yang disertakan dalam pesan pemberitahuan dan ditampilkan dengan warna yang berbeda.
| Keparahan | Kasus penggunaan |
|---|---|
| Kritis | Masalah mendesak yang memerlukan tindakan segera, seperti lonjakan tingkat crash. |
| Sedang | Regresi yang signifikan yang harus segera diinvestigasi. |
| Rendah | Perubahan kecil yang layak dilacak tetapi tidak segera dapat ditindaklanjuti. |
Pengiriman Webhook
Pemberitahuan tiba melalui webhook tingkat pengalaman. Ketika pemberitahuan memicu atau pulih, permintaan HTTP POST dikirim ke URL webhook yang telah Anda konfigurasikan dengan payload JSON. Pesan itu sendiri juga berupa JSON, dibungkus ke dalam bidang AlertMessage sebagai string tunggal, seperti ini:
{
"NotificationId": "11111abc-111a-1a2a-ab1a-abc1a1a111a1",
"EventType": "AnalyticsAlert",
"EventTime": "2026-06-15T22:05:10.8590762Z",
"EventPayload": {
"TargetType": "Universe",
"TargetId": "1234567890",
"AlertMessage": "{\n \"summary\": \"[♟️] Game telah pulih\",\n \"metric\": \"PeakConcurrentPlayers\",\n \"universe_id\": \"1234567890\",\n \"evaluation_time_utc\": \"2026-06-15T22:04:47Z\",\n \"alert_history\": \"https://create.roblox.com/dashboard/creations/experiences/1234567890/alerts?tab=AlertConfiguration-Analytics&utm_medium=webhook&utm_campaign=alert_resolved\"\n}"
}
}
Bidang AlertMessage.summary mencakup baik kata "memicu" ketika pemberitahuan memicu atau kata "pulih" ketika metrik kembali ke keadaan normal.
Anda dapat menggunakan webhook untuk mengintegrasikan dengan alat eksternal seperti PagerDuty atau Slack untuk visibilitas seluruh tim.
Atur webhook
Pilih pengalaman Anda di Creator Hub.
Di bawah Konfigurasi, pilih Webhook dan klik Tambahkan Webhook.
URL webhook berasal dari penyedia Anda. Misalnya, URL Slack mungkin terlihat seperti ini:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXMasukkan URL webhook Anda dan nama.
(Opsional) Sertakan rahasia, yang dapat membantu memastikan bahwa permintaan yang Anda terima berasal dari Roblox.
(Opsional) Gunakan tombol Uji Respon untuk memeriksa apakah layanan Anda dapat menerima permintaan sampel.
Klik Simpan Perubahan.
Saat membuat atau mengedit pemberitahuan, pilih webhook Anda di bawah bidang Saluran pengiriman.
Membuat webhook tingkat pengalaman memerlukan izin Daftar, buat, perbarui, dan hapus webhook izin.
Monitor pemberitahuan
Tab Analitik pada halaman pemberitahuan menyediakan tampilan terpusat dari riwayat pemberitahuan Anda dan status saat ini:
- Peristiwa yang dipicu - Sebuah grafik yang menunjukkan jumlah pemberitahuan yang terpicu seiring waktu. Anda dapat menyesuaikan rentang waktu, mencari berdasarkan nama pemberitahuan, dan menyaring berdasarkan tingkat keparahan.
- Pemberitahuan aktif - Tabel yang menunjukkan pemberitahuan yang saat ini aktif (terpicu).
- Riwayat - Catatan kronologis tentang semua peristiwa pemberitahuan dalam rentang waktu yang dipilih.
Anotasi grafik
Ketika sebuah pemberitahuan sedang aktif, anotasi rentang muncul di grafik metrik yang terkait di dasbor Kinerja. Anotasi menampilkan nama pemberitahuan dan mencakup durasi periode pemicu.
Anotasi hanya muncul ketika grafik memiliki filter yang sama diterapkan seperti pemberitahuan. Jika pemberitahuan Anda memiliki filter pemisahan, anotasi ditampilkan hanya untuk garis total.
Ikhtisar pengalaman
Pemberitahuan aktif (pemberitahuan yang telah terpicu dan belum pulih) muncul di baki pemberitahuan pada halaman Ikhtisar pengalaman Anda. Baki menunjukkan lima pemberitahuan aktif terbaru dengan cap waktu, nama, dan nilai metrik saat ini. Klik Lihat semua untuk menjelajahi halaman analitik pemberitahuan lengkap.
Praktik terbaik untuk pemberitahuan
Tips ini dapat membantu Anda memanfaatkan pemberitahuan dengan sebaik-baiknya dan mencegah endpoint webhook Anda dibanjiri dengan notifikasi:
- Cegah alarm palsu dengan durasi - Hindari mengatur durasi Anda ke 1 untuk metrik yang sangat berfluktuasi seperti waktu sesi. Lonjakan mendadak pemain yang bergabung atau memuat aset secara bersamaan dapat menyebabkan lonjakan sementara. Mengatur durasi 5 memastikan pemberitahuan hanya terpicu jika masalah dipelihara.
- Gunakan pemisahan segmen secara efisien - Alih-alih membuat beberapa pemberitahuan individu untuk Android, iOS, dan PC, Anda dapat membuat satu pemberitahuan dan menggunakan fitur Pemisahan. Pemberitahuan akan mengevaluasi setiap platform secara terpisah dan menyebutkan di mana masalah terjadi dalam payload webhook.
- Tentukan baseline terlebih dahulu - Sebelum mengatur ambang batas Anda, tinjau grafik analitik yang ada selama 7 hingga 14 hari terakhir. Jika tingkat crash normal Anda berkisar sekitar 1,2%, pertimbangkan untuk mengatur ambang batas pemberitahuan Anda menjadi 2,5% atau 3%. Memberikan ruang kepada metrik Anda untuk fluktuasi alami mencegah alarm palsu.
- Gunakan nama yang deskriptif dan terstruktur - Karena nama pemberitahuan disuntikkan langsung ke dalam payload webhook dan anotasi Anda, menggunakan formula yang jelas seperti metrik - konteks (misalnya, Tinggi tingkat crash klien - mobile) memudahkan tim Anda untuk melakukan triase masalah sekilas.