Registros y limpieza#

Dónde escribe Empowerment Center sus registros, cómo rotan, cómo se mandan a un syslog o a un SIEM, y qué limpia ECenter solo para que la BD propia no crezca sin control.

Los registros#

Cada contenedor escribe sus registros en la salida estándar:

docker compose -f deploy/compose.yaml logs -f backend
docker compose -f deploy/compose.yaml logs --since 1h frontend

Servicio	Qué registra
`backend`	El arranque (la versión, las migraciones, el identificador de la instalación y el estado de la licencia), los errores, los avisos de cada módulo y las líneas de la auditoría.
`frontend`	Cada petición, con el formato de acceso de nginx.
`db`	Los avisos y errores de PostgreSQL.
`chromium`, `valhalla`	Los suyos propios.

Sin contenedores, el backend escribe igualmente en la salida estándar: con systemd, en su diario (journalctl -u ecenter).

Líneas que conviene conocer#

Línea del backend	Qué significa
`Creado el administrador inicial '…'`	El primer arranque ha creado el primer administrador.
`No hay usuarios y no se ha configurado ecenter.security.bootstrap-admin…`	Nadie puede entrar: faltan `ECENTER_ADMIN_LOGIN` y `ECENTER_ADMIN_PASSWORD`.
`Instalación <id>: licencia de …`	La licencia es válida.
`Instalación <id>: … Hasta que un administrador del sistema instale una licencia válida, la API solo permite iniciar sesión e instalarla.`	No hay licencia válida, y por qué.
`Licencia instalada por … para …`	Alguien ha instalado una licencia.
`No hay claves de licencia de confianza…`	Esta versión no acepta ninguna licencia: consulte a Action Ware.
`La privada de la clave de la instalación … no se puede descifrar (¿ha cambiado ECENTER_SECRETS_KEY?): se crea otra`	La clave de los secretos no es la que cifró los datos guardados. Las contraseñas de las conexiones tampoco se podrán descifrar (véase La clave de los secretos).
Avisos que empiezan por `DB:` al arrancar	Mensajes de una migración de la BD (por ejemplo, libros renombrados porque tenían el mismo nombre en una carpeta).

La rotación#

Con la auditoría, cada acceso, cada consulta o cada trabajo puede ser una línea, y el controlador json-file de Docker no rota si el demonio no lo configura. deploy/compose.yaml da a todos sus servicios la misma configuración de registros, que guarda como mucho 5 ficheros de 50 MB por servicio:

x-logging: &logging
  driver: json-file
  options:
    max-size: 50m
    max-file: "5"

Si la organización recoge los registros con journald o con syslog, cambie el controlador en ese bloque; la rotación pasa a ser la suya.

La auditoría en el registro#

Cada entrada de la auditoría sale también como una línea del backend, en ecenter.audit.<categoría> (ecenter.audit.access, ecenter.audit.data…), para mandarla a un syslog o a un SIEM. Por defecto salen todas las categorías salvo query (cada consulta) y job (cada trabajo), que son muchas. Para tenerlas también:

# application.yml propio
logging:
  level:
    ecenter.audit.query: info
    ecenter.audit.job: info

O con variables: LOGGING_LEVEL_ECENTER_AUDIT_QUERY=info. La auditoría completa, con el SQL y sus valores, se consulta y se exporta en Administración › Auditoría (véase Auditoría).

Lo que limpia ECenter#

ECenter purga solo, con varias instancias sin repetirlo:

Qué	Conserva por defecto	Propiedad
La auditoría de las consultas y de los trabajos	90 días	`ecenter.audit.retention.categories.query`, `…job`
El resto de la auditoría	365 días	`ecenter.audit.retention.others`
El historial de trabajos	90 días	`ecenter.operations.maintenance.job-history`
Las alertas operativas resueltas	365 días	`ecenter.operations.maintenance.resolved-alerts`
La actividad de la consola	3 días por minuto, 92 por hora, 400 por día	`ecenter.operations.activity.retention.*`
Las ejecuciones de las tareas programadas	90 días	`ecenter.scheduling.history`
Los envíos de suscripciones y alertas de datos	90 días	`ecenter.distribution.history`
La actividad del aprovisionamiento por SCIM	30 días	`ecenter.provisioning.activity-retention`
Las credenciales de servicio revocadas o caducadas	180 días	`ecenter.security.credentials.retention`
Las sesiones incrustadas terminadas	30 días	`ecenter.embedding.retention`
Las sesiones caducadas	Se borran al minuto	`ecenter.security.sessions.cleanup-interval`
Las subidas de datos externos y de capas sin terminar	24 horas	`ecenter.externaldata.upload-ttl`, `ecenter.maps.upload-ttl`
Las copias de los libros, las plantillas y el metadata	Las 10 últimas de hoy y la última de cada uno de los 7 días anteriores	`ecenter.workbooks.backups-`, `ecenter.portal.layouts.backups-`, `ecenter.metadata.backups-*`

Todas las propiedades, en Operación, auditoría y planificación. La auditoría es lo que más crece: si el disco de la BD propia se llena, revise primero sus plazos y ecenter.audit.record-queries.

El disco#

La BD propia crece sobre todo con la auditoría. Vigile su volumen (db-data) con las herramientas de la organización.
El disco del backend guarda los ficheros temporales de las subidas. La consola de operación avisa si quedan menos de 1 GB libres en el directorio temporal (ecenter.operations.alerts.disk-free-min y disk-path).
Los registros de los contenedores están acotados por la rotación.
El grafo del motor de rutas ocupa unos 6 GB para España y Canarias, y no crece.