Powiadomienia

Powiadomienia pozwalają proaktywnie monitorować krytyczne metryki wydajności i przechowywania danych dla Twojego doświadczenia oraz otrzymywać powiadomienia w czasie rzeczywistym, gdy przekroczą zdefiniowane progi. Zamiast ręcznie sprawdzać pulpity nawigacyjne, możesz ustawić powiadomienia, które automatycznie informują Cię, gdy metryki, takie jak wskaźniki awarii, zużycie pamięci stają się nadmierne lub liczba klatek na sekundę spada.

Powiadomienia są dostępne dla każdego doświadczenia, które spełnia wymagania dotyczące metryki wydajności (100+ aktywnych użytkowników dziennie).

Na przykład, poniższy proces to typowy sposób korzystania z powiadomień, aby wychwycić regresje wydajności:

1. Utwórz powiadomienie - Ustaw powiadomienie dla "Wskaźnik awarii klienta jest powyżej 5%" z czasem trwania 5 minut i krytycznym poziomem.
2. Dodaj webhook - Połącz się z webhookiem swojego zespołu w PagerDuty lub Discordzie.
3. Wdróż swoją aktualizację - Wdróż swoją nową wersję.
4. Otrzymaj powiadomienie - Jeśli wskaźnik awarii wzrośnie powyżej 5% przez 5 kolejnych minut, Twój zespół zostanie natychmiast powiadomiony o wartości metryki i linku do pulpitu nawigacyjnego.
5. Zbadaj i napraw - Kliknij link do pulpitu nawigacyjnego w ładunku webhooka, aby zobaczyć wykresy wydajności i zdiagnozować problem.

Możesz utworzyć do 20 powiadomień na doświadczenie. Tworzenie powiadomień wymaga uprawnienia Tworzenie i konfigurowanie powiadomień.

Wyświetl stronę powiadomień

Aby uzyskać dostęp do strony powiadomień, musisz być właścicielem doświadczenia lub mieć uprawnienia Wyświetlanie wszystkich analiz uprawnienia.

1. Wybierz swoje doświadczenie w Creator Hub.
2. W sekcji Konfiguracja wybierz Powiadomienia.

Zakładka Konfiguracja pozwala na tworzenie i zarządzanie regułami powiadomień. Użyj strony Analizy, aby przeglądać historię powiadomień, aktywne powiadomienia i zdarzenia.

Uprawnienia

Powiadomienia wymagają określonych uprawnień do różnych działań:

Dla doświadczeń należących do grupy, każda osoba z uprawnieniami Edytuj doświadczenie otrzymuje domyślnie uprawnienia Tworzenie i konfigurowanie powiadomień, aby zespoły mogły natychmiast rozpocząć konfigurowanie powiadomień. Jeśli chcesz ograniczyć, kto może tworzyć lub zarządzać powiadomieniami, cofnij uprawnienia dla określonych ról na stronie Uprawnienia doświadczenia. Użytkownicy, którzy mają Tworzenie i konfigurowanie powiadomień, również otrzymują domyślnie uprawnienia do zarządzania webhookami.

Tworzenie powiadomień

Aby utworzyć powiadomienie, kliknij Utwórz na stronie konfiguracji powiadomień. Możesz również utworzyć powiadomienie bezpośrednio z wykresu na Pulpicie wydajności, otwierając menu przepełnienia wykresu i wybierając Utwórz powiadomienie, co automatycznie wypełnia powiadomienie metryką i filtrami tego wykresu.

Pola powiadomienia

Każde powiadomienie ma następujące opcje konfiguracyjne.

Obsługiwane metryki

Powiadomienia obsługują wszystkie metryki wydajności dostępne na Pulpicie wydajności, w tym:

• Wskaźnik klatek klienta
• Wskaźnik awarii klienta
• Zużycie pamięci klienta (GB)
• Procent zużycia pamięci klienta
• Nieoczekiwane wyjścia z powodu braku pamięci
• Czas CPU serwera
• Wskaźnik klatek serwera
• Zużycie pamięci serwera (GB)
• Użytkownicy równocześnie
• Czas sesji

Powiadomienia obsługują również metryki przechowywania danych, dzięki czemu możesz monitorować zużycie pamięci i wydajność przechowywania danych obok wydajności czasu działania swojego doświadczenia.

Warunki wyzwalające

Możesz ustawić jeden z dwóch typów warunków wyzwalających:

• Wartość metryki - Uruchamia się, gdy metryka przekracza statyczny próg liczbowy. Wartość używa tej samej jednostki co metryka (procent, milisekundy, MB itp.).

• Zmiana w okresie - Uruchamia się, gdy wskaźnik zmiany metryki przekracza próg procentowy.

  • Tydzień do tygodnia - Sprawdza procentową zmianę w tym samym czasie w zeszłym tygodniu (np. 17:00 w ten piątek w porównaniu do 17:00 w zeszły piątek).
  • Dzień do dnia - Sprawdza procentową zmianę w tym samym czasie wczoraj (np. 9:00 dzisiaj w porównaniu do 9:00 wczoraj).
  • Godzina do godziny - Sprawdza procentową zmianę między ostatnią godziną a poprzednią godziną (np. 9:05 w porównaniu do 8:05).

Na przykład, możesz ustawić warunek wartości metryki, taki jak "wskaźnik awarii klienta jest powyżej 5%" lub warunek zmiany w okresie, taki jak "zmiana godzinowa jest powyżej 50%".

Czas trwania

