Activar el modo DEBUG en EspoCRM: cómo ver lo que el sistema no te muestra
Hay un momento muy específico en el que todo desarrollador de EspoCRM se topa con la misma pared: un flujo de trabajo falla, una fórmula no hace lo esperado, o un endpoint de la API responde con un error genérico — y el log, en su configuración por defecto, no dice nada útil. No es que el sistema esté ocultando información a propósito. Es que, por defecto, EspoCRM solo registra lo que considera relevante para operación normal, y eso deja fuera justo lo que necesitas para diagnosticar un problema puntual.
El modo DEBUG existe para ese momento. Activarlo no es una configuración que deba quedar prendida para siempre — es una herramienta que se enciende cuando necesitas ver el detalle completo de lo que está pasando, y se apaga apenas terminas de diagnosticar. Entender esto evita dos errores comunes: dejar DEBUG activo en producción de forma permanente (los logs crecen rápido y pueden exponer datos sensibles), o nunca activarlo y quedarte adivinando qué falla.
Cómo funciona el sistema de logs de EspoCRM
EspoCRM usa la librería Monolog para gestionar sus logs, y por defecto escribe en {ESPO_ROOT}/data/logs/.
El nivel de detalle que se registra se controla con el parámetro level, que acepta cinco valores en orden creciente de severidad: DEBUG, INFO, NOTICE, WARNING y ERROR. Por defecto, EspoCRM viene configurado en NOTICE — suficiente para operación normal, insuficiente para investigar un problema específico.
Toda la configuración vive en data/config, bajo la clave logger:
