Qué son los logs de errores y por qué deberías leerlos

Los logs de errores son los diarios de tu servidor. Ahí se anota todo lo que sale mal: errores de PHP, fallos de acceso, peticiones rechazadas, bases de datos desconectadas o permisos mal configurados. Aunque suenen técnicos, son tu mejor fuente de información cuando tu web empieza a comportarse raro.

No necesitas ser programador para entenderlos. Basta con saber qué mirar, cómo buscar patrones y cuándo pedir ayuda. Lo demás es sentido común y algo de observación.

Dónde encontrar los logs de errores en tu hosting

Depende del tipo de alojamiento. En la mayoría de hostings compartidos como cPanel, DirectAdmin o Plesk, los encontrarás en:

  • cPanel: en Métricas > Errores o dentro del Administrador de archivos en la carpeta logs o /home/usuario/logs/.
  • Plesk: en la pestaña Registros del dominio.
  • FTP o File Manager: busca error_log dentro de la carpeta public_html o www.
  • VPS o servidor dedicado: normalmente en /var/log/apache2/error.log o /var/log/nginx/error.log.

Algunos CMS como WordPress pueden tener también su propio archivo de errores en wp-content/debug.log si tienes activado el modo WP_DEBUG_LOG.

Cómo leer líneas de log sin agobiarte

Un log puede parecer un galimatías de fechas, rutas y mensajes. Pero cada línea sigue una estructura bastante lógica. Mira este ejemplo simplificado:

[Wed Aug 14 10:42:21.256238 2024] [php:error] [pid 12345] PHP Fatal error: Uncaught Error: Call to undefined function get_post_thumbnail() in /home/usuario/public_html/wp-content/themes/tema/functions.php on line 231

Vamos a desmenuzarlo:

  • Fecha y hora: sabes cuándo ocurrió el error, útil para correlacionarlo con algo que hiciste (como instalar un plugin).
  • Tipo de error: “PHP Fatal error”, “Warning”, “Notice” o similar. Cuanto más grave, más urgente.
  • Mensaje: te dice qué función o archivo falló.
  • Línea del archivo: indica dónde está el fallo en el código.

Con esta información, puedes buscar en Google el texto exacto del error (copiando solo la parte explicativa). Casi siempre encontrarás hilos o soluciones específicas.

Tipos de errores más comunes y cómo interpretarlos

1. PHP Errors

Son los más frecuentes. Pueden ser de varios niveles:

  • Notice: avisos, no rompen la web. Ejemplo: variables sin definir.
  • Warning: advertencias, el código sigue pero algo no está bien. Ejemplo: incluir un archivo que no existe.
  • Fatal error: el script se detiene, pantalla blanca o error 500.

Solución básica: desactiva plugins o temas recién instalados, revisa rutas, o activa el modo debug. En WordPress, coloca en wp-config.php la línea define('WP_DEBUG', true); y recarga para obtener más detalles.

2. Errores 500, 502, 503 o 504

Estos ya vienen del servidor. Suelen significar que algo ha fallado en segundo plano, o el servidor no ha podido procesar la petición.

  • Error 500 (Internal Server Error): archivo .htaccess mal configurado, permisos incorrectos o fallo en PHP.
  • 502 (Bad Gateway): el servidor proxy (por ejemplo, Nginx) no obtiene respuesta de Apache o PHP-FPM.
  • 503 (Service Unavailable): servidor sobrecargado o mantenimiento programado.
  • 504 (Gateway Timeout): el servidor tardó demasiado en responder, a menudo por consultas lentas a la base de datos.

Para diagnosticarlos, abre los logs de Apache o Nginx justo en el momento del fallo y cruza la hora. Si no sabes interpretar lo que ves, copia un fragmento y consúltalo en soporte técnico. Pero ya sabrás qué parte copiar, evitando enviar capturas confusas.

3. Access Logs

Los logs de acceso no muestran errores, sino peticiones realizadas al servidor. Son útiles para detectar bots, ataques de fuerza bruta o páginas inexistentes que generan errores 404.

Si ves cientos de peticiones por segundo desde una misma IP, probablemente haya un bot atacando tu sitio. Puedes bloquear esas direcciones o implementar reglas en el .htaccess o en un firewall tipo Fail2Ban.

Cómo identificar patrones y causas

Los errores rara vez ocurren de forma aislada. Si ves diez líneas seguidas con el mismo fallo, ya tienes una pista. Pregúntate:

  • ¿Ocurre después de subir un cambio, plugin o plantilla?
  • ¿Coincide con un aumento de tráfico?
  • ¿Solo pasa en una hora del día?

Ejemplo real: un cliente mío tenía un error 500 intermitente. En el log aparecía: “PHP Fatal error: Allowed memory size exhausted”. Traducido: su página necesitaba más RAM de la asignada. Solución: subir el valor de memory_limit en php.ini o pedir más recursos al hosting.

Errores frecuentes traducidos a lenguaje humano

  • “Call to undefined function…”: tu web intenta usar una función que no existe (plugin desactivado o código desactualizado).
  • “Permission denied”: falta de permisos en carpetas o archivos. Ajusta a 755 para directorios y 644 para archivos.
  • “Maximum execution time exceeded”: el script tarda demasiado. Aumenta max_execution_time o optimiza el proceso.
  • “No such file or directory”: archivo faltante o ruta incorrecta.
  • “Database connection failed”: credenciales mal configuradas en wp-config.php o servicio MySQL caído.

Herramientas para facilitar la lectura

  • Administrador de archivos de cPanel: permite abrir logs sin descargarlos.
  • Comando tail -f: útil si usas SSH para ver los errores en tiempo real.
  • Paneles de control como Plesk: tienen visor de logs con filtrado por tipo de error.
  • Plugins WordPress: como “WP Log Viewer” o “Error Log Monitor”, que muestran los errores directamente en el panel de administración.

Un truco práctico: si tu web se cae intermitentemente, deja abierta una ventana con tail -f error.log y espera. Cuando ocurra el fallo, lo verás en directo.

Cuándo contactar al soporte técnico

Si tras revisar los logs no entiendes la causa, no te frustres. Ya llevas ventaja al saber ofrecer información útil. En soporte técnico agradecen mucho que les pases la línea exacta del error con fecha y hora. Eso acelera las respuestas y evita los típicos correos interminables.

Pro tip: indica siempre el dominio afectado, la hora del error y, si es posible, una URL concreta. Evita decir “mi web va mal”. No sirve de nada.

Cómo prevenir errores futuros

  • Mantén tu CMS, plugins y temas actualizados.
  • Evita usar código copiado de foros sin entenderlo.
  • Haz copias de seguridad automáticas antes de tocar el servidor.
  • Revisa los logs de vez en cuando, incluso si todo va bien. Prevenir siempre es más barato que reparar.

Interpretar logs no es un arte oscuro. Es leer el lenguaje del servidor para anticipar problemas antes de que afecten a tus usuarios. Y con algo de práctica, verás que te vuelves más autosuficiente y menos dependiente del soporte técnico.

Si estás buscando un hosting que te dé buenos registros, soporte ágil y herramientas de análisis integradas, echa un vistazo a esta comparativa de servidores web recomendados. Ahorrarás tiempo, dinero y más de un susto.