Los registros de errores documentan los problemas que ocurren en su sitio web, incluidos errores de PHP, fallos en las conexiones a la base de datos y problemas con complementos. Cuando algo falla en su sitio, el registro de errores suele ser la forma más rápida de identificar la causa.
Acceso a los registros mediante el Administrador de archivos o SFTP
KPanel no cuenta con una pestaña dedicada de Registros. Los archivos de registro se almacenan en el servidor y se puede acceder a ellos mediante el Administrador de archivos o SFTP.
Mediante el Administrador de archivos:
- Inicie sesión en KPanel en kpanel.kapsulehost.com
- Vaya a Sitios web y seleccione el sitio afectado
- Haga clic en Configuración → Administrador de archivos
- Navegue hasta el directorio
logs/en la raíz de su sitio
Mediante SFTP:
- Vaya a Configuración → SFTP en KPanel para obtener los datos de conexión de su sitio
- Conéctese con FileZilla o el cliente SFTP de su preferencia
- Navegue hasta el directorio
logs/en la raíz de su sitio
El directorio logs/ contiene:
- Registro de errores de PHP, errores generados por el código PHP (el registro que se necesita con más frecuencia)
- Registro de acceso, un registro de todas las solicitudes HTTP a su sitio
- Registro de errores, errores a nivel de servidor (500, 502, etc.)
Lectura de un registro de errores de PHP
Una entrada típica de un registro de errores de PHP se ve así:
[03-Jun-2026 14:32:11 UTC] PHP Fatal error: Call to undefined function get_header() in /var/www/sites/yourdomain/public_html/wp-content/themes/mytheme/page.php on line 8
Esto le indica la fecha y hora, el tipo de error, una descripción del problema y la ruta del archivo y el número de línea donde ocurrió el error.
Tipos de errores habituales
| Tipo | Gravedad | Qué significa |
|---|---|---|
| Error fatal | Alta | La ejecución se detuvo. La página no cargará. |
| Advertencia | Media | Ocurrió algo inesperado, pero la ejecución continuó. |
| Aviso | Baja | Problema menor, generalmente una infracción de buenas prácticas de codificación. |
| Obsoleto | Baja | Una función en uso se eliminará en una futura versión de PHP. |
Activación del modo de depuración de WordPress
Para los sitios de WordPress, activar el modo de depuración genera información más detallada sobre los errores:
- Conéctese mediante SFTP o utilice el Administrador de archivos en KPanel
- Abra
wp-config.phpen la raíz de WordPress - Agregue o actualice estas líneas:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Los errores se escribirán en wp-content/debug.log en lugar de mostrarse en pantalla.
No deje WP_DEBUG_DISPLAY configurado como true en un sitio en producción, ya que esto puede exponer información sensible a los visitantes.
Revise los registros de errores inmediatamente después de actualizar WordPress, complementos o temas. Muchos problemas posteriores a una actualización dejan rastros claros en el registro de errores de PHP.