# log.dkh: bitácoras de texto `log.dkh` escribe bitácoras: una línea por evento con fecha, hora y nivel, en un archivo por día. Sustituye a las funciones `saveLog` que cada programa tiene a su manera. Viene con la distribución de Devkron 2.0. Incluya antes `functions.dkh` y `serialize.dkh`. ## Cuándo usarla - Registrar qué hizo una tarea programada: cuántos registros procesó y qué falló. - Guardar lo que llega y sale de una integración (webhooks, timbrado, pagos) para revisarlo después. - Dejar rastro de errores de un servicio sin mostrárselos al usuario. ```dkl #include "log.dkh" ``` ## Funciones | Función | Descripción | |---|---| | `log.to(carpeta)` | Fija la carpeta de las bitácoras y la crea si no existe | | `log.info(mensaje)` | Línea de nivel `INFO` | | `log.warn(mensaje)` | Línea de nivel `WARN` | | `log.error(mensaje)` | Línea de nivel `ERROR` | | `log.json(objeto)` | Línea de nivel `JSON` con el registro o la lista en JSON | | `log.file()` | Ruta del archivo de hoy | - Cada línea se agrega a `/.log`, con la fecha y la hora del servidor: `2026-10-27 14:30:05 INFO mensaje`. - Los saltos de línea del mensaje se vuelven espacios: cada evento ocupa una sola línea. - **Sin `log.to` las funciones lanzan error** (`log: no se indicó la carpeta de bitácoras (use log.to)`). La carpeta es por ejecución: en FastCGI, llame a `log.to` en cada petición. ## Ejemplo: bitácora de una tarea por lotes ```dkl #include "dkli.dkh" #! program "timbrado nocturno" { #include "functions.dkh" #include "serialize.dkh" #include "log.dkh" prueba:: { do log.info("sin carpeta") return 0 exception { do print(last_error()) } } do prueba() do log.to("bitacoras") do log.info("Inicia timbrado nocturno") new resumen { @"procesadas": 998 @"errores": 2 } if resumen.errores > 0 { do log.warn(str(resumen.errores) + " facturas no se timbraron") } do log.json(resumen) do log.error("PAC sin respuesta:\nse reintentará") do log.info("Termina timbrado nocturno") do print("Archivo: " + log.file()) do print(file.rtext(log.file())) } ``` Salida: ``` {1} log: no se indicó la carpeta de bitácoras (use log.to)[Ln= 18] Archivo: bitacoras/2026-10-27.log 2026-10-27 18:27:09 INFO Inicia timbrado nocturno 2026-10-27 18:27:09 WARN 2 facturas no se timbraron 2026-10-27 18:27:09 JSON {"procesadas":998,"errores":2} 2026-10-27 18:27:09 ERROR PAC sin respuesta: se reintentará 2026-10-27 18:27:09 INFO Termina timbrado nocturno ``` En un programa real use una ruta absoluta fuera del sitio, por ejemplo `log.to("/var/log/miapp")`, y en el bloque `exception` del programa escriba `log.error(last_error())`. ## Advertencias - **No escriba contraseñas, tokens ni datos de tarjetas** en la bitácora. Quite esos campos antes de `log.json`. - Varias peticiones del mismo proceso pueden escribir a la vez. Entre procesos distintos no se garantiza el orden de las líneas. - Las bitácoras no se borran solas. Programe la limpieza de los archivos viejos, por ejemplo en `cron`: `find /var/log/miapp -name "*.log" -mtime +90 -delete`. - El usuario con el que corre el servidor FastCGI debe poder escribir en la carpeta. Póngala **fuera** de la raíz pública del sitio para que nadie descargue las bitácoras por HTTP.