Uyarılar

Uyarılar, deneyiminiz için kritik performans ve veri deposu metriklerini proaktif bir şekilde izlemenizi sağlar ve tanımlı eşikleri aştıklarında gerçek zamanlı bildirimler almanızı sağlar. Panoları manuel olarak kontrol etmek yerine, çökme oranları yükseldiğinde, bellek kullanımı aşırı hale geldiğinde veya kare hızları düştüğünde otomatik olarak sizi bilgilendiren uyarılar ayarlayabilirsiniz.

Uyarılar, performans metrikleri için uygunluk gereksinimlerini karşılayan herhangi bir deneyim için mevcuttur (günde 100+ aktif kullanıcı).

Örneğin, aşağıdaki iş akışı, performans regresyonlarını 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 şiddet ile bir uyarı ayarlayın.
2. Bir webhook ekleyin - Ekibinizin PagerDuty veya Discord webhook'una bağlanın.
3. Güncellemenizi yayınlayın - 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 panoya bir bağlantı ile bilgilendirilir.
5. Araştırın ve düzeltin - Sorunu teşhis etmek için webhook yükünde panoya giden bağlantıya tıklayın.

Her deneyim için en fazla 20 uyarı oluşturabilirsiniz. Uyarı oluşturmak için Uyarıları oluşturma ve yapılandırma iznine ihtiyaç vardır.

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

Uyarılar sayfasına erişmek için ya deneyim sahibi olmalısınız ya da Tüm analitikleri görüntüle izinlerine sahip olmalısınız.

1. Creator Hub üzerinde deneyiminizi seçin.
2. Yapılandır altında Uyarılar'ı seçin.

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:

Grup sahipliğindeki deneyimler için, Deneyimi düzenle izinlerine sahip olan herkes varsayılan olarak Uyarıları oluşturma ve yapılandırma iznine sahiptir, böylece ekipler hemen uyarı ayarlamaya başlayabilir. Uyarı oluşturma veya yönetme yetkisini kısıtlamak istiyorsanız, deneyim İzinleri sayfasında belirli roller için izni geri alabilirsiniz. Uyarıları oluşturma ve yapılandırma iznine sahip kullanıcılar, varsayılan olarak webhook yönetim iznini de alır.

Uyarılar oluşturma

Bir uyarı oluşturmak için, uyarı yapılandırma sayfasında Oluştur'a tıklayın. Ayrıca, Performans panosu üzerindeki bir grafikten doğrudan bir uyarı oluşturabilirsiniz; grafiğin taşma menüsünü açarak Bir uyarı oluştur seçeneğini seçin, bu da uyarıyı o grafiğin metriği ve filtreleri ile önceden doldurur.

Uyarı alanları

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

Desteklenen metrikler

Uyarılar, Performans 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
• Beklenmedik bellek dışı çıkışlar
• Sunucu CPU süresi
• Sunucu kare hızı
• Sunucu bellek kullanımı (GB)
• Eşzamanlı kullanıcılar
• Oturum süresi

Uyarılar ayrıca veri deposu metriklerini de destekler, böylece deneyiminizin çalışma süresi performansıyla birlikte depolama kullanımını ve veri deposu performansını izleyebilirsiniz.

Tetikleme koşulları

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

