Powiadomienia są obecnie w wersji beta.
Powiadomienia pozwalają Ci proaktywnie monitorować krytyczne metryki wydajności dla Twojego doświadczenia i otrzymywać powiadomienia w czasie rzeczywistym, gdy przekroczą one zdefiniowane progi. Zamiast ręcznie sprawdzać pulpity nawigacyjne, możesz ustawić powiadomienia, które automatycznie poinformują Cię, gdy takie metryki jak wskaźniki awarii, zużycie pamięci lub liczba klatek na sekundę wzrosną.
Na przykład poniższy proces to typowy sposób korzystania z powiadomień, aby wychwycić regresje wydajności:
- Utwórz powiadomienie - Ustaw powiadomienie dla "Wskaźnik awarii klienta powyżej 5%" z czasem trwania 5 minut i krytycznym poziomem.
- Dodaj webhook - Połącz się z webhookiem zespołu na PagerDuty lub Discord.
- Wypuść swoją aktualizację - Wdróż swoją nową wersję.
- Otrzymaj powiadomienie - Jeśli wskaźnik awarii wzrośnie powyżej 5% przez 5 kolejnych minut, Twój zespół natychmiast otrzyma powiadomienie z wartością metryki i linkiem do pulpitu nawigacyjnego.
- 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ć Wyświetlanie wszystkich analiz uprawnienia.
- Wybierz swoje doświadczenie w Creator Hub.
- W sekcji Konfiguruj wybierz Powiadomienia.
Zakładka Konfiguracja pozwala na tworzenie i zarządzanie zasadami powiadomień. Użyj strony Analizy, aby przeglądać historię powiadomień, aktywne powiadomienia i zdarzenia.
Uprawnienia
Powiadomienia wymagają specyficznych uprawnień do różnych działań:
| Akcja | Wymagane uprawnienie |
|---|---|
| Tworzenie, edytowanie, usuwanie lub przełączanie powiadomień | Tworzenie i konfigurowanie powiadomień |
| Przeglądanie strony analizy powiadomień | Wyświetlanie wszystkich analiz |
| Tworzenie webhooków na poziomie doświadczenia | Lista, tworzenie, aktualizacja i usuwanie webhooków |
Twórz powiadomienia
Aby utworzyć powiadomienie, kliknij Utwórz na stronie konfiguracyjnej powiadomień.
Pola powiadomienia
Każde powiadomienie ma następujące opcje konfiguracyjne.
| Pole | Opis |
|---|---|
| Nazwa | Unikalna nazwa powiadomienia, która jest wyświetlana w powiadomieniach, adnotacjach i pulpitach nawigacyjnych. |
| Opis | Opcjonalny opis, aby zapewnić dodatkowy kontekst. |
| Metryka | Docelowa metryka do monitorowania. |
| Granularność czasowa | Jak często metryka jest oceniana (minuta, pół godziny, godzina lub dzień). |
| Warunek uruchomienia | Warunek, który uruchamia powiadomienie (np. wartość > 500) |
| Filtry | Opcjonalne filtry, aby zawęzić metrykę, takie jak wersja miejsca, system operacyjny lub platforma. Wspierane są wszystkie filtry dostępne na pulpicie nawigacyjnym. |
| Rozbicie | Opcjonalne rozbicie, aby sprawdzić, czy warunek jest spełniony dla każdego segmentu osobno. |
| Czas trwania | Ile razy warunek musi być spełniony kolejno przed uruchomieniem powiadomienia (1-10). |
| Poziom ważności | Poziom ważności (krytyczny, średni lub niski). |
| Kanał dostawy | Gdzie wysłać powiadomienia. Zobacz Dostawa webhooków. |
Obsługiwane metryki
Powiadomienia obsługują wszystkie metryki wydajności dostępne na Pulpicie wydajności, w tym:
- Liczba klatek klienta
- Wskaźnik awarii klienta
- Użycie pamięci klienta (GB)
- Procent użycia pamięci klienta
- Nieoczekiwane wyjścia z powodu braku pamięci
- Czas CPU serwera
- Liczba klatek serwera
- Użycie pamięci serwera (GB)
- Użytkownicy równocześnie
- Czas sesji
Warunki uruchomienia
Możesz ustawić jeden z dwóch typów warunków uruchomienia:
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 porównaniu do tego samego momentu w zeszłym tygodniu (np. 17:00 w ten piątek vs. 17:00 w zeszły piątek).
- Dzień do dnia - Sprawdza procentową zmianę w porównaniu do tego samego momentu wczoraj (np. 9:00 dzisiaj vs. 9:00 wczoraj).
- Godzina do godziny - Sprawdza procentową zmianę w porównaniu do najnowszej godziny i poprzedniej godziny (np. 9:05 vs. 8:05).
Na przykład, możesz ustawić warunek wartości metryki jak "wskaźnik awarii klienta powyżej 5%" lub warunek zmiany w okresie jak "zmiana godzinowa powyżej 50%."
Czas trwania
Ustawienie czasu trwania kontroluje, jak długo warunek uruchomienia musi być non-stop spełniony przed uruchomieniem powiadomienia. Pomaga to zmniejszyć hałas wynikający z chwilowych wahań. Jeśli wybierzesz 1, powiadomienie uruchomi się natychmiast po spełnieniu jednego punktu danych. Jeśli wybierzesz 5, pięć kolejnych punktów danych musi spełniać warunek. Dla powiadomień o granularności minutowej minimalny czas trwania wynosi 5 minut, aby zredukować hałas.
Poziomy ważności
Każde powiadomienie ma poziom ważności, który jest zawarty w wiadomości powiadomienia i wyświetlany w wyraźnym kolorze.
| Ważność | Przypadek użycia |
|---|---|
| Krytyczny | Pilne problemy wymagające natychmiastowej reakcji, takie jak wzrost wskaźnika awarii. |
| Średni | Zauważalne regresje, które powinny być szybko zbadane. |
| Niski | Drobne zmiany warte śledzenia, ale nie wymagające natychmiastowej reakcji. |
Dostawa webhooków
Powiadomienia przychodzą za pośrednictwem webhooków na poziomie doświadczenia. Gdy powiadomienie uruchamia się lub zostaje anulowane, wysyłane jest zapytanie HTTP POST do skonfigurowanego adresu URL webhooka z ładunkiem JSON. Sama wiadomość to także JSON, zawinięty w polu 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 przywrócona\",\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 "przywrócone", gdy metryka wraca do normalnego stanu.
Możesz używać webhooków do integracji z narzędziami zewnętrznymi, takimi jak PagerDuty lub Slack, dla widoczności w całym zespole.
Skonfiguruj webhook
Wybierz swoje doświadczenie w Creator Hub.
W sekcji Konfiguruj wybierz Webhooki i kliknij Dodaj Webhook.
Adres URL webhooka pochodzi od Twojego dostawcy. Na przykład, adres URL do Slacka może wyglądać tak:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXWprowadź adres URL swojego webhooka i nazwę.
(Opcjonalnie) Dołącz sekret, co może pomóc upewnić się, że zapytania, które otrzymujesz, pochodzą z Roblox.
(Opcjonalnie) Użyj przycisku Testuj odpowiedź, aby sprawdzić, czy Twoja usługa może odebrać przykładowe zapytanie.
Kliknij Zapisz zmiany.
Podczas tworzenia lub edytowania powiadomienia wybierz swój webhook w polu Kanał dostawy.
Tworzenie webhooków na poziomie doświadczenia wymaga Lista, tworzenie, aktualizacja i usuwanie webhooków uprawnienia.
Monitoruj powiadomienia
Zakładka Analizy na stronie powiadomień zapewnia scentralizowany widok historii powiadomień i aktualnego statusu:
- Uruchomione zdarzenia - Wykres pokazujący liczbę uruchomionych powiadomień w czasie. Możesz dostosować zakres czasu, wyszukiwać według nazwy powiadomienia i filtrować według ważności.
- Aktywne powiadomienia - Tabela pokazująca obecnie aktywne (uruchomione) powiadomienia.
- Historia - Chronologiczny dziennik wszystkich zdarzeń powiadomień w wybranym zakresie czasu.
Adnotacje wykresu
Gdy powiadomienie jest aktywne, na odpowiadającym wykresie metrycznym na Pulpicie wydajności pojawia się adnotacja w zakresie. Adnotacja wyświetla nazwę powiadomienia i obejmuje czas trwania okresu uruchomienia.
Adnotacje pojawiają się tylko wtedy, gdy wykres ma zastosowane te same filtry co powiadomienie. Jeśli Twoje powiadomienie ma filtry rozbicia, adnotacje wyświetlają się tylko dla linii całkowitej.
Przegląd doświadczenia
Aktywne powiadomienia (powiadomienia, które zostały uruchomione i jeszcze nie zostały przywrócone) pojawiają się w trayu powiadomień na stronie Przegląd Twojego doświadczenia. Tray pokazuje pięć najbardziej aktualnych aktywnych powiadomień z ich znacznikami czasu, nazwami i obecnymi wartościami 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 maksymalnym wykorzystaniu powiadomień i zapobieganiu zalewaniu Twoich punktów końcowych webhooków powiadomieniami:
- Zapobiegaj fałszywym alarmom za pomocą czasu trwania - Unikaj ustawiania swojego czasu trwania na 1 dla wysoce niestabilnych metryk, takich jak czas sesji. Nagły napływ graczy dołączających lub ładowanych zasobów jednocześnie może powodować chwilowe wzrosty. Ustawienie czasu trwania na 5 zapewnia, że powiadomienie uruchomi się tylko jeśli problem będzie się utrzymywał.
- Wykorzystuj segmenty rozbicia efektywnie - Zamiast tworzyć wiele indywidualnych powiadomień dla Androida, iOS i PC, możesz utworzyć jedno powiadomienie i użyć funkcji Rozbicie. Powiadomienie oceni każdą platformę osobno i określi, gdzie występuje problem w ładunku webhooka.
- Ustal najpierw bazę - Zanim ustawisz swoje progi, przeanalizuj istniejące wykresy analityczne z ostatnich 7 do 14 dni. Jeśli normalny wskaźnik awarii waha się wokół 1,2%, rozważ ustawienie progu powiadomienia na 2,5% lub 3%. Dając metrykom przestrzeń na naturalne wahania zapobiega fałszywym alarmom.
- Używaj opisowych, uporządkowanych nazw - Ponieważ nazwy powiadomień są wstrzykiwane bezpośrednio do Twoich ładunków webhooków i adnotacji, używanie jasnej formuły, takiej jak metryka - kontekst (np. Wysoki wskaźnik awarii klienta - mobilny) sprawia, że łatwo jest zespołowi zorientować się w problemach na pierwszy rzut oka.