Logs e Monitoramento
O Chinaski oferece várias superfícies de observação: o journal do sistema (com eventos de segurança em JSON estruturado), visões de log dentro do app (event log, auth log, build history), endpoints de saúde multi-check para monitoramento externo e um resumo de métricas. Esta página indexa as peças e aponta para cada subpágina:
- Logs do sistema (journald & eventos de segurança): onde os logs vão parar, as linhas de evento JSON, orientação sobre PII/retenção e o log de segurança externo opcional.
- Visões de log no app: event log, histórico de autenticação, build history e o dashboard de métricas.
- Health checks & monitoramento:
/health,/api/health, e como conectá-los a um monitoramento de uptime.
As respostas rápidas
- Os logs vivem no systemd-journald (
journalctl -u chinaski@<N> -f), com eventos de alto sinal adicionalmente emitidos como linhas JSON legíveis por máquina no mesmo stream (grep '"event"'os isola). - A trilha de builds está no app, não apenas no journalctl: o build history guarda logs por execução, tempos por fase e resultados de validação.
- Monitores externos devem mirar no endpoint de saúde; o projeto embarca um monitor cron de 5 minutos para sucesso de build e presença de página como um template pronto.
- Dados sensíveis (IPs de clientes) trafegam nos campos de log: o README inclui um snippet de política de retenção do journald e recomenda igualar a retenção em qualquer SIEM externo.
Nesta seção
Também em Logs e Monitoramento
Use os dois endpoints de health sem autenticação e o dashboard interno: o que o GET /health verifica e como ligá-lo ao seu monitoramento.
Os logs dentro da área admin: o log de eventos da página Health, o histórico de autenticação e o histórico dos últimos 100 builds, com seus filtros.
Leia os logs do Chinaski no journal do systemd, os eventos de segurança em JSON e seus campos, o arquivo append-only opcional e notas de retenção.