Så läser du loggar och crashrapporter

Hitta det första verkliga felet i serverloggen och läs crash-rapporten utan att gissa.

Uppdaterad: 14 augusti 20263 min läsning

Serverloggarna hittar du i fliken Loggar och i filen /logs/latest.log. Crash-rapporter hamnar i mappen /crash-reports/. Diagnosprincipen är en enda: du letar efter det första felet i kronologisk ordning och raden Caused by:. Den visar den verkliga orsaken, inte det sista meddelandet på skärmen.

#Det här behöver du

Åtkomst till panelen manage.mchost.gg.
Fliken Loggar (visning och nedladdning) eller Filer (mapparna logs och crash-reports).

#Var loggarna finns

Fil	Innehåll
`/logs/latest.log`	Loggen för den aktuella eller senaste körningen
`/logs/YYYY-MM-DD-N.log.gz`	Arkiv över tidigare sessioner, komprimerade
`/crash-reports/crash-*.txt`	Rapport vid en hård krasch i JVM

I fliken Loggar finns fältet Filtrera loggar…, knappen Uppdatera och knappen Ladda ner för att spara hela filen.

#Meddelandenivåer

Nivå	Betydelse
`INFO`	Normal drift av servern
`WARN`	Varning. Servern fortsätter köra, men något är fel
`ERROR`	Fel. Oftast har ett tillägg inte laddats eller en operation misslyckades
`FATAL`	Kritiskt fel, servern stoppas

Börja inte läsa från slutet av filen. De sista raderna är oftast följden, inte orsaken, eftersom servern skriver ut information om avstängningen där. Sök efter det första ERROR uppifrån.

#Så läser du en stack trace

[12:03:41] [Server thread/ERROR]: Could not load 'plugins/GammaltPlugin.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError:
  pl/example/Main has been compiled by a more recent version of the Java Runtime
    at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:147)
    ...
Caused by: java.lang.UnsupportedClassVersionError: pl/example/Main

Läs i den här ordningen:

Första raden med ERROR: säger vad som inte lyckades (Could not load 'plugins/GammaltPlugin.jar').
Filnamnet inom citattecken eller hakparenteser: den skyldige.
Caused by:: den verkliga orsaken. Om det finns flera sådana rader gäller den sista.
Raderna at ... är anropskedjan. De är användbara för tilläggets författare, inte för dig.

#Vanliga meddelanden och vad de betyder

Meddelande	Orsak
`UnsupportedClassVersionError`	Tillägget kräver en nyare version av Java
`NoClassDefFoundError`	Saknat beroende. Pluginet kräver ett annat plugin
`Could not load 'plugins/X.jar'`	Pluginet är inkompatibelt med versionen eller servermotorn
`Failed to bind to port`	En tidigare serverprocess körs fortfarande
`java.lang.OutOfMemoryError`	Minnet är slut
`Failed to load level.dat`	Världen är skadad eller ofullständig
`Incompatible mod set`	Olika modlistor hos klienten och servern
`Can't keep up! Is the server overloaded?`	Servern hinner inte med tickarna. Se Lagg och optimering

#Crashrapporter

Filen i mappen /crash-reports/ börjar med avsnittet ---- Minecraft Crash Report ----. Tre delar är intressanta:

Description:: en mening som beskriver vad som gick fel.
Caused by:: det egentliga undantaget.
-- Head -- / Stacktrace:: de första raderna visar modens paket, till exempel at com.example.mod.EntityHandler.

Paketnamnet i stack trace är det snabbaste sättet att hitta modden som orsakade kraschen.

En crash-rapport skapas bara vid en hård stopp av JVM. En server som stängs av "snyggt" efter ett fel lämnar bara spår i latest.log.

#Filtrera loggen

Fältet Filtrera loggar… i fliken Loggar begränsar vyn till matchande rader. Praktiska sökord är ERROR, Caused by, WARN och pluginets namn.

När du har laddat ner filen kan du söka i terminalen:

grep -n "ERROR" latest.log | head -20
grep -n -A5 "Caused by" latest.log | head -40

#Rapportera ett problem

När du skickar ett ärende till supporten bifogar du hela filen latest.log (knappen Ladda ner), inte en skärmbild av ett utdrag. En rad från före felet kan vara den enda som spelar roll.

#Vanliga problem

#Det finns massor av fel i loggen. Var ska jag börja?

Med det första i kronologisk ordning. De följande felen beror oftast på att den första komponenten inte laddades.

#Loggen slutar mitt i en mening

Servern dödades hårt. Kontrollera om Tvinga stopp användes och om ett OutOfMemoryError uppstod.

#Det finns ingen mapp `crash-reports`

Det uppstod ingen hård krasch. Felsök med hjälp av latest.log.

#Filen `latest.log` är enorm

Loggen växer när ett plugin spammar varningar. Ladda ner filen och filtrera på ERROR. Upprepade WARN från en loop kan du ignorera i det här skedet.

#Jag hittade namnet på en mod, men vet inte vad jag ska göra nu

Ta bort dess .jar-fil från /mods eller /plugins, starta servern och kontrollera att felet har försvunnit. Då bekräftas diagnosen.