Cómo leer los registros del servidor y los informes de fallo
Encuentra la línea que importa en el registro de un servidor de juego: niveles de registro, trazas de pila, la regla del primer error y dónde viven los registros y los informes de fallo en tu panel.
5 min de lectura · Actualizada el 21 oct 2026 · Por GuavaHost Team
Cuando un servidor se cae o se niega a arrancar, el motivo está escrito casi siempre en su registro. Los registros intimidan, pero rara vez hace falta entenderlo todo: lo que necesitas es encontrar una línea. Esta guía te enseña a leer una línea de registro, qué significan los niveles, cómo leer una traza de pila y dónde viven los registros y los informes de fallo en tu panel.
Anatomía de una línea de registro
Esta es una línea típica de un servidor de Minecraft:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]es la hora. Es el reloj del servidor, que puede no coincidir con tu zona horaria.Server threades qué parte del programa la ha escrito. El hilo del servidor es el bucle principal del juego.INFOes el nivel: lo grave que es la línea.- Todo lo que viene después de los dos puntos es el mensaje.
Otros juegos dan formato a las líneas de otra forma, pero casi todos incluyen en algún sitio una hora, un nivel y un mensaje.
Niveles de registro
| Nivel | Significado | ¿Debería preocuparte? |
|---|---|---|
| DEBUG o TRACE | Detalle fino para desarrolladores | Normalmente oculto; ignóralo |
| INFO | Actividad normal: arranque, entradas, guardados | No |
| WARN | Algo no va fino, pero el servidor sigue | A veces; muchos avisos son ruido inofensivo |
| ERROR | Algo ha fallado | Sí, si cuadra con tu problema |
| FATAL o SEVERE | El servidor no puede continuar | Sí, normalmente esto es el fallo en sí |
No persigas cada aviso. Muchísimos servidores sanos imprimen los mismos avisos inofensivos en cada arranque. Céntrate en los errores que ocurren cuando ocurre tu problema.
La regla del primer error
Un problema real provoca a menudo un montón de errores detrás, a medida que otras partes del servidor se tropiezan con el primer fallo. El último error que ves en pantalla suele ser un síntoma. El primer error después de la última línea con aspecto normal suele ser la causa.
- Busca la última línea en la que todo parecía normal.
- Lee hacia abajo hasta el primer
ERROR,ExceptionoFATAL. - Arregla ese, reinicia y vuelve a leer. Si ahora el servidor llega más lejos antes de fallar, vas avanzando.
Leer una traza de pila
Una traza de pila es la lista de pasos que estaba dando el programa cuando falló. Esta es una muy habitual de un servidor de Minecraft con 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
Cómo leerla:
- La primera línea dice qué ha fallado: el plugin ExampleShop no ha podido arrancar.
- El tipo de excepción dice por qué:
NoClassDefFoundErrorsignifica que necesitaba código que no está ahí. - Las líneas
atmuestran dónde. Busca un nombre que reconozcas, como el del propio plugin, en vez de las entrañas del juego. Caused byes la raíz. Cuando una traza tiene varios, el últimoCaused bysuele ser el motivo real. Aquí falta una clase de Vault, así que la solución es instalar el plugin Vault del que depende esta tienda.
Errores habituales y qué suelen significar
| Lo que ves | Normalmente significa |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Falta una dependencia, o hay un plugin o mod de otra versión |
NoSuchMethodError | Algo creado para otra versión del juego |
OutOfMemoryError | El servidor se ha quedado sin RAM |
FAILED TO BIND TO PORT o Address already in use | El puerto está ocupado, a menudo por una segunda copia que sigue funcionando |
found character '\t' that cannot start any token | Un tabulador en un archivo de configuración YAML; YAML solo admite espacios |
NullPointerException | Un fallo de programación, o un valor de configuración que falta o está mal escrito |
Informes de fallo
Algunos juegos escriben un informe aparte, con más detalle, cuando se caen.
- Minecraft los guarda en la carpeta
crash-reports, con la fecha y la hora en el nombre. Cerca del principio encontrarás una líneaDescriptiony la excepción. Los servidores con mods enumeran cada mod cargado, y los informes de Forge y NeoForge apuntan a menudo a un mod sospechoso. - Un fallo de Java que tumba a Java en sí deja un archivo
hs_err_pid(seguido de un número) en la carpeta principal del servidor. Estos suelen apuntar a la memoria o a una biblioteca nativa más que a un plugin.
Dónde viven los registros en tu panel
La pestaña Console (consola) muestra la salida en directo. Solo conserva las líneas recientes, así que para cualquier cosa más antigua abre los archivos de registro en la pestaña Files o descárgalos por SFTP.
| Juego | Dónde mirar |
|---|---|
| Minecraft Java | logs/latest.log; los registros antiguos son archivos .log.gz en logs (descárgalos y descomprímelos); los fallos en crash-reports |
| Valheim con BepInEx | BepInEx/LogOutput.log |
| ARK: Survival Evolved y Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt dentro de DoNotStarveTogether/config/server/Master y .../Caves, uno por fragmento |
| Enshrouded | La carpeta indicada por logDirectory en enshrouded_server.json, logs por defecto |
| Otros juegos | Lo que haya impreso la consola; busca también una carpeta logs o Logs, o archivos que terminen en .log |
Cuando el panel informa de un fallo
Si el proceso del servidor se detiene de forma inesperada, el panel puede imprimir su propio mensaje diciendo que el servidor se ha caído, junto con un código de salida. Unos cuantos que conviene conocer:
- 0: una parada normal.
- 1: el juego ha salido por un error; lee las líneas justo de encima.
- 137: el proceso ha sido eliminado a la fuerza, normalmente por pasarse de su límite de memoria. Mira señales de que a tu servidor se le acaba la RAM.
- 139: un fallo nativo dentro del propio juego.
Buscar en un registro largo
- Descarga el registro y ábrelo en un editor de texto.
- Usa Buscar (Ctrl+F, o Cmd+F en un Mac) con
ERROR, luegoExceptiony luegoCaused by. - Busca el nombre del último plugin o mod que añadiste.
- Haz coincidir las marcas de hora con el momento en que ocurrió el problema.
Pedir ayuda con un registro
Copia desde la última línea normal hasta el final del primer error, y pégalo como texto en vez de como captura de pantalla. Antes de compartirlo en cualquier sitio, quita contraseñas, tokens y cualquier cosa privada. Después tráelo a nuestro Discord, donde el equipo puede leerlo contigo. Para problemas de arranque en concreto, mira el servidor se queda en starting.
¿Sigues atascado? Pásate por nuestro Discord en discord.gg/GuavaHost y el equipo te echará una mano.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
¿Sigues necesitando ayuda? Nuestro equipo está en línea 24/7 para responder a tus preguntas.