Logs y Monitoreo
Chinaski te da varias superficies de observación: el journal del sistema (con eventos de seguridad en JSON estructurado), vistas de log dentro de la app (event log, auth log, historial de builds), endpoints de health multi-chequeo para monitoreo externo y un resumen de métricas. Esta página indexa las piezas y enlaza a cada subpágina:
- Logs del sistema (journald y eventos de seguridad): dónde se guardan los logs, las líneas de eventos JSON, guía sobre PII/retención y el log de seguridad externo opcional.
- Vistas de log en la app: event log, historial de autenticación, historial de builds y el dashboard de métricas.
- Health checks y monitoreo:
/health,/api/health, y cómo conectarlos al monitoreo de uptime.
Las respuestas rápidas
- Los logs viven en systemd-journald (
journalctl -u chinaski@<N> -f), y los eventos de alta señal se emiten además como líneas JSON legibles por máquina en el mismo stream (grep '"event"'los aísla). - El rastro del build está en la app, no solo en journalctl: el historial de builds conserva logs por ejecución, tiempos por fase y resultados de validación.
- Los monitores externos deben apuntar al endpoint de health; el proyecto incluye un monitor cron de 5 minutos para el éxito del build y la presencia de páginas como plantilla lista para usar.
- Los datos sensibles (IPs de clientes) viajan en los campos del log; el README incluye un snippet de política de retención de journald y aconseja igualar la retención en cualquier SIEM externo.
En esta sección
También en Logs y Monitoreo
Existen dos endpoints de health sin autenticación para monitores, más un dashboard de health de administración dentro de la app.
Además del journal del sistema, el área de administración muestra los logs en contexto.
Lee los logs de Chinaski en el journal de systemd, los eventos de seguridad JSON y sus campos, el archivo append-only opcional y notas de retención.