Pemberitahuan

Pemberitahuan memungkinkan Anda untuk secara proaktif memantau metrik kinerja dan data store yang kritis untuk pengalaman Anda dan menerima notifikasi waktu nyata saat mereka melewati ambang batas yang Anda tentukan. Alih-alih memeriksa dasbor secara manual, Anda dapat mengatur pemberitahuan yang memberi tahu Anda secara otomatis ketika metrik seperti tingkat kecelakaan meningkat, penggunaan memori menjadi berlebihan, atau frame rate menurun.

Pemberitahuan tersedia untuk pengalaman apa pun yang memenuhi syarat kelayakan untuk metrik kinerja (100+ pengguna aktif harian).

Sebagai contoh, alur kerja berikut adalah cara umum menggunakan pemberitahuan untuk menangkap regresi kinerja:

1. Buat pemberitahuan - Atur pemberitahuan untuk "Tingkat kecelakaan klien di atas 5%" dengan durasi 5 menit dan tingkat keparahan kritis.
2. Tambahkan webhook - Hubungkan ke webhook PagerDuty atau Discord tim Anda.
3. Dorong pembaruan Anda - Terapkan versi baru Anda.
4. Terima pemberitahuan - Jika tingkat kecelakaan meningkat di atas 5% selama 5 menit berturut-turut, tim Anda segera diberitahu dengan nilai metrik dan tautan ke dasbor.
5. Selidiki 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 konfigurasikan pemberitahuan.

Lihat halaman pemberitahuan

Untuk mengakses halaman pemberitahuan, Anda harus menjadi pemilik pengalaman atau memiliki izin Lihat semua analitik izin.

1. Pilih pengalaman Anda di Creator Hub.
2. Di bawah Konfigurasi, pilih Pemberitahuan.

Tab Konfigurasi memungkinkan Anda untuk membuat dan mengelola aturan pemberitahuan. Gunakan halaman Analitik untuk meninjau riwayat pemberitahuan, pemberitahuan aktif, dan peristiwa.

Izin

Pemberitahuan memerlukan izin tertentu untuk berbagai tindakan:

Untuk pengalaman yang dimiliki kelompok, siapa pun dengan izin Edit pengalaman secara default diberikan Buat dan konfigurasikan pemberitahuan sehingga tim dapat segera mulai mengatur pemberitahuan. Jika Anda ingin membatasi siapa yang dapat membuat atau mengelola pemberitahuan, cabut izin untuk peran tertentu di halaman Izin pengalaman. Pengguna yang memiliki Buat dan konfigurasikan pemberitahuan juga menerima izin manajemen webhook secara default.

Buat pemberitahuan

Untuk membuat pemberitahuan, klik Buat di halaman konfigurasi pemberitahuan. Anda juga dapat membuat pemberitahuan langsung dari grafik di dasbor Kinerja dengan membuka menu overflow grafik dan memilih Buat pemberitahuan, yang akan mengisi otomatis pemberitahuan dengan metrik dan filter grafik tersebut.

Bidang Pemberitahuan

Setiap pemberitahuan memiliki opsi konfigurasi berikut.

Metrik yang Didukung

Pemberitahuan mendukung semua metrik kinerja yang tersedia di dasbor Kinerja, termasuk:

• Frame rate klien
• Tingkat kecelakaan klien
• Penggunaan memori klien (GB)
• Persentase penggunaan memori klien
• Keluaran tak terduga karena kehabisan memori
• Waktu CPU server
• Frame rate server
• Penggunaan memori server (GB)
• Pengguna bersamaan
• Waktu sesi

Pemberitahuan juga mendukung metrik data store, sehingga Anda dapat memantau penggunaan penyimpanan dan kinerja data store bersamaan dengan kinerja runtime pengalaman Anda.

Kondisi Pemicu

Anda dapat mengatur salah satu dari dua jenis kondisi pemicu:

• Nilai metrik - Memicu ketika metrik melewati ambang batas numerik statis. Nilai menggunakan satuan yang sama dengan metrik (persentase, milidetik, MB, dll.).

• Perubahan periode ke periode - Memicu ketika laju perubahan metrik melebihi ambang batas persentase.

  • Minggu ke minggu - Memeriksa perubahan persentase antara waktu yang sama minggu lalu (misalnya, 5:00 PM Jumat ini vs. 5:00 PM Jumat lalu).
  • Hari ke hari - Memeriksa perubahan persentase antara waktu yang sama kemarin (misalnya, 9:00 AM hari ini vs. 9:00 AM kemarin).
  • Jam ke jam - Memeriksa perubahan persentase antara jam terbaru dan jam sebelumnya (misalnya, 9:05 AM vs. 8:05 AM).

Sebagai contoh, Anda dapat mengatur kondisi nilai metrik seperti "tingkat kecelakaan klien di atas 5%" atau kondisi periode ke periode seperti "perubahan per jam di atas 50%."

Durasi

Pengaturan durasi mengontrol berapa lama kondisi pemicu harus terus-menerus terpenuhi sebelum pemberitahuan dipicu. Ini membantu mengurangi kebisingan dari fluktuasi sesaat. Jika Anda memilih 1, pemberitahuan dipicu segera setelah satu titik data memenuhi kondisi Anda. Jika Anda memilih 5, lima titik data berturut-turut harus memenuhi kondisi. 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.

Pengiriman Webhook

Pemberitahuan tiba melalui webhook tingkat pengalaman. Ketika pemberitahuan dipicu atau pulih, permintaan HTTP POST dikirim ke URL webhook yang telah Anda konfigurasikan dengan payload JSON. Pesan itu sendiri juga berupa JSON, dibungkus dalam bidang AlertMessage sebagai satu string, 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 has recovered\",\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 kata "dipicu" 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 tim secara luas.

Atur webhook

1. Pilih pengalaman Anda di Creator Hub.

2. 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/XXXXXXXXXXXXXXXXXXXXXXXX

3. Masukkan URL webhook Anda dan nama.

4. OPSIONAL

   Sertakan rahasia, yang dapat membantu memastikan bahwa permintaan yang Anda terima berasal dari Roblox.

5. OPSIONAL

   Gunakan tombol Uji Respons untuk memeriksa apakah layanan Anda dapat menerima permintaan contoh.

6. Klik Simpan Perubahan.

7. 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.

Pantau pemberitahuan

Tab Analitik di halaman pemberitahuan menyediakan tampilan terpusat dari riwayat pemberitahuan Anda dan status saat ini:

• Peristiwa yang dipicu - Grafik yang menunjukkan jumlah pemberitahuan yang dipicu seiring waktu. Anda dapat menyesuaikan rentang waktu, mencari berdasarkan nama pemberitahuan, dan memfilter berdasarkan tingkat keparahan.
• Pemberitahuan aktif - Tabel yang menunjukkan pemberitahuan yang saat ini aktif (dipicu).
• Riwayat - Log kronologis dari semua peristiwa pemberitahuan dalam rentang waktu yang dipilih.

Anotasi Grafik

Ketika pemberitahuan sedang aktif, anotasi rentang muncul di grafik metrik yang sesuai 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 pemecahan, anotasi ditampilkan hanya untuk garis total.

Ikhtisar Pengalaman

Pemberitahuan aktif (pemberitahuan yang telah dipicu dan belum pulih) muncul di baki pemberitahuan di halaman Ikhtisar pengalaman Anda. Baki menunjukkan lima pemberitahuan aktif terbaru dengan stempel waktu, nama, dan nilai metrik saat ini. Klik Lihat semua untuk menavigasi ke halaman analitik pemberitahuan lengkap.

Praktik Terbaik untuk Pemberitahuan

Tips ini dapat membantu Anda memaksimalkan penggunaan pemberitahuan dan mencegah titik akhir webhook Anda dibanjiri dengan notifikasi:

• Cegah alarm palsu dengan durasi - Hindari mengatur durasi Anda ke 1 untuk metrik yang sangat fluktuatif seperti waktu sesi. Lonjakan mendadak pemain yang bergabung atau memuat aset secara bersamaan dapat menyebabkan lonjakan sementara. Mengatur durasi 5 memastikan pemberitahuan hanya dipicu jika masalah berlanjut.
• Gunakan pemecahan segmen secara efisien - Alih-alih membuat beberapa pemberitahuan individu untuk Android, iOS, dan PC, Anda dapat membuat satu pemberitahuan dan menggunakan fitur Pemecahan. Pemberitahuan akan mengevaluasi setiap platform secara terpisah dan menentukan 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 kecelakaan normal Anda berkisar sekitar 1,2%, pertimbangkan untuk mengatur ambang batas pemberitahuan Anda ke 2,5% atau 3%. Memberikan ruang bagi 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 kecelakaan klien - mobile) memudahkan tim Anda untuk menanggapi masalah dengan cepat.