Ustawienie czasu trwania kontroluje, jak długo warunek wyzwalający musi być ciągle spełniony, zanim powiadomienie zostanie uruchomione. Pomaga to zredukować hałas z chwilowych fluktuacji. Jeśli wybierzesz 1, powiadomienie uruchomi się, gdy jeden punkt danych spełni Twój warunek. Jeśli wybierzesz 5, pięć kolejnych punktów danych musi spełnić warunek. Dla powiadomień o granularności minutowej minimalny czas trwania wynosi 5 minut, aby zredukować hałas.

Poziomy powagi

Każde powiadomienie ma poziom powagi, który jest zawarty w wiadomości powiadomienia i wyświetlany w wyraźnym kolorze.

Dostawa webhooka

Powiadomienia przychodzą za pośrednictwem webhooków na poziomie doświadczenia. Gdy powiadomienie się uruchamia lub odzyskuje, wysyłane jest żądanie HTTP POST do skonfigurowanego adresu URL webhooka z ładunkiem JSON. Sama wiadomość jest również w formacie JSON, opakowana w pole AlertMessage jako pojedynczy ciąg, jak poniżej:

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

Pole AlertMessage.summary zawiera słowo "uruchomione", gdy powiadomienie się uruchamia, lub słowo "odzyskane", gdy metryka wraca do normalnego stanu.

Możesz używać webhooków do integracji z zewnętrznymi narzędziami, takimi jak PagerDuty lub Slack, aby zapewnić widoczność w całym zespole.

Ustawienie webhooka

1. Wybierz swoje doświadczenie w Creator Hub.

2. W sekcji Konfiguracja wybierz Webhooki i kliknij Dodaj webhook.

   Adres URL webhooka pochodzi od Twojego dostawcy. Na przykład, adres URL Slacka prawdopodobnie wygląda tak:

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

3. Wprowadź swój adres URL webhooka i nazwę.

4. OPCJONALNE

   Dołącz sekret, który może pomóc zapewnić, że żądania, które otrzymujesz, pochodzą z Roblox.

5. OPCJONALNE

   Użyj przycisku Testuj odpowiedź, aby sprawdzić, czy Twoja usługa może otrzymać przykładowe żądanie.

6. Kliknij Zapisz zmiany.

7. Podczas tworzenia lub edytowania powiadomienia wybierz swój webhook w polu Kanał dostawy.

Tworzenie webhooków na poziomie doświadczenia wymaga uprawnienia Lista, tworzenie, aktualizacja i usuwanie webhooków uprawnienia.

Monitorowanie powiadomień

Zakładka Analizy na stronie powiadomień zapewnia scentralizowany widok historii powiadomień i bieżącego statusu:

• Wyzwolone zdarzenia - Wykres pokazujący liczbę powiadomień uruchamianych w czasie. Możesz dostosować zakres czasowy, wyszukiwać według nazwy powiadomienia i filtrować według poziomu.
• Aktywne powiadomienia - Tabela pokazująca obecnie aktywne (uruchomione) powiadomienia.
• Historia - Chronologiczny dziennik wszystkich zdarzeń powiadomień w wybranym zakresie czasowym.

Adnotacje wykresu

Gdy powiadomienie jest aktywnie uruchamiane, na odpowiadającym wykresie metryki na Pulpicie wydajności pojawia się adnotacja zakresowa. Adnotacja wyświetla nazwę powiadomienia i obejmuje czas trwania okresu uruchamiania.

Adnotacje pojawiają się tylko wtedy, gdy wykres ma zastosowane te same filtry co powiadomienie. Jeśli Twoje powiadomienie ma filtry podziału, adnotacje wyświetlają się tylko dla linii całkowitej.

Przegląd doświadczenia

Aktywne powiadomienia (powiadomienia, które zostały uruchomione i jeszcze się nie odzyskały) pojawiają się w trayu powiadomień na stronie Przegląd Twojego doświadczenia. Tray pokazuje pięć najnowszych aktywnych powiadomień z ich znacznikami czasu, nazwą i bieżącą wartością metryki. Kliknij Zobacz wszystkie, aby przejść do pełnej strony analizy powiadomień.

Najlepsze praktyki dotyczące powiadomień

Te wskazówki mogą pomóc Ci w pełni wykorzystać powiadomienia i zapobiec zalewaniu punktów końcowych webhooków powiadomieniami:

• Zapobiegaj fałszywym alarmom za pomocą czasu trwania - Unikaj ustawiania czasu trwania na 1 dla wysoce zmiennych metryk, takich jak czas sesji. Nagły napływ graczy dołączających lub ładujących zasoby jednocześnie może powodować chwilowe wzrosty. Ustawienie czasu trwania na 5 zapewnia, że powiadomienie uruchomi się tylko wtedy, gdy problem będzie trwały.
• Wykorzystuj podziały segmentów efektywnie - Zamiast tworzyć wiele indywidualnych powiadomień dla Androida, iOS i PC, możesz stworzyć jedno powiadomienie i użyć funkcji Podział. Powiadomienie oceni każdą platformę osobno i określi, gdzie występuje problem w ładunku webhooka.
• Ustal najpierw bazę - Przed ustawieniem progów, przeglądaj istniejące wykresy analityczne z ostatnich 7 do 14 dni. Jeśli Twój normalny wskaźnik awarii oscyluje wokół 1,2%, rozważ ustawienie progu powiadomienia na 2,5% lub 3%. Dając swoim metrykom przestrzeń na naturalne fluktuacje, zapobiegasz fałszywym alarmom.
• Używaj opisowych, strukturalnych nazw - Ponieważ nazwy powiadomień są bezpośrednio wstrzykiwane do ładunków webhooków i adnotacji, używanie jasnej formuły, takiej jak metryka - kontekst (np. Wysoki wskaźnik awarii klienta - mobilny), ułatwia zespołowi szybkie triage problemów.