Come leggere i log del server e i rapporti di crash
Trova la riga che conta nel log di un server di gioco: livelli di log, stack trace, la regola del primo errore e dove stanno log e rapporti di crash nel pannello.
5 min di lettura · Aggiornata il 21 ott 2026 · Di GuavaHost Team
Quando un server va in crash o si rifiuta di partire, il motivo è quasi sempre scritto nel suo log. I log mettono paura, ma raramente ti serve capirli tutti: ti serve trovare una riga. Questa guida ti mostra come leggere una riga di log, cosa significano i livelli, come si legge una stack trace e dove stanno log e rapporti di crash nel tuo pannello.
Anatomia di una riga di log
Ecco una riga tipica di un server Minecraft:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]è l'ora. È l'orologio del server, che può non coincidere con il tuo fuso orario.Server threadè la parte del programma che l'ha scritta. Il server thread è il ciclo di gioco principale.INFOè il livello: quanto è grave la riga.- Tutto quello che segue i due punti è il messaggio.
Altri giochi formattano le righe in modo diverso, ma quasi tutti includono da qualche parte un'ora, un livello e un messaggio.
I livelli di log
| Livello | Significato | Devi preoccuparti? |
|---|---|---|
| DEBUG o TRACE | Dettagli fini per gli sviluppatori | Di solito nascosti; ignorali |
| INFO | Attività normale: avvio, ingressi, salvataggi | No |
| WARN | Qualcosa non va, ma il server continua | A volte; molti avvisi sono rumore innocuo |
| ERROR | Qualcosa è andato storto | Sì, se coincide con il tuo problema |
| FATAL o SEVERE | Il server non può continuare | Sì, di solito è il crash stesso |
Non inseguire ogni avviso. Moltissimi server sani stampano gli stessi avvisi innocui a ogni avvio. Concentrati sugli errori che si verificano quando si verifica il tuo problema.
La regola del primo errore
Un solo problema reale provoca spesso una pila di errori dopo di sé, mentre altre parti del server inciampano sul primo guasto. L'ultimo errore sullo schermo è di solito un sintomo. Il primo errore dopo l'ultima riga che sembrava normale è di solito la causa.
- Trova l'ultima riga in cui le cose sembravano normali.
- Scendi fino al primo
ERROR,ExceptionoFATAL. - Sistema quello, riavvia e rileggi. Se ora il server arriva più avanti prima di cedere, stai facendo progressi.
Come si legge una stack trace
Una stack trace è l'elenco dei passaggi che il programma stava compiendo quando ha ceduto. Ecco una stack trace comune su un server Minecraft con plugin:
[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
Come si legge:
- La prima riga dice cosa è andato storto: il plugin ExampleShop non è riuscito a partire.
- Il tipo di eccezione dice perché:
NoClassDefFoundErrorsignifica che gli serviva del codice che non c'è. - Le righe
atmostrano dove. Cerca un nome che riconosci, come quello del plugin stesso, invece delle parti interne del gioco. Caused byè la radice. Quando una trace ne contiene diverse, l'ultimoCaused byè di solito il vero motivo. Qui manca una classe di Vault, quindi la soluzione è installare il plugin Vault da cui dipende questo negozio.
Errori comuni e cosa significano di solito
| Cosa vedi | Di solito significa |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Una dipendenza mancante, o un plugin o una mod per un'altra versione |
NoSuchMethodError | Qualcosa costruito per una versione di gioco diversa |
OutOfMemoryError | Il server ha esaurito la RAM |
FAILED TO BIND TO PORT o Address already in use | La porta è occupata, spesso da una seconda copia ancora in esecuzione |
found character '\t' that cannot start any token | Una tabulazione in un file di configurazione YAML; YAML ammette solo spazi |
NullPointerException | Un bug, o un valore di configurazione mancante o scritto male |
I rapporti di crash
Alcuni giochi scrivono un rapporto separato e più dettagliato quando vanno in crash.
- Minecraft li salva nella cartella
crash-reports, con il nome che contiene data e ora. Vicino all'inizio trovi una rigaDescriptione l'eccezione. I server con mod elencano ogni mod caricata, e i rapporti di Forge e NeoForge spesso indicano una mod sospetta. - Un crash di Java che porta giù Java stesso lascia un file
hs_err_pid(seguito da un numero) nella cartella principale del server. Questi di solito indicano la memoria o una libreria nativa invece di un plugin.
Dove stanno i log nel tuo pannello
La scheda Console mostra l'output dal vivo. Conserva solo le righe recenti, quindi per qualsiasi cosa più vecchia apri i file di log nella scheda Files oppure scaricali via SFTP.
| Gioco | Dove guardare |
|---|---|
| Minecraft Java | logs/latest.log; i log più vecchi sono file .log.gz in logs (scaricali e scompattali); i crash in crash-reports |
| Valheim con BepInEx | BepInEx/LogOutput.log |
| ARK: Survival Evolved e Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt dentro DoNotStarveTogether/config/server/Master e .../Caves, uno per shard |
| Enshrouded | La cartella impostata da logDirectory in enshrouded_server.json, per impostazione predefinita logs |
| Altri giochi | Quello che ha stampato la Console; cerca anche una cartella logs o Logs, oppure file che finiscono in .log |
Quando il pannello segnala un crash
Se il processo del server si ferma in modo inatteso, il pannello può stampare un proprio messaggio che dice che il server è andato in crash, insieme a un codice di uscita. Alcuni vale la pena conoscerli:
- 0: un arresto normale.
- 1: il gioco è uscito a causa di un errore; leggi le righe appena sopra.
- 137: il processo è stato terminato a forza, di solito per aver superato il limite di memoria. Vedi segnali che il server sta esaurendo la RAM.
- 139: un crash nativo dentro il gioco stesso.
Come cercare in un log lungo
- Scarica il log e aprilo in un editor di testo.
- Usa la funzione Trova (Ctrl+F, o Cmd+F su un Mac) per
ERROR, poiException, poiCaused by. - Cerca il nome dell'ultimo plugin o dell'ultima mod che hai aggiunto.
- Confronta gli orari con il momento in cui si è verificato il problema.
Come chiedere aiuto con un log
Copia dall'ultima riga normale fino alla fine del primo errore, e incollalo come testo invece che come screenshot. Prima di condividerlo da qualche parte, rimuovi password, token e qualsiasi cosa privata. Poi portalo nel nostro Discord, dove il team può leggerlo con te. Per i problemi di avvio in particolare, vedi il server resta bloccato su starting.
Hai ancora problemi? Entra nel nostro Discord su discord.gg/GuavaHost e il team ti darà una mano.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Ti serve ancora aiuto? Il nostro team è online 24 ore su 24, 7 giorni su 7, per rispondere alle tue domande.