Symbolisierung von Spielabstürzen: Berichte dem exakt ausgelieferten Build zuordnen

Zweck

Ein Absturzbericht mit Adressen ist erst der Anfang einer Untersuchung. Die Symbolisierung ordnet Codestellen den zugehörigen Funktionen und, sofern die nötigen Informationen vorliegen, auch Quellcodezeilen zu. Diese Zuordnung hängt von genau der Binärdatei ab, die ausgeführt wurde. Symbole eines benachbarten Releases aufzubewahren oder denselben Quellcode später neu zu bauen, belegt nicht, dass die Symboldatei zur ausführbaren Datei des Spielers passt. Ausführbare Dateien, Symbole und Quellcode-Identität sind daher als ein gemeinsamer Release-Datensatz zu behandeln.

Funktionsweise

Ein Dump hält ausgewählte Teile des Prozesszustands zu einem bestimmten Zeitpunkt fest. Was er enthält, hängt davon ab, wie er erstellt wurde; ein kleiner Dump enthält nicht zwingend beliebige Heap-Daten. Microsoft dokumentiert, dass passende ausführbare Dateien und Symboldateien erforderlich sind und dass Dumps, die den Heap einschliessen, zusätzliche Speicherinformationen bieten. Ein Debugger kann einen erfassten Dump nicht einfach als laufendes Spiel fortsetzen.

Symbolinformationen können Funktionen, Variablen und Zeilenzuordnungen beschreiben. Der sichtbare Stack bleibt dennoch ein Hinweis auf einen beobachteten Fehler und kein Beweis für dessen frühere Ursache. Ein ungültiger Speicherzugriff kann die verzögerte Folge eines veralteten Objekts oder einer vorangegangenen Speicherbeschädigung sein.

Ausgearbeitetes Beispiel

Angenommen, ein Studio liefert die Builds B17 und B18 aus. Beide ausführbaren Dateien heissen Game.exe, ihr Code-Layout unterscheidet sich jedoch. Ein Bericht aus B17 muss gegen die ausführbare Datei und die Game.pdb genau dieses Builds aufgelöst werden; die Symbole von B18 anhand des Dateinamens auszuwählen, genügt nicht.

Jedes Release unter einer unveränderlichen Build-Identität ablegen und die Modul- und Symbolabgleichsprüfungen des Debuggers nutzen. Fehlen die exakten Symbole, diese Einschränkung festhalten, statt einen plausiblen Funktionsnamen als verifiziert darzustellen. Die genannten Build-Bezeichnungen dienen nur der Veranschaulichung und stammen nicht aus einem realen Absturz.

Praktischer Ablauf

Beim Build die ausführbare Datei, die relevanten Bibliotheken, die passenden Symbole und die Quellcode-Revision gemeinsam aufbewahren. Den Meldeweg in einem kontrollierten Build mit einem absichtlich ausgelösten Testfehler durchspielen. Prüfen, dass das erfasste Modul erkannt wird und die erwarteten Frames mithilfe der aufbewahrten Artefakte aufgelöst werden.

Bei eingehenden Berichten die Build-Konfiguration, die Ausnahmekategorie, den fehlerhaften Thread und weitere aufschlussreiche Threads untersuchen. Knappe Kontextinformationen zum Spielzustand anhängen, die das Nachstellen der Situation erleichtern. Das Meldesystem von Unreal unterstützt benutzerdefinierten Kontext und kann zwischen Abstürzen, Assertions und nicht fatalen Ensures unterscheiden; diese Kategorien nicht so zusammenfassen, als handle es sich um gleichartige Fehler. Die Meldekonfiguration für das paketierte Spiel getrennt vom Editor überprüfen.

Grenzen und Überprüfung

Optimierung und Inlining können die Untersuchung auf Quellcodeebene lückenhaft machen, und eine fehlende Variable ist kein Beleg dafür, dass sie einen bestimmten Wert hatte. Zusammengehörige Berichte anhand stabiler, build-bezogener Informationen gruppieren und den jeweiligen Kontext vergleichen, bevor eine einzige Grundursache festgestellt wird.

Dumps und Logs können Anwendungsspeicher oder von Benutzern eingegebene Informationen enthalten; die erfassten Felder und die Zugriffsrechte sind daher bewusst festzulegen. Die für unterstützte Releases benötigten Artefakte aufbewahren. Nach der Behebung einer vermuteten Ursache das ursprüngliche Szenario nachstellen und einen gezielten Regressionstest ergänzen; ein symbolisierter Stack allein belegt nicht, dass der Fehler behoben ist.

Quellen

• Use dump files in the debugger — Microsoft
• Symbols and Symbol Files — Microsoft
• Crash Reporting in Unreal Engine — Epic Games