Registros del agente de servidor
Ubicación de los registros del agente de servidor de Kabeen, rotación diaria, periodo de conservación configurable mediante log_retention_days y permisos de acceso a la carpeta
El agente de servidor de Kabeen registra su actividad en archivos de registro locales, la primera fuente de información al diagnosticar un problema. Desde la versión 3.2.2, esos archivos se rotan a diario con un periodo de conservación configurable: un registro que crece sin límite ya no puede saturar el disco del servidor.
Ubicación de los registros
El agente escribe un archivo por día, con el nombre de la fecha en formato AAAA-MM-DD.log:
| Plataforma | Ubicación |
|---|---|
| Windows | C:\ProgramData\Kabeen\Server Agent\logs\<AAAA-MM-DD>.log |
| Linux | /var/log/kabeen-server-agent/<AAAA-MM-DD>.log |
La carpeta se crea en el primer arranque del agente si no existe.
En Linux, las mismas líneas se envían también a journald, que aplica su propia política de conservación, independiente de la del agente:
sudo journalctl -u kabeen-server-agent.service -fPara consultar el archivo del día:
sudo tail -f /var/log/kabeen-server-agent/$(date +%F).logGet-Content "C:\ProgramData\Kabeen\Server Agent\logs\$(Get-Date -Format 'yyyy-MM-dd').log" -Tail 30Antes de la versión 3.2.2, el agente escribía en un único archivo
kabeen-server-agent.log, abierto en modo de anexado y nunca depurado. Tras la actualización, ese archivo ya no se alimenta: puede eliminarlo manualmente una vez archivado su contenido, si es necesario.
Rotación diaria
- El agente cambia a un archivo nuevo en el primer evento registrado después de medianoche.
- En ese mismo cambio, elimina los archivos
.logde la carpeta más antiguos que el periodo de conservación. - No hay que configurar ninguna tarea programada ni
logrotate: el propio agente se encarga de la rotación.
Periodo de conservación
De forma predeterminada, el agente conserva 14 días de registros. Este periodo se ajusta servidor por servidor con la clave log_retention_days del archivo de configuración (/etc/kabeen-server-agent/config.toml en Linux, C:\ProgramData\Kabeen\Server Agent\config.toml en Windows):
api_key = "SU_CLAVE_API_DE_KABEEN"
# Número de días de registros diarios que se conservan. Valor predeterminado: 14.
log_retention_days = 30| Valor | Efecto |
|---|---|
| Entero positivo | Los registros se conservan ese número de días |
Clave ausente, valor 0 o valor ilegible | Se vuelve al valor predeterminado de 14 días |
Excepción a la recarga en caliente. A diferencia de todas las demás claves de
config.toml, que se releen automáticamente cada 10 segundos,log_retention_daysse lee una sola vez al arrancar, antes de inicializar el registro. Una modificación solo surte efecto al reiniciar el servicio.
sudo systemctl restart kabeen-server-agent.serviceRestart-Service KabeenServerAgentCodificación. Al igual que con la clave API,
config.tomldebe guardarse en UTF-8 sin BOM — un archivo en UTF-16 o con BOM impide que el agente arranque. Consulte Diagnóstico › Codificación del archivo de configuración.
Permisos de acceso a la carpeta
Las líneas de registro pueden contener nombres de host, nombres de servicios y flujos de red observados en el servidor. En Linux, la carpeta de registros está por tanto restringida a su propietario y a su grupo (root:root, modo 0750), de modo que los usuarios sin privilegios no pueden recorrerla. El agente vuelve a aplicar este modo en cada arranque.
No relaje estos permisos (
chmod 755o más permisivo): el modo de la carpeta es lo que protege los archivos creados por la rotación.
Para los demás elementos de diagnóstico (niveles de registro, errores de arranque, codificación del archivo de configuración), consulte Diagnóstico.