• Metrik değeri - Metrik, sabit bir sayısal eşiği aştığında tetiklenir. Değer, metrikle 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 - Geçen haftaki aynı zaman arasındaki yüzde değişimini kontrol eder (örneğin, bu Cuma saat 17:00 ile geçen Cuma saat 17:00).
  • Günlük - Dün aynı zaman arasındaki yüzde değişimini kontrol eder (örneğin, bugün saat 09:00 ile dün saat 09:00).
  • Saatlik - En son saat ile önceki saat arasındaki yüzde değişimini kontrol eder (örneğin, 09:05 ile 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 değişim koşulu ayarlayabilirsiniz.

Süre

Süre ayarı, tetikleme koşulunun uyarıyı tetiklemeden önce ne kadar süreyle sürekli olarak karşılanması gerektiğini kontrol eder. Bu, anlık dalgalanmalardan kaynaklanan gürültüyü azaltmaya yardımcı olur. Eğer 1 seçerseniz, bir veri noktası koşulunuzu karşıladığında uyarı hemen tetiklenir. Eğer 5 seçerseniz, beş ardışık veri noktasının koşulu karşılaması gerekir. Dakika ayrıntılı uyarılar için, minimum süre 5 dakikadır, bu da gürültüyü azaltır.

Şiddet seviyeleri

Her uyarının, uyarı mesajında yer alan ve belirgin bir renkle gösterilen bir şiddet seviyesi vardır.

Webhook dağıtımı

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ü iletilir. Mesajın kendisi de JSON'dur ve AlertMessage alanında tek bir dize olarak sarılır, şöyle:

{
  "NotificationId": "11111abc-111a-1a2a-ab1a-abc1a1a111a1",
  "EventType": "AnalyticsAlert",
  "EventTime": "2026-06-15T22:05:10.8590762Z",
  "EventPayload": {
    "TargetType": "Universe",
    "TargetId": "1234567890",
    "AlertMessage": "{\n  \"summary\": \"[♟️] Oyun geri kazanı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ı tetiklendiğinde "tetiklendi" veya metrik normal bir duruma döndüğünde "geri kazanıldı" kelimesini içerir.

Webhook'ları, ekip genelinde görünürlük sağlamak için PagerDuty veya Slack gibi dış araçlarla entegre etmek için kullanabilirsiniz.

Webhook'u ayarlama

1. Creator Hub üzerinde deneyiminizi seçin.

2. Yapılandır 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 şöyle görünür:

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

3. Webhook URL'nizi ve bir isim girin.

4. İSTEĞE BAĞLI

   Gelen isteklerin Roblox'tan geldiğini doğrulamaya yardımcı olabilecek bir gizli anahtar ekleyin.

5. İSTEĞE BAĞLI

   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, Dağıtım kanalı alanında webhook'unuzu seçin.

Deneyim düzeyinde webhook'lar oluşturmak için Listeleme, oluşturma, güncelleme ve silme webhook'ları iznine ihtiyaç vardır.

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 - Zaman içinde tetiklenen uyarı sayısını gösteren bir grafik. Zaman aralığını ayarlayabilir, uyarı adına göre arama yapabilir ve şiddete göre filtreleyebilirsiniz.
• Aktif uyarılar - Şu anda aktif (tetiklenen) uyarıları gösteren bir tablo.
• Geçmiş - Seçilen zaman aralığındaki tüm uyarı olaylarının kronolojik kaydı.

Grafik notları

Bir uyarı aktif olarak tetiklendiğinde, Performans panosundaki ilgili metrik grafiğinde bir aralıklı not görünür. Not, uyarı adını gösterir ve tetikleme süresinin süresini kapsar.

Notlar, yalnızca grafik, uyarıyla aynı filtreler uygulandığında görünür. Eğer uyarınızın ayrıntı filtreleri varsa, notlar yalnızca toplam çizgi için görüntülenir.

Deneyim genel görünümü

Aktif uyarılar (tetiklenen ve henüz geri kazanılmamış uyarılar), deneyiminiz Genel Bakış sayfasındaki uyarı tepsisinde görünür. Tepsi, zaman damgası, isim ve mevcut metrik değeri ile birlikte en son beş aktif uyarıyı gösterir. Tümünü Görüntüle'ye tıklayarak tam uyarı analitikleri sayfasına gidebilirsiniz.

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 dolup taşmasını önlemenize yardımcı olabilir:

• Sahte alarmları önlemek için süre kullanın - Oturum süresi gibi yüksek dalgalı metrikler için sürenizi 1 olarak ayarlamaktan kaçının. Aniden oyuncuların katılması veya varlıkların yüklenmesi, geçici artışlara neden olabilir. 5 süresi ayarlamak, bir uyarının yalnızca sorun sürdüğünde tetiklenmesini sağlar.
• Segment ayrıntılarını verimli kullanın - Android, iOS ve PC için birden fazla bireysel uyarı oluşturmak yerine, tek bir uyarı oluşturabilir ve Ayrıntı özelliğini kullanabilirsiniz. Uyarı, her platformu ayrı ayrı değerlendirecek ve sorunun nerede meydana geldiğini webhook yükünde belirtecektir.
• Öncelikle bir temel oluşturun - Eşiklerinizi ayarlamadan önce, son 7 ila 14 gün boyunca mevcut analitik grafiklerinizi gözden geçirin. Normal çökme oranınız %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ış isimler kullanın - Uyarı isimleri doğrudan webhook yüklerinize ve notlarınıza enjekte edildiğinden, metrik - bağlam (örneğin, Yüksek istemci çökme oranı - mobil) gibi net bir formül kullanmak, ekibinizin sorunları hızlıca değerlendirmesini kolaylaştırır.