Raport błędów pozwala na przeglądanie błędów i ostrzeżeń systemu Luau w czasie rzeczywistym, zarówno dla serwera, jak i klienta. Monitoruj swój raport błędów przed i po aktualizacji swojego doświadczenia, aby wcześnie zidentyfikować potencjalne problemy.
Zobacz swój raport błędów
Aby zobaczyć raport błędów swojego doświadczenia:
- Przejdź do swojej strony Tworzenia w Panelu Kreatora i wybierz swoje doświadczenie.
- W sekcji Monitoring wybierz Raport błędów.
Możesz przeglądać analizy dla indywidualnych lub grupowych doświadczeń. Aby zobaczyć te drugie, musisz posiadać uprawnienia grupowe do analityki.
Monitoruj błędy i ostrzeżenia
Możesz zastosować następujące filtry i przełączniki do swojego raportu błędów:
- Zakres dat — Filtruj do ostatniej godziny, ostatniego dnia, ostatnich 7 dni lub ostatnich 30 dni.
- Miejsce — Filtruj według miejsca.
- Pokaż wersję — Dodaje adnotacje wersji miejsca do wykresu błędów i ostrzeżeń.
- Ciężkość — Filtruj, aby pokazać błędy, ostrzeżenia lub oba.
- Platforma — Filtruj, aby pokazać błędy klienta z określonych urządzeń.
- OS — Filtruj, aby pokazać błędy klienta z określonych systemów operacyjnych.
- Nowe błędy od — Filtruj, aby pokazać tylko nowe błędy i ostrzeżenia od danej wersji.
Pod filtrami i przełącznikami wykres pokazuje liczbę błędów i ostrzeżeń dla serwera, klienta oraz łączną. Użyj tego wykresu, aby zobaczyć wzrosty błędów i ostrzeżeń w czasie. Jeśli zauważysz duży wzrost w błędach i ostrzeżeniach, użyj tabeli raportu błędów do rozwiązywania problemów.
Rozwiązywanie błędów i ostrzeżeń
Tabela Błędy i ostrzeżenia ma następujące kolumny:
| Kolumna | Opis |
|---|---|
| Liczba | Liczba błędów lub ostrzeżeń. |
| Ciężkość | Etykieta błędu lub ostrzeżenia. |
| Typ | Etykieta serwera lub klienta. |
| Wiadomość | Wiadomość o błędzie lub ostrzeżeniu. |
| Pierwsze zauważono | Znacznik czasu pierwszego zauważenia wiadomości. |
| Wersja pierwsza | Dostępne tylko po wybraniu miejsca. Pokazuje pierwszą wersję, w której zarejestrowano wiadomość. |
Zobacz ślad stosu dla błędu lub ostrzeżenia
Jeśli widzisz rozwijane menu przy błędzie lub ostrzeżeniu, kliknij, aby je rozwinąć i zobaczyć jego odpowiadający ślad stosu. Ślad stosu to lista wywołań, które Twoje doświadczenie wykonywało w momencie wystąpienia wyjątku. To może pomóc w ustaleniu, co poszło nie tak.
Zasady niestandardowe
Zasady niestandardowe pozwalają zdefiniować wzorce regex lub dokładne wzorce tekstowe, aby automatycznie ignorować lub grupować błędy i ostrzeżenia. Pomaga to zarządzać stosunkiem sygnału do szumu w Twoich raportach błędów. Możesz stworzyć do 100 zasad na doświadczenie. Zasady są oceniane od góry do dołu w kolejności priorytetów. Gdy jakiś błąd pasuje do zasady, dalsze przetwarzanie jest zatrzymywane.
Działania związane z zasadami
Każda zasada ma jedną z dwóch akcji:
| Akcja | Zachowanie |
|---|---|
| Ignoruj | Ukrywa pasujące błędy z wykresu i tabeli. Używaj do trwałego szumu, takiego jak nieuniknione błędy dźwięku silnika lub staromodne instrukcje drukowania. |
| Grupuj | Konsoliduje wszystkie pasujące błędy pod jedną nazwą grupy (np. "Problemy sieciowe", "Spam audio"). Nazwa grupy pojawia się jako jeden wiersz w tabeli. |
Utwórz zasadę
Istnieją dwa sposoby na utworzenie zasady:
Z tabeli błędów (w miejscu):
- Kliknij menu kontekstowe (trzy kropki) w dowolnym wierszu błędów.
- Wybierz Ignoruj.
Z zakładki zasad:
- Przejdź do zakładki Zasady na stronie Raporty błędów.
- Kliknij Utwórz zasadę.
- Wprowadź wzór (dokładny ciąg lub regex).
- Wybierz akcję: Ignoruj lub Grupuj → [Nazwa grupy].
- Zapisz zasadę.
Pola tworzenia zasad
| Pole | Opis |
|---|---|
| Wzór | Dokładny ciąg lub wyrażenie regularne, które ma być sprawdzane pod kątem wiadomości o błędach. |
| Akcja | Wybierz Ignoruj (ukryj błąd) lub Grupuj → wprowadź niestandardową nazwę grupy. |
Zasady są oceniane od góry do dołu w oparciu o kolejność priorytetów w zakładce Zasady. Gdy błąd pasuje do zasady, akcja tej zasady zostaje wykonana, a dalsze zasady nie są oceniane dla tego błędu. Zapobiega to konfliktom, takim jak grupowanie błędu przez jedną zasadę, a następnie ignorowanie przez drugą.
Zasady wpływają tylko na błędy rejestrowane po ich zapisaniu. Adnotacja pojawia się na Twoim wykresie, gdy zasady są modyfikowane.
Podstawy wyrażeń regularnych
Wyrażenie regularne (regex) to wzór, który dopasowuje tekst:
| Składnia | Znaczenie | Przykład |
|---|---|---|
| . | Dowolny pojedynczy znak | H.t dopasowuje "Hat", "Hit", "Hot" |
| * | Zero lub więcej poprzedzającego znaku | go*d dopasowuje "gd", "god", "good" |
| + | Jeden lub więcej poprzedzającego znaku | go+d dopasowuje "god", "good", ale nie "gd" |
| .* | Dowolny ciąg znaków (wildcard) | Failed.*load dopasowuje "Failed to load" i "Failed xyz load" |
| \d | Dowolna cyfra (0-9) | v\d+ dopasowuje "v1", "v123", "v4488" |
| \w | Dowolny znak słowa (litery, cyfry, podkreślenie) | \w+ dopasowuje "Player123", "my_var" |
| ^ | Początek ciągu | ^HTTP dopasowuje błędy zaczynające się od "HTTP" |
| \/ | Uciekający ukośnik | rbxassetid:\/\/ dopasowuje "rbxassetid://" |
| \[ i \] | Uciekające nawiasy kwadratowe (dopasowanie dosłowne) | \[Knit\] dopasowuje "[Knit]" |
| (a|b) | Dopasuj "a" lub "b" | (Error|Warning):.* dopasowuje zarówno "Error: ..." jak i "Warning: ..." |
Szybkie wskazówki:
- Zacznij od dokładnego dopasowania (pełny ciąg błędu), jeśli chcesz uchwycić jeden konkretny błąd.
- Użyj regex, gdy chcesz uchwycić grupę podobnych błędów (np. wszystkie błędy ładowania dźwięku niezależnie od identyfikatora zasobu).
- Testuj swój wzór na kilku rzeczywistych ciągach błędów przed zapisem, aby upewnić się, że zarejestruje to, czego oczekujesz.
System egzekwuje dwie zasady dotyczące Twoich wzorów regex:
- Nie możesz umieszczać powtarzacza (+ lub *) wewnątrz grupy powtarzającej. Na przykład, (a+)* lub (\w+)+ są odrzucane.
- Musi zaczynać się od zakotwiczonego tekstu: Wzory nie mogą zaczynać się od wildcards, takich jak .* lub .+. Twój wzór musi zaczynać się od konkretnego znaku lub kotwicy (np. ^ lub dosłownego ciągu).
Przykłady zasad organizacji raportów błędów
Zamiast widzieć dziesiątki osobnych wierszy błędów, skonsoliduj powiązane błędy pod jedną nazwą grupy:
| Przypadek użycia | Przykłady błędów | Wzór | Akcja |
|---|---|---|---|
| Wszystkie błędy sieciowe | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Grupuj → "Problemy Sieciowe" |
| Ostrzeżenia DataStore | DataStore request was added to queue, DataStoreService: ... | DataStore | Grupuj → "Ostrzeżenia DataStore" |
| Błędy GUI gracza | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Grupuj → "Błędy PlayerGui" |
| Niestandardowy system UI | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | Grupuj → "System UI" |
Limity śledzenia błędów
System rejestruje do 500 unikalnych błędów i 500 unikalnych ostrzeżeń według liczby oraz 100 najnowszych błędów na wersję. Liczby te resetują się co 6 godzin. Aby maksymalnie wykorzystać śledzenie błędów w tych limitach:
- Usuń unikalne identyfikatory z wiadomości o błędach, takie jak identyfikatory użytkowników, współrzędne lub znaczniki czasu. Błędy takie jak Gracz 12345 nie załadowano i Gracz 67890 nie załadowano liczą się jako dwa oddzielne wpisy. Jeśli rejestrujesz je jako Gracz nie załadowano, konsolidują się w jeden wpis z wyższą liczbą.
- Używaj zasad niestandardowych, aby grupować powiązane błędy, które różnią się tylko dynamicznymi wartościami.
Rozwiązywanie błędów i ostrzeżeń
Podczas badania błędów na stronie Raporty błędów, skorzystaj z następujących metod:
- Przeglądaj ślady stosu — Rozwiń wiersze błędów, aby zobaczyć ścieżkę wywołania i zidentyfikować dokładny skrypt i numer linii, w którym wystąpił błąd.
- Sprawdź ostatnie aktualizacje — Monitoruj nowe błędy od ostatniej aktualizacji.
- Używaj wbudowanych narzędzi:
- Konsola dewelopera (F9 w doświadczeniu): Przeglądaj na żywo błędy w czasie rzeczywistym i testuj poprawki.
- Profiler skryptów: Zidentyfikuj błędy związane z wydajnością spowodowane kosztownymi operacjami.
- Okno Output w Studio — Uchwyć błędy podczas rozwoju przed publikacją.
- Używaj podziałów — Sprawdź, czy błąd jest specyficzny dla platformy (Desktop, Mobile, Console) lub OS (Windows, macOS, iOS, Android).
- Zbieraj opinie społeczności — Jeśli masz społecznościowy Discord lub post na DevForum, sprawdź, czy gracze zgłaszają problem i które urządzenia lub regiony są dotknięte.