Fehlerbericht ermöglicht es Ihnen, die aktuellen Luau-Systemfehler und -warnungen sowohl für Server als auch für Clients einzusehen. Überwachen Sie Ihren Fehlerbericht vor und nach der Aktualisierung Ihres Spiels, um potenzielle Probleme frühzeitig zu identifizieren.
Ihren Fehlerbericht anzeigen
Um den Fehlerbericht Ihres Spiels anzuzeigen:
- Navigieren Sie zu Ihrer Erstellungs-Seite im Creator Dashboard und wählen Sie Ihr Spiel aus.
- Wählen Sie unter Überwachung Fehlerbericht aus.
Sie können Analysen für individuelle oder gruppeneigene Erfahrungen einsehen. Um Letzteres zu tun, müssen Sie Gruppenerlaubnisse für Analysen haben.
Fehler und Warnungen überwachen
Sie können die folgenden Filter und Schalter auf Ihren Fehlerbericht anwenden:
- Datumsbereich — Filter für die letzten 1 Stunde, letzten 1 Tag, letzten 7 Tage oder letzten 30 Tage.
- Platz — Nach Ort filtern.
- Version anzeigen — Fügt dem Diagramm für Fehler und Warnungen Versionsannotationen hinzu.
- Schweregrad — Filter zum Anzeigen von Fehlern, Warnungen oder beidem.
- Plattform — Filter, um Client-Fehler von bestimmten Geräten anzuzeigen.
- Betriebssystem — Filter, um Client-Fehler von bestimmten Betriebssystemen anzuzeigen.
- Neue Fehler seit — Filter, um nur neue Fehler und Warnungen seit einer bestimmten Version anzuzeigen.
Unter den Filtern und Schaltern zeigt ein Diagramm die Anzahl der Fehler und Warnungen für Server, Client und insgesamt an. Nutzen Sie dieses Diagramm, um nach Anstiegen von Fehlern und Warnungen im Laufe der Zeit zu suchen. Wenn Sie einen großen Anstieg von Fehlern und Warnungen feststellen, verwenden Sie die Fehlerbericht-Tabelle zur Fehlersuche.
Fehler und Warnungen beheben
Die Tabelle Fehler und Warnungen hat die folgenden Spalten:
| Spalte | Beschreibung |
|---|---|
| Anzahl | Anzahl der Fehler oder Warnungen. |
| Schweregrad | Fehler- oder Warnungsbezeichnung. |
| Typ | Server- oder Client-Bezeichnung. |
| Nachricht | Fehler- oder Warnmeldungsnachricht. |
| Erstmals gesehen | Erstmals gesehener Zeitstempel der Nachricht. |
| Erstmals gesehene Version | Nur verfügbar, wenn ein Ort ausgewählt ist. Zeigt die erste Version an, in der die Nachricht aufgezeichnet wurde. |
Den Stack-Trace für einen Fehler oder eine Warnung anzeigen
Wenn Sie ein Dropdown-Menü bei einem Fehler oder einer Warnung sehen, klicken Sie darauf, um es zu erweitern und den entsprechenden Stack-Trace zu sehen. Ein Stack-Trace ist eine Liste der Aufrufe, die Ihr Spiel gemacht hat, als die Ausnahme ausgelöst wurde. Dies kann Ihnen helfen herauszufinden, was schiefgeht.
Benutzerdefinierte Regeln
Benutzerdefinierte Regeln ermöglichen es Ihnen, Regex- oder genaue Zeichenfolgenmuster zu definieren, um automatisch Fehler und Warnungen zu ignorieren oder zu gruppieren. Dies hilft Ihnen, das Verhältnis von Signal zu Rauschen in Ihren Fehlerberichten zu verwalten. Sie können bis zu 100 Regeln pro Erfahrung erstellen. Regeln werden von oben nach unten in der Prioritätsreihenfolge ausgewertet. Sobald ein Fehler mit einer Regel übereinstimmt, wird die weitere Verarbeitung gestoppt.
Regelaktionen
Jede Regel hat eine von zwei Aktionen:
| Aktion | Verhalten |
|---|---|
| Ignorieren | Blendet übereinstimmende Fehler aus dem Diagramm und der Tabelle aus. Verwenden Sie dies für permanentes Rauschen, wie unvermeidbare Engine-Soundfehler oder veraltete Druckanweisungen. |
| Gruppieren | Konsolidiert alle übereinstimmenden Fehler unter einem benutzerdefinierten Gruppennamen (z.B. "Netzwerkprobleme", "Audio-Spam"). Der Gruppenname erscheint als einzelne Zeile in der Tabelle. |
Eine Regel erstellen
Es gibt zwei Möglichkeiten, eine Regel zu erstellen:
Aus der Fehler-Tabelle (inline):
- Klicken Sie auf das Kontextmenü (drei Punkte) in einer beliebigen Fehlerzeile.
- Wählen Sie Ignorieren aus.
Aus dem Reiter für Regeln:
- Navigieren Sie zum Reiter Regeln auf der Seite Fehlerberichte.
- Klicken Sie auf Regel erstellen.
- Geben Sie ein Muster ein (exakte Zeichenfolge oder Regex).
- Wählen Sie eine Aktion: Ignorieren oder Gruppieren → [Gruppenname].
- Speichern Sie die Regel.
Regel-Erstellungsfelder
| Feld | Beschreibung |
|---|---|
| Muster | Die exakte Zeichenfolge oder reguläre Ausdruck, die mit Fehlermeldungen übereinstimmen soll. |
| Aktion | Wählen Sie Ignorieren (Fehler ausblenden) oder Gruppieren → geben Sie einen benutzerdefinierten Gruppennamen ein. |
Regeln werden von oben nach unten in der Prioritätsreihenfolge im Regeln-Reiter ausgewertet. Sobald ein Fehler mit einer Regel übereinstimmt, wird die Aktion dieser Regel ausgeführt und keine weiteren Regeln werden für diesen Fehler ausgewertet. Dies verhindert Konflikte, z.B. dass ein Fehler von einer Regel gruppiert und dann von einer nachfolgenden Regel ignoriert wird.
Regeln wirken sich nur auf Fehler aus, die nach ihrer Speicherung protokolliert werden. Eine Annotation erscheint in Ihrem Diagramm, wenn Regeln geändert werden.
Grundlagen des regulären Ausdrucks
Ein regulärer Ausdruck (Regex) ist ein Muster, das Text übereinstimmt:
| Syntax | Bedeutung | Beispiel |
|---|---|---|
| . | Jedes einzelne Zeichen | H.t stimmt mit "Hat", "Hit", "Hot" überein |
| * | Null oder mehr des vorhergehenden Zeichens | go*d stimmt mit "gd", "god", "good" überein |
| + | Eins oder mehr des vorhergehenden Zeichens | go+d stimmt mit "god", "good", jedoch nicht mit "gd" |
| .* | Jede Zeichenfolge (Wildcard) | Failed.*load stimmt mit "Failed to load" und "Failed xyz load" |
| \d | Jede Ziffer (0-9) | v\d+ stimmt mit "v1", "v123", "v4488" |
| \w | Jedes Wortzeichen (Buchstaben, Ziffern, Unterstrich) | \w+ stimmt mit "Player123", "my_var" |
| ^ | Anfang der Zeichenfolge | ^HTTP stimmt mit Fehlern, die mit "HTTP" beginnen |
| \/ | Ein entkommener Schrägstrich | rbxassetid:\/\/ stimmt mit "rbxassetid://" überein |
| \[ und \] | Entkommene eckige Klammern (wörtliche Übereinstimmung) | \[Knit\] stimmt mit "[Knit]" überein |
| (a|b) | Übereinstimmung mit "a" oder "b" | (Error|Warning):.* stimmt sowohl mit "Error: ..." als auch "Warning: ..." überein |
Schnelle Tipps:
- Beginnen Sie mit einer genauen Übereinstimmung (der vollständigen Fehlermeldung), wenn Sie nur einen bestimmten Fehler erfassen möchten.
- Verwenden Sie einen Regex, wenn Sie eine Familie ähnlicher Fehler erfassen möchten (z.B. alle Fehler beim Laden von Sounds, unabhängig von der Asset-ID).
- Testen Sie Ihr Muster mit einigen tatsächlichen Fehlermeldungen, bevor Sie speichern, um sicherzustellen, dass es das erfasst, was Sie erwarten.
Das System erzwingt zwei Regeln für Ihre Regex-Muster:
- Sie können keinen Wiederholer (+ oder *) innerhalb einer wiederholenden Gruppe setzen. Zum Beispiel werden (a+)* oder (\w+)+ abgelehnt.
- Muss mit verankertem Text beginnen: Muster dürfen nicht mit einem Platzhalter wie .* oder .+ beginnen. Ihr Muster muss mit einem konkreten Zeichen oder Anker (wie ^ oder einer wörtlichen Zeichenfolge) beginnen.
Regelbeispiele zur Organisation Ihrer Fehlerberichte
Anstatt Dutzende von separaten Fehlerzeilen zu sehen, konsolidieren Sie verwandte Fehler unter einem Gruppennamen:
| Anwendungsfall | Beispiel Fehler | Muster | Aktion |
|---|---|---|---|
| Alle Netzwerkfehler | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Gruppieren → "Netzwerkprobleme" |
| DataStore-Warnungen | DataStore request was added to queue, DataStoreService: ... | DataStore | Gruppieren → "DataStore-Warnungen" |
| Spieler-GUI-Fehler | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Gruppieren → "PlayerGui-Fehler" |
| Benutzerdefiniertes UI-Framework | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | Gruppieren → "UI-System" |
Fehlerverfolgungsgrenzen
Das System verfolgt bis zu 500 eindeutige Fehler und 500 eindeutige Warnungen nach Anzahl sowie die 100 neuesten Fehler pro Version. Diese Zählungen werden alle 6 Stunden zurückgesetzt. Um die nützliche Fehlerverfolgung innerhalb dieser Grenzen zu maximieren:
- Entfernen Sie eindeutige Identifikatoren aus Fehlermeldungen, wie Benutzer-IDs, Koordinaten oder Zeitstempel. Fehler wie Player 12345 konnte nicht geladen werden und Player 67890 konnte nicht geladen werden zählen als zwei separate Einträge. Wenn Sie sie als Player konnte nicht geladen werden protokollieren, konsolidieren sie sich zu einem Eintrag mit einer höheren Anzahl.
- Verwenden Sie benutzerdefinierte Regeln, um verwandte Fehler zu gruppieren, die sich nur durch dynamische Werte unterscheiden.
Fehler und Warnungen beheben
Beim Untersuchen von Fehlern über die Fehlerberichte-Seite verwenden Sie die folgenden Ansätze:
- Stack-Traces überprüfen — Erweitern Sie Fehlerzeilen, um den Aufrufweg zu sehen und das genaue Skript und die Zeilennummer zu identifizieren, an der der Fehler aufgetreten ist.
- Überprüfen Sie kürzliche Updates — Überwachen Sie neue Fehler seit Ihrem letzten Update.
- Verwenden Sie integrierte Tools:
- Entwicklerkonsole (F9 im Spiel): Live-Fehler in Echtzeit anzeigen und Fixes testen.
- Script Profiler: Leistungsbezogene Fehler identifizieren, die durch kostspielige Operationen verursacht werden.
- Ausgabefenster in Studio — Fangen Sie Fehler während der Entwicklung vor der Veröffentlichung.
- Verwenden Sie Aufschlüsselungen — Überprüfen Sie, ob der Fehler spezifisch für eine Plattform (Desktop, Mobil, Konsole) oder ein OS (Windows, macOS, iOS, Android) ist.
- Sammeln Sie Feedback aus der Community — Wenn Sie einen Community-Discord oder einen DevForum-Beitrag haben, überprüfen Sie, ob Spieler das Problem melden und welche Geräte oder Regionen betroffen sind.