Configuración de logs en Caddy

Caddy 2 tiene un sistema de logging flexible, pero hay cambios importantes respecto a ejemplos antiguos que pueden causar errores. Este artículo explica cómo configurar logs correctamente y evitar problemas de módulos no registrados.

Errores comunes

single_field no registrado: Algunos tutoriales antiguos usan format single_field, que ya no existe en Caddy 2.
log dentro de handle_errors: Caddy no permite usar log dentro de handle_errors.

Ejemplo que falla:

handle_errors {
    log {
        output file /var/log/caddy/error.log
    }
}

Configuración correcta de logs

log {
    output file /var/log/caddy/ejemplo.access.log
    level INFO
}

output file: define la ruta del archivo donde se registrarán los logs.
level INFO: nivel de detalle (INFO, ERROR, DEBUG, etc.).
JSON por defecto: La salida es legible por Caddy y compatible con herramientas de análisis.

Logs de errores

En Caddy 2 no se recomienda usar handle_errors para logs. Todos los errores se registran automáticamente en el mismo bloque log del sitio.

Aplicación de cambios

sudo service caddy reload

Conclusión

Caddy 2 simplifica el logging usando JSON y evita módulos no existentes. La clave es configurar log directamente en el sitio, no dentro de handle_errors.