Documentación del plugin

Ver categorías

Cómo comprobar WP_DEBUG Logs en WordPress

4 min leer

WP_DEBUG es una constante de WordPress que habilita el modo de depuración, permitiendo a los desarrolladores solucionar problemas mediante el registro de errores, advertencias y avisos. Esta guía explica cómo comprobar los registros de WP_DEBUG utilizando varios métodos.

Requisitos previos

  • Acceso a su instalación de WordPress (a través del panel de control del alojamiento, FTP o SSH).
  • Conocimientos básicos de los archivos de configuración de WordPress.
  • WP_DEBUG habilitado en su wp-config.php . Para activarlo, añada o modifique las siguientes líneas:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false ); // Evita que los errores se muestren en el sitio.

Método 1: Comprobación de registros de depuración mediante acceso a archivos

WordPress almacena los registros de depuración en un archivo cuando WP_DEBUG_LOG está activado. Por defecto, el archivo de registro se encuentra en wp-content/debug.logpero puede especificar una ubicación personalizada para una mejor organización o seguridad.

Pasos:

  1. Configurar la ubicación del registro:
  • Para la ubicación predeterminada del registro, asegúrese de que WP_DEBUG_LOG se establece en verdadero en wp-config.php.
  • Para una ubicación de registro personalizada, añada o edite la siguiente línea en wp-config.php para especificar una ruta:
define( 'WP_DEBUG_LOG', '/ruta/a/persona/debug.log' );
  • Asegúrese de que el servidor web puede escribir en el directorio (por ejemplo, establezca los permisos en 664 o 666 para el archivo y 755 para el directorio).
  1. Acceda a sus archivos de WordPress:
  • Utilice un cliente FTP (por ejemplo, FileZilla) o el gestor de archivos de su alojamiento para acceder a su instalación de WordPress.
  • Alternativamente, utilice SSH para conectarse a su servidor para un acceso más rápido.
  1. Localizar el registro de depuración:
  • Navegue hasta el wp-contenido para el registro por defecto (wp-content/debug.log) o a su ruta personalizada (p. ej, /ruta/al/personal/debug.log).
  • Si el archivo de registro no existe, asegúrese de que WP_DEBUG_LOG está correctamente configurado y desencadenar una acción en su sitio (por ejemplo, refrescar una página) para generar registros.
  1. Ver el registro:
  • Descargue el archivo de registro y ábralo con un editor de texto (por ejemplo, Notepad++, VS Code).
  • Alternativamente, utilice SSH para ver el archivo directamente con un comando como cat wp-content/debug.log o cat /ruta/al/personal/debug.log.
  1. Interpretar los registros:
  • Los registros incluyen marcas de tiempo, tipos de error (por ejemplo, Advertencia PHP, Aviso PHP), y detalles sobre el problema, incluido el archivo y el número de línea que causan el error.

Notas:

  • Las ubicaciones de registro personalizadas son útiles cuando wp-contenido no se puede escribir o para organizar los registros en un directorio seguro.
  • Asegúrese de que las rutas personalizadas no sean de acceso público para evitar exponer información confidencial.
  • Si el archivo de registro es grande, utilice herramientas como grep (por ejemplo grep "Error PHP" wp-content/debug.log) para filtrar errores específicos.
  • Borre o rote regularmente el archivo de registro para evitar que crezca demasiado.

Método 2: Utilizar un plugin de depuración

Varios plugins de WordPress simplifican el proceso de visualización de los registros de depuración sin acceso directo a los archivos.

Plugins recomendados:

Pasos:

  1. Instalar un plugin:
  • Ir a Plugins > Añadir nuevo en el panel de administración de WordPress.
  • Busque e instale el complemento de depuración que desee (por ejemplo, Debug Log Manager).
  • Active el plugin.
  1. Acceder a los registros de depuración:
  • Para Administrador de registros de depuraciónNavegue hasta Herramientas > Administrador de registros de depuración en el panel de administración de WordPress para ver, filtrar o descargar el registro de depuración. El plugin también le permite borrar registros o configurar los ajustes de registro.
  • Para Monitor de consultasNavegue hasta el menú Monitor de consultas en la barra de administración para ver los errores y registros.
  • Para Barra de depuraciónHaga clic en la barra de depuración de la barra de administración y explore la sección de registro.

Notas:

  • Los plugins pueden requerir WP_DEBUG y WP_DEBUG_LOG para ser activado.
  • Debug Log Manager ofrece funciones adicionales como el filtrado de registros por tipo de error y la gestión del tamaño de los archivos de registro.

Método 3: Depuración en tiempo real con un terminal

Los usuarios avanzados pueden supervisar los registros de depuración en tiempo real mediante SSH y comandos de terminal.

Pasos:

  1. Acceda a su servidor a través de SSH:
  • Conéctese a su servidor utilizando un cliente SSH (por ejemplo, PuTTY o terminal).
  1. Supervisar el registro de depuración:
  • Ejecute el siguiente comando para ver el archivo de registro en tiempo real:
tail -f wp-content/debug.log
  • Para una ubicación de registro personalizada, utilice:
tail -f /ruta/al/personal/debug.log
  • En -f garantiza que las nuevas entradas de registro se muestren a medida que se escriben.
  1. Acciones desencadenantes:
  • Realice acciones en su sitio WordPress (por ejemplo, actualizar una página, enviar un formulario) para generar entradas de registro.
  • Observe el terminal para obtener información inmediata.

Notas:

  • Utilice Ctrl+C para detener la vigilancia.
  • Combinar con grep para filtrar (por ejemplo tail -f wp-content/debug.log | grep "PHP Error").

Método 4: Utilizar integraciones de registro de errores

Algunos proveedores de alojamiento o configuraciones de servidor permiten integrar los registros de depuración de WordPress con los registros de errores del servidor o con herramientas de monitorización de terceros.

Pasos:

  1. Comprobar el panel de control de alojamiento:
  • Acceda al panel de control de su alojamiento.
  • Busque un Registros de errores o Registros sección.
  • Si WP_DEBUG_LOG está configurado para escribir en un archivo accesible por el servidor, pueden aparecer errores aquí.
  1. Integración con herramientas de terceros:
  • Utiliza herramientas como New Relic, Centinelao Loggly para recopilar y analizar los registros de depuración de WordPress.
  • Configure estas herramientas mediante plugins o dirigiéndolas a WP_DEBUG_LOG a sus API.

Notas:

  • Este método requiere una configuración adicional y puede implicar costes de servicios de terceros.
  • Asegúrese de que su entorno de alojamiento admite integraciones de registro personalizadas.

Buenas prácticas

  • Desactivar la depuración en sitios activos: Establecer WP_DEBUG a falso en los sitios de producción para evitar exponer información sensible.
  • Archivos de registro seguros: Asegúrese debug.log no es de acceso público (por ejemplo, añadir negar de todo a .htaccess para el archivo de registro).
  • Mantenimiento periódico: Borre o archive periódicamente los registros para gestionar el espacio en disco.
  • Prueba en la etapa: Reproduzca los problemas en un entorno de ensayo para evitar perturbar los sitios activos.

Resolución de problemas comunes

No debug.log Archivo:

  • Verifique WP_DEBUG y WP_DEBUG_LOG se fijan en verdadero en wp-config.php.
  • Compruebe si el wp-contenido o el directorio de registro personalizado tiene permisos de escritura (los permisos deben ser 755 para directorios y 664 o 666 para archivos).

Los registros están vacíos:

  • Asegúrese de que las acciones que provocan errores se realizan después de activar la depuración.
  • Compruebe si hay errores de sintaxis en wp-config.php que puedan impedir el registro.

Archivos de registro de gran tamaño:

  • Utiliza herramientas de rotación de registros o plugins como Debug Log Manager para gestionar el tamaño de los archivos.
  • Filtra los registros con herramientas como grep para centrarse en las entradas relevantes.

Usando estos métodos, puede monitorizar y solucionar problemas de forma efectiva en su sitio WordPress usando los logs WP_DEBUG. Elige el método que mejor se adapte a tus conocimientos técnicos y a tu entorno de alojamiento.

¿Necesita ayuda con algo?

Crear un ticket de soporte >>
Cuáles son sus sentimientos