Como ler logs de servidor e relatórios de crash
Encontre a linha que importa num log de servidor de jogo: níveis de log, stack traces, a regra do primeiro erro e onde ficam os logs e relatórios de crash no seu painel.
5 min de leitura · Atualizado em 21 de out. de 2026 · Por GuavaHost Team
Quando um servidor cai ou se recusa a ligar, o motivo quase sempre está escrito no log dele. Logs parecem intimidantes, mas você raramente precisa entender tudo: você precisa achar uma linha. Este guia mostra como ler uma linha de log, o que os níveis significam, como ler um stack trace e onde ficam os logs e os relatórios de crash no seu painel.
Anatomia de uma linha de log
Aqui está uma linha típica de um servidor de Minecraft:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]é a hora. É o relógio do servidor, que pode não bater com o seu fuso.Server threadé qual parte do programa escreveu a linha. A server thread é o laço principal do jogo.INFOé o nível: o quão séria é a linha.- Tudo depois dos dois pontos é a mensagem.
Outros jogos formatam as linhas de forma diferente, mas quase todos incluem uma hora, um nível e uma mensagem em algum lugar.
Níveis de log
| Nível | Significado | Você deve se preocupar? |
|---|---|---|
| DEBUG ou TRACE | Detalhe fino para desenvolvedores | Normalmente escondido; ignore |
| INFO | Atividade normal: inicialização, entradas, salvamentos | Não |
| WARN | Algo está estranho, mas o servidor segue | Às vezes; muitos avisos são ruído inofensivo |
| ERROR | Algo falhou | Sim, se coincidir com o seu problema |
| FATAL ou SEVERE | O servidor não consegue continuar | Sim, normalmente esse é o crash em si |
Não corra atrás de todo aviso. Muitos servidores saudáveis imprimem os mesmos avisos inofensivos em toda inicialização. Foque nos erros que acontecem quando o seu problema acontece.
A regra do primeiro erro
Um problema real muitas vezes causa uma pilha de erros depois dele, à medida que outras partes do servidor tropeçam na primeira falha. O último erro na tela normalmente é um sintoma. O primeiro erro depois da última linha de aparência normal normalmente é a causa.
- Encontre a última linha em que tudo parecia normal.
- Leia para baixo até o primeiro
ERROR,ExceptionouFATAL. - Corrija aquele, reinicie e leia de novo. Se o servidor agora avança mais antes de falhar, você está progredindo.
Lendo um stack trace
Um stack trace é a lista de passos que o programa estava executando quando falhou. Aqui está um comum de um servidor de Minecraft com plugins:
[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
Como ler:
- A primeira linha diz o que falhou: o plugin ExampleShop não conseguiu iniciar.
- O tipo da exceção diz por que:
NoClassDefFoundErrorsignifica que ele precisava de um código que não está lá. - As linhas
atmostram onde. Procure um nome que você reconheça, como o nome do próprio plugin, em vez das entranhas do jogo. - O
Caused byé a raiz. Quando um trace tem vários, o últimoCaused bynormalmente é o motivo real. Aqui, falta uma classe do Vault, então a solução é instalar o plugin Vault do qual essa loja depende.
Erros comuns e o que eles normalmente significam
| O que você vê | Normalmente significa |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Uma dependência faltando, ou um plugin ou mod de outra versão |
NoSuchMethodError | Algo feito para uma versão diferente do jogo |
OutOfMemoryError | O servidor ficou sem RAM |
FAILED TO BIND TO PORT ou Address already in use | A porta está ocupada, muitas vezes por uma segunda cópia ainda rodando |
found character '\t' that cannot start any token | Um tab num arquivo de configuração YAML; o YAML só aceita espaços |
NullPointerException | Um bug, ou um valor de configuração faltando ou escrito errado |
Relatórios de crash
Alguns jogos escrevem um relatório separado e mais detalhado quando caem.
- O Minecraft salva na pasta
crash-reports, com o nome contendo a data e a hora. Perto do topo você encontra uma linhaDescriptione a exceção. Servidores com mods listam todos os mods carregados, e os relatórios de Forge e NeoForge muitas vezes apontam um mod suspeito. - Um crash do Java que derruba o próprio Java deixa um arquivo
hs_err_pid(seguido de um número) na pasta principal do servidor. Esses normalmente apontam para memória ou uma biblioteca nativa, não para um plugin.
Onde ficam os logs no seu painel
A aba Console mostra a saída ao vivo. Ela guarda só as linhas recentes, então para qualquer coisa mais antiga, abra os arquivos de log na aba Files ou baixe por SFTP.
| Jogo | Onde procurar |
|---|---|
| Minecraft Java | logs/latest.log; logs antigos são arquivos .log.gz em logs (baixe e descompacte); crashes em crash-reports |
| Valheim com BepInEx | BepInEx/LogOutput.log |
| ARK: Survival Evolved e Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt dentro de DoNotStarveTogether/config/server/Master e .../Caves, um por shard |
| Enshrouded | A pasta definida por logDirectory no enshrouded_server.json, logs por padrão |
| Outros jogos | O que o Console imprimiu; procure também uma pasta logs ou Logs, ou arquivos terminando em .log |
Quando o painel informa um crash
Se o processo do servidor para de forma inesperada, o painel pode imprimir a própria mensagem dizendo que o servidor caiu, junto com um código de saída. Alguns que vale conhecer:
- 0: uma parada normal.
- 1: o jogo saiu por causa de um erro; leia as linhas logo acima.
- 137: o processo foi encerrado à força, normalmente por passar do limite de memória. Veja sinais de que o seu servidor está sem RAM.
- 139: um crash nativo dentro do próprio jogo.
Pesquisando num log longo
- Baixe o log e abra num editor de texto.
- Use o Localizar (Ctrl+F, ou Cmd+F no Mac) para
ERROR, depoisException, depoisCaused by. - Pesquise o nome do último plugin ou mod que você adicionou.
- Compare os horários com o momento em que o problema aconteceu.
Pedindo ajuda com um log
Copie da última linha normal até o fim do primeiro erro, e cole como texto em vez de captura de tela. Antes de compartilhar em qualquer lugar, remova senhas, tokens e qualquer coisa privada. Depois leve ao nosso Discord, onde o time pode ler junto com você. Para problemas de inicialização especificamente, veja servidor travado em starting.
Ainda com dúvidas? Entre no nosso Discord em discord.gg/GuavaHost e a equipe vai te ajudar.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Ainda precisa de ajuda? Nosso time está online 24 horas por dia, 7 dias por semana, para tirar suas dúvidas.