Data Miner für eine Diagnose verwenden
Mit FlammiCraft ausgelieferte Mod-Version: 1.13.0
English · Messwerte und Berichte erklären
Data Miner zeichnet Registry-, Start-, Leistungs- und Latenzinformationen auf. Es repariert keine Spielwelt. Die Aktivierung hat bereits beim nächsten Prozessstart Dateiausgaben und laufende Messarbeit zur Folge.
Gezielte Aufzeichnung starten
Auf physischen Clients, auch im Einzelspieler, ist die Mod ohne JVM-Parameter deaktiviert. Für einen vorgesehenen Diagnosestart -Ddata_miner.enabled=true in die Java-Argumente aufnehmen. Dedizierte Server sind standardmäßig aktiviert; false schaltet für den Prozess ab. Detaillierte Methodenhooks brauchen zusätzlich -Ddata_miner.detailedProfiling=true und verursachen zusätzliche Messarbeit.
Es gibt keine aktive Config-Datei oder einzelnen Dump-Schalter mehr. Alte Configs bleiben liegen, werden aber ignoriert. Änderungen an JVM-Parametern brauchen einen vollständigen Prozessneustart.
Den Bedienablauf abschließen
- Beim aktivierten Start werden neun unterstützte Registry-Dumps und Startberichte automatisch in ein neues Sitzungsverzeichnis geschrieben.
- Grundlegende Ticküberwachung und Latenzverfolgung starten mit dem Server.
- Für einen gezielten Leistungsabschnitt als OP Stufe 2 zuerst
/data_miner perf stopausführen und den erfolgreichen Export prüfen. Danach mit/data_miner perf starteine neue Aufnahme beginnen, den Problemfall ausführen und mitperf stopexportieren.perf startbei laufender Aufnahme meldet diesen Zustand und erhält die vorhandenen Daten. Für Events beziehungsweise Latenz gelten die entsprechendenevents-/latency-Unterbefehle. - Die Warteschlangenmeldung bedeutet nur angenommen. Log und ausgegebenes Sitzungsverzeichnis auf erfolgreichen Export prüfen.
- Für Vergleichsläufe ähnliche Last, Messdauer und aktivierte Hooks festhalten.
/data_miner dump aktualisiert die Registry-Dateien dieser Sitzung. mods analyze erzeugt die Modanalyse neu. latency stats zeigt laufende Statistiken.
Berichte auswerten und aufbewahren
Sitzungen liegen unter data_miner/info_client/ beziehungsweise info_server/, jeweils mit UTC-Zeit und Sitzungskennung. startup, performance, events, logs und session_state.json trennen Daten und Exportzustand. Alte Sitzungen bleiben erhalten; JSONL-Zeitleisten wachsen auf Platte.
Registry-Dumps umfassen unter anderem Items und Blöcke, nicht dynamische Biome oder Dimensionen. Ein Modname in einer Stichprobe ist keine bewiesene Fehlerursache. Die Referenz erläutert Messabdeckung, Lücken und Korrelation mit Logs. Logs enthalten Originaltext und sind vor Weitergabe zu prüfen.
Der bestehende lesende Korrelationsaufruf wertet auch die gespeicherten Chunkrequests, Pipelinephasen und Zulassungshüllen aus. IDs werden nur innerhalb desselben Snapshots und derselben Aufnahme verbunden. Wiederholte Checkpoints werden getrennt dargestellt und nicht aufsummiert. Offene Hüllen unterscheiden weder Dependency- von Queuewarten noch Cancel, Fehler oder Aufnahmestopp. Fehlende Daten bleiben unbekannt. Die Referenz nennt die Lesegrenzen und Zeitzuordnung.
Abbruch oder fehlgeschlagener Export kann Daten seit dem letzten Minuten-Checkpoint verlieren. Fehlende Beobachtung ist kein Beweis, dass ein Ereignis nicht stattfand. Dieses Handbuch führt keine Aufnahme aus; die konkrete Laufzeitmessung bleibt ein eigener Diagnoseablauf.
Auch abgefangene Schreibfehler erscheinen unter export_worker.export_failures und verhindern den Sitzungsstatus completed. Eine Warteschlangenmeldung bestätigt weiterhin nur die Annahme des Auftrags.
Der Berichtsvergleich überspringt beim Lesen nicht benötigte Dimensionshistorien und Tracer-Details. Er erlaubt bis zu 256 MB pro Eingabedatei und 720 gespeicherte Fenster, bei einem Lesebudget von acht Millionen Zeichen für ausgewählte Vergleichsdaten. Die Originalberichte bleiben unverändert; für die JSONL-Zeitleiste gilt separat eine Grenze von 128 MB.
Bei externen Logs ohne Datum pro Zeile stammt der Anfangstag aus dem Dateinamen oder einer vorherigen datierten Zeile. Rücksprünge um mindestens zwölf Stunden werden als nächster Tag interpretiert und gezählt. Kleinere Rücksprünge bleiben am selben Tag und werden als mehrdeutige Uhr- oder Reihenfolgeänderung markiert. Diese Zuordnung ist eine Annahme und kann einen starken Uhrsprung nicht sicher von Mitternacht unterscheiden. Ungültige GC-Dauern werden gezählt; nachfolgende gültige Zeilen bleiben auswertbar.