Uyarılar

Uyarılar, deneyiminiz için kritik performans metriklerini proaktif bir şekilde izlemenizi sağlar ve tanımlı eşiklerinizi aştığında gerçek zamanlı bildirimler almanızı sağlar. Gösterge panolarını manuel olarak kontrol etmek yerine, çökme oranları yükseldiğinde, bellek kullanımı aşırıya gittiğinde veya kare hızları düştüğünde otomatik olarak sizi uyaran uyarılar ayarlayabilirsiniz.

Örneğin, aşağıdaki iş akışı, performans gerilemelerini yakalamak için uyarıların tipik bir kullanım şeklidir:

1. Bir uyarı oluşturun - "İstemci çökme oranı %5'in üzerinde" için 5 dakikalık bir süre ve kritik seviye ile bir uyarı ayarlayın.
2. Bir webhook ekleyin - Ekibinizin PagerDuty veya Discord webhook'una bağlanın.
3. Güncellemelerinizi gönderin - Yeni sürümünüzü dağıtın.
4. Uyarıyı alın - Eğer çökme oranı 5 dakika boyunca %5'in üzerine çıkarsa, ekibiniz hemen metrik değeri ve gösterge panosuna bir bağlantı ile bilgilendirilir.
5. Araştırın ve düzeltin - Webhook yükünde gösterge panosu bağlantısına tıklayarak performans grafikleriyle sorunu teşhis edin.

Deneyim başına en fazla 20 uyarı oluşturabilirsiniz. Uyarı oluşturmak, Uyarıları oluşturma ve yapılandırma iznine ihtiyaç duyar.

Uyarılar sayfasını görüntüleme

Uyarılar sayfasına erişmek için ya deneyim sahibi olmanız ya da Tüm analitikleri görüntüleme izinlerine sahip olmanız gerekir.

1. Creator Hub 'da deneyiminizi seçin.
2. Yapılandır kısmının altında Uyarılar seçeneğini tıklayın.

Yapılandırma sekmesi, uyarı kurallarını oluşturmanıza ve yönetmenize olanak tanır. Analitik sayfasını kullanarak uyarı geçmişini, aktif uyarıları ve olayları gözden geçirebilirsiniz.

İzinler

Uyarılar, farklı eylemler için belirli izinler gerektirir:

Uyarılar oluşturma

Bir uyarı oluşturmak için, uyarı yapılandırma sayfasında Oluştur'a tıklayın.

Uyarı alanları

Her uyarının aşağıdaki yapılandırma seçenekleri vardır.

Desteklenen metrikler

Uyarılar, Performans gösterge panosu üzerinde mevcut olan tüm performans metriklerini destekler, bunlar arasında:

• İstemci kare hızı
• İstemci çökme oranı
• İstemci bellek kullanımı (GB)
• İstemci bellek kullanımı yüzdesi
• Beklenmeyen bellek dışı çıkışlar
• Sunucu CPU zamanı
• Sunucu kare hızı
• Sunucu bellek kullanımı (GB)
• Eş zamanlı kullanıcılar
• Oturum süresi

Tetkik koşulları

İki tetkik koşulu türünden birini ayarlayabilirsiniz:

• Metrik değeri - Metrik sabit sayısal bir eşiği aştığında tetiklenir. Değer, metrik ile aynı birimi kullanır (yüzde, milisaniye, MB vb.).

• Dönemsel değişim - Metrik değişim oranı bir yüzde eşiğini aştığında tetiklenir.

  • Haftalık değişim - Geçen haftanın aynı zamanı arasındaki yüzde değişimi kontrol eder (örn. bu Cuma 17:00 vs. geçen Cuma 17:00).
  • Günlük değişim - Dün aynı saat ile bugünün aynı saati arasındaki yüzde değişimi kontrol eder (örn. bugün 09:00 vs. dün 09:00).
  • Saatlik değişim - En son saat ile önceki saat arasındaki yüzde değişimi kontrol eder (örn. 09:05 vs. 08:05).

Örneğin, "istemci çökme oranı %5'in üzerinde" gibi bir metrik değeri koşulu veya "saatlik değişim %50'nin üzerinde" gibi bir dönemsel koşul ayarlayabilirsiniz.

Süre

Süre ayarı, tetkik koşulunun sürekli olarak karşılanması gereken süreyi kontrol eder. Bu, anlık dalgalanmalardan kaynaklanan gürültüyü azaltmaya yardımcı olur. 1 seçerseniz, bir veri noktası koşulunuzu karşıladığı anda uyarı tetiklenir. 5 seçerseniz, beş ardışık veri noktası koşulu karşılamak zorundadır. Dakika granülaritesine sahip uyarılar için, gürültüyü azaltmak amacıyla minimum süre 5 dakikadır.

Şiddet seviyeleri

Her uyarının, uyarı mesajı içinde yer alan ve belirgin bir renkle görüntülenen bir şiddet seviyesi vardır.

Webhook İletimi

Uyarılar, deneyim düzeyinde webhook'lar aracılığıyla gelir. Bir uyarı tetiklendiğinde veya geri alındığında, yapılandırdığınız webhook URL'sine bir HTTP POST isteği gönderilir ve bir JSON yükü içerir. Mesajın kendisi de AlertMessage alanında tek bir dize olarak sarılmış olan JSON'dur, aşağıdaki gibi:

{
  "NotificationId": "11111abc-111a-1a2a-ab1a-abc1a1a111a1",
  "EventType": "AnalyticsAlert",
  "EventTime": "2026-06-15T22:05:10.8590762Z",
  "EventPayload": {
    "TargetType": "Universe",
    "TargetId": "1234567890",
    "AlertMessage": "{\n  \"summary\": \"[♟️] Oyun kurtarıldı\",\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}"
  }
}

AlertMessage.summary alanı, uyarının tetiklendiği zaman "ateşlendi" kelimesini veya metrik normal duruma döndüğünde "kurtarıldı" kelimesini içerir.

Webhook'ları, ekibin geniş görünürlüğü için PagerDuty veya Slack gibi harici araçlarla entegre etmek için kullanabilirsiniz.

Webhook'u ayarlama

1. Creator Hub 'da deneyiminizi seçin.

2. Yapılandır kısmının altında Webhook'lar'ı seçin ve Webhook Ekle'ye tıklayın.

   Webhook URL'si sağlayıcınızdan gelir. Örneğin, bir Slack URL'si muhtemelen şu şekilde görünür:

   https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

3. Webhook URL'nizi ve bir ad girin.

4. (İsteğe bağlı) Süreçlerinizi Roblox'tan geldiğini doğrulamaya yardımcı olacak bir gizli anahtar ekleyin.

5. (İsteğe bağlı) Hizmetinizin bir örnek isteği alıp almadığını kontrol etmek için Test Yanıtı butonunu kullanın.

6. Değişiklikleri Kaydet'e tıklayın.

7. Bir uyarı oluştururken veya düzenlerken, İletim kanalı alanında webhook'unuzu seçin.

Deneyim düzeyinde webhook'lar oluşturma, Listeleme, oluşturma, güncelleme ve silme webhook'ları iznine ihtiyaç duyar.

Uyarıları izleme

Uyarılar sayfasındaki Analitik sekmesi, uyarı geçmişinizin ve mevcut durumunuzun merkezi bir görünümünü sağlar:

• Tetkik edilen olaylar - Zamanla tetiklenen uyarı sayısını gösteren bir grafik. Zaman dilimini ayarlayabilir, uyarı adını arayabilir ve şiddete göre filtreleme yapabilirsiniz.
• Aktif uyarılar - Şu anda aktif (tetiklenen) uyarıları gösteren bir tablo.
• Geçmiş - Seçilen zaman dilimi içerisindeki tüm uyarı olaylarının kronolojik kaydı.

Grafik açıklamaları

Bir uyarı aktif olarak tetiklendiğinde, Performans gösterge panosundaki ilgili metrik grafiğinde bir açıklama görünür. Açıklama, uyarı adını gösterir ve tetiklenme süresini kapsar.

Açıklamalar, yalnızca grafik aynı filtrelerin uygulandığı zaman görünür. Uyarınızda ayrıntılandırma filtreleri varsa, açıklamalar yalnızca toplam çizgi için görüntülenir.

Deneyim Genel Görünümü

Aktif uyarılar (tetiklenen ve henüz geri alınmayan uyarılar), deneyiminiz Genel Görünüm sayfasındaki uyarı tepsisinde görünür. Tepsi, en son beş aktif uyarıyı zaman damgası, adı ve mevcut metrik değeri ile gösterir. Tam uyarı analitikleri sayfasına gitmek için Tümünü görüntüle'ye tıklayın.

Uyarılar için en iyi uygulamalar

Bu ipuçları, uyarılardan en iyi şekilde yararlanmanıza ve webhook uç noktalarınızın bildirimlerle dolmasını önlemenize yardımcı olabilir:

• Sahte alarmları önlemek için süre kullanın - Oturum süresi gibi son derece dalgalı metrikler için sürenizi 1 olarak ayarlamaktan kaçının. Aniden birden fazla oyuncunun girmesi veya varlıkların aynı anda yüklenmesi, geçici artışlara neden olabilir. 5 süresi ayarlamak, yalnızca sorun sürdüğünde bir uyarının tetiklenmesini sağlar.
• Segment ayrıntılandırmalarını verimli kullanan - Android, iOS ve PC için birden fazla bireysel uyarı oluşturmak yerine, tek bir uyarı oluşturabilir ve Ayrıntılandırma özelliğini kullanabilirsiniz. Uyarı, her platformu ayrı ayrı değerlendirecek ve sorunun nerede meydana geldiğini webhook yükünde belirtecektir.
• Önce bir temel oluşturun - Eşiklerinizi ayarlamadan önce mevcut analitik grafiklerinizi son 7 ila 14 gün üzerinden gözden geçirin. Normal çökme oranınız yaklaşık %1,2 civarındaysa, uyarı eşiklerinizi %2,5 veya %3 olarak ayarlamayı düşünün. Metriklerinize doğal dalgalanmalar için alan tanımak, sahte alarmları önler.
• Açıklayıcı, yapılandırılmış adlar kullanın - Uyarı adları doğrudan webhook yüklerinize ve açıklamalarınıza enjekte edildiğinden, metrik - bağlam (örn. Yüksek istemci çökme oranı - mobil) gibi açık bir formül kullanmak, ekibinizin sorunları anlık olarak daha kolay sıralamasını sağlar.