Näin luet palvelinlokeja ja kaatumisraportteja
Löydä merkitsevä rivi pelipalvelimen lokista: lokitasot, pinojäljet, ensimmäisen virheen sääntö ja se mistä lokit ja kaatumisraportit löytyvät paneelistasi.
4 min lukuaika · Päivitetty 21.10.2026 · Kirjoittanut GuavaHost Team
Kun palvelin kaatuu tai kieltäytyy käynnistymästä, syy on lähes aina kirjoitettu sen lokiin. Lokit näyttävät pelottavilta, mutta niistä tarvitsee harvoin ymmärtää kaikkea: sinun täytyy löytää yksi rivi. Tämä opas näyttää, miten lokirivi luetaan, mitä tasot tarkoittavat, miten pinojälkeä luetaan ja mistä lokit ja kaatumisraportit löytyvät paneelistasi.
Lokirivin anatomia
Tässä tyypillinen rivi Minecraft-palvelimelta:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]on kellonaika. Se on palvelimen kello, joka ei välttämättä vastaa omaa aikavyöhykettäsi.Server threadkertoo, mikä ohjelman osa sen kirjoitti. Palvelinsäie on pelin pääsilmukka.INFOon taso: kuinka vakava rivi on.- Kaikki kaksoispisteen jälkeen on viesti.
Muut pelit muotoilevat rivit toisin, mutta lähes kaikissa on jossain kellonaika, taso ja viesti.
Lokitasot
| Taso | Merkitys | Pitäisikö huolestua? |
|---|---|---|
| DEBUG tai TRACE | Hienojakoista yksityiskohtaa kehittäjille | Yleensä piilossa, ohita |
| INFO | Normaalia toimintaa: käynnistys, liittymiset, tallennukset | Ei |
| WARN | Jokin on vinossa, mutta palvelin jatkaa | Välillä, monet varoitukset ovat harmitonta hälyä |
| ERROR | Jokin epäonnistui | Kyllä, jos se osuu yksiin ongelmasi kanssa |
| FATAL tai SEVERE | Palvelin ei voi jatkaa | Kyllä, tämä on yleensä itse kaatuminen |
Älä jahtaa jokaista varoitusta. Lukemattomat terveet palvelimet tulostavat samat harmittomat varoitukset joka käynnistyksellä. Keskity virheisiin, jotka tapahtuvat silloin kun ongelmasi tapahtuu.
Ensimmäisen virheen sääntö
Yksi todellinen ongelma aiheuttaa usein kasan virheitä perässään, kun palvelimen muut osat kompastuvat ensimmäiseen epäonnistumiseen. Viimeinen virhe ruudulla on yleensä oire. Ensimmäinen virhe viimeisen normaalilta näyttävän rivin jälkeen on yleensä syy.
- Etsi viimeinen rivi, jolla asiat näyttivät normaaleilta.
- Lue alaspäin ensimmäiseen
ERROR-,Exception- taiFATAL-kohtaan. - Korjaa se yksi, käynnistä uudelleen ja lue taas. Jos palvelin pääsee nyt pidemmälle ennen kaatumista, edistyt.
Pinojäljen lukeminen
Pinojälki on luettelo askelista, joita ohjelma oli ottamassa kun se epäonnistui. Tässä tavallinen esimerkki Minecraftin plugin-palvelimelta:
[12:40:03 ERROR]: Error occurred while enabling ExampleShop v2.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
at com.example.shop.ShopPlugin.onEnable(ShopPlugin.java:57)
...
Caused by: java.lang.ClassNotFoundException: net.milkbowl.vault.economy.Economy
Miten sitä luetaan:
- Ensimmäinen rivi kertoo, mikä epäonnistui: ExampleShop-plugin ei saanut käynnistyttyä.
- Poikkeuksen tyyppi kertoo miksi:
NoClassDefFoundErrortarkoittaa, että se tarvitsi koodia jota ei ole paikalla. at-rivit näyttävät missä. Etsi nimeä jonka tunnistat, kuten pluginin omaa nimeä, pelin sisuskalujen sijaan.Caused byon juuri. Kun jäljessä on useita, viimeinenCaused byon yleensä oikea syy. Täällä Vaultin luokka puuttuu, joten korjaus on asentaa Vault-plugin, josta tämä kauppa riippuu.
Tavalliset virheet ja mitä ne yleensä tarkoittavat
| Näet | Se yleensä tarkoittaa |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Puuttuva riippuvuus, tai toiselle versiolle tehty plugin tai modi |
NoSuchMethodError | Jokin eri peliversiolle rakennettu |
OutOfMemoryError | Palvelimelta loppui RAM |
FAILED TO BIND TO PORT tai Address already in use | Portti on varattu, usein vielä pyörivän toisen kopion toimesta |
found character '\t' that cannot start any token | Sarkain YAML-asetustiedostossa, YAML sallii vain välilyöntejä |
NullPointerException | Bugi, tai asetusarvo joka puuttuu tai on väärin kirjoitettu |
Kaatumisraportit
Jotkut pelit kirjoittavat erillisen, yksityiskohtaisemman raportin kaatuessaan.
- Minecraft tallentaa ne
crash-reports-kansioon, nimettyinä päivämäärällä ja kellonajalla. Lähellä yläreunaa löydätDescription-rivin ja poikkeuksen. Modatut palvelimet luettelevat jokaisen ladatun modin, ja Forgen ja NeoForgen raportit osoittavat usein epäiltyyn modiin. - Javan kaatuminen, joka vie itse Javan alas, jättää palvelimen päähakemistoon
hs_err_pid-tiedoston (jota seuraa numero). Nämä osoittavat yleensä muistiin tai natiivikirjastoon eikä pluginiin.
Mistä lokit löytyvät paneelistasi
Console-välilehti (konsoli) näyttää elävän tulosteen. Se säilyttää vain tuoreet rivit, joten mitään vanhempaa varten avaa lokitiedostot Files-välilehdellä (tiedostot) tai lataa ne SFTP:n yli.
| Peli | Mistä katsoa |
|---|---|
| Minecraft Java | logs/latest.log, vanhemmat lokit ovat .log.gz-tiedostoja kansiossa logs (lataa ja pura), kaatumiset kansiossa crash-reports |
| Valheim BepInEx:llä | BepInEx/LogOutput.log |
| ARK: Survival Evolved ja Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt kansioissa DoNotStarveTogether/config/server/Master ja .../Caves, yksi sirpaletta kohden |
| Enshrouded | Kansio, jonka logDirectory asettaa tiedostossa enshrouded_server.json, oletuksena logs |
| Muut pelit | Mitä konsoli tulosti, etsi myös kansiota logs tai Logs, tai tiedostoja jotka päättyvät .log |
Kun paneeli ilmoittaa kaatumisesta
Jos palvelinprosessi pysähtyy odottamatta, paneeli voi tulostaa oman viestinsä siitä että palvelin kaatui, sekä poistumiskoodin. Muutama kannattaa tietää:
- 0: normaali pysäytys.
- 1: peli lopetti virheen takia, lue juuri yläpuolella olevat rivit.
- 137: prosessi tapettiin väkisin, yleensä muistirajan ylittämisen takia. Katso merkit siitä että palvelimelta loppuu RAM.
- 139: natiivikaatuminen itse pelin sisällä.
Pitkän lokin läpikäynti
- Lataa loki ja avaa se tekstieditorissa.
- Käytä etsintää (Ctrl+F, tai Macissa Cmd+F) hakusanoilla
ERROR, sittenException, sittenCaused by. - Etsi viimeksi lisäämäsi pluginin tai modin nimeä.
- Täsmää aikaleimat siihen hetkeen, jolloin ongelma tapahtui.
Avun pyytäminen lokin kanssa
Kopioi viimeisestä normaalista rivistä ensimmäisen virheen loppuun, ja liitä se tekstinä kuvakaappauksen sijaan. Ennen kuin jaat sen minnekään, poista salasanat, tunnisteet ja kaikki yksityinen. Tuo se sitten Discordiimme, jossa tiimi voi lukea sen kanssasi. Erityisesti käynnistysongelmiin katso palvelin jumissa käynnistyksessä.
Vieläkö jumissa? Hyppää Discordiimme osoitteessa discord.gg/GuavaHost, niin tiimimme auttaa sinua.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Tarvitsetko vielä apua? Tiimimme on linjoilla 24/7 vastaamassa kysymyksiin.