Log di sistema
La pagina Log di sistema mostra in tempo reale i log dell’applicazione: errori, warning, eventi di sicurezza, attività di autenticazione. È lo strumento principale per diagnosticare problemi e monitorare il comportamento dell’istanza.
A cosa serve
Sezione intitolata “A cosa serve”- Investigare errori non visibili agli utenti finali
- Vedere i tentativi di login falliti o le sessioni rifiutate
- Monitorare i job di background (backup, importazioni, rinnovi)
- Filtrare per livello (INFO/WARNING/ERROR) o per logger (app.auth, app.security, ecc.)
Come si usa
Sezione intitolata “Come si usa”- Dal menu amministrativo/monitoraggio, apri Log di sistema
- I log arrivano via SSE (Server-Sent Events) in tempo reale — no refresh manuale
- Usa i filtri in alto:
- Livello minimo (INFO/WARNING/ERROR)
- Logger (auto-discovery dai log presenti)
- Ricerca testo live
- Clicca un log per espandere stack trace / context
Logger principali
Sezione intitolata “Logger principali”| Logger | Cosa contiene |
|---|---|
app.auth | Login, logout, refresh, failure, lockout |
app.security | Host header rejection, rate limit, CSRF |
app.import | Elaborazione XML/PDF/immagini |
app.plugins | Caricamento plugin, errori frontend/backend |
app.scheduler | Esecuzione job pianificati |
uvicorn.* | Server HTTP |
sqlalchemy.* | Query database (se DEBUG) |
Concetti chiave
Sezione intitolata “Concetti chiave”- Rotation giornaliera: i log su file ruotano a mezzanotte UTC (
app-YYYY-MM-DD.log) - Retention configurabile: il parametro
giorni_retention_login Impostazioni Avanzate controlla da quanto tempo vengono conservati i file - Buffer in-memory: l’SSE mostra gli ultimi ~1000 eventi — per log storici più vecchi, consulta i file rotazionati
- Non in-app: stdout di nginx, output di
init_migrate.py(pre-startup) e di Vite (dev) non passano da qui — sono visibili solo condocker compose logs