Logging e Audit Completo

Trasparenza totale su cosa fa la piattaforma

Il modulo Logging e Audit di ReportIA registra in modo strutturato e immodificabile ogni azione della piattaforma: ogni query eseguita, ogni operazione di scrittura, ogni chiamata API, ogni accesso utente. Indispensabile per compliance (GDPR, ISO 27001, SOX), per IT/security manager che devono dimostrare cosa fa il sistema, per troubleshooting di errori.

I 5 tipi di log

1. Cronologia query

Per ogni query AI eseguita:

• Domanda originale dell'utente.
• SQL generata.
• Database utilizzato.
• Tempo di esecuzione.
• Esito (successo/errore).
• Numero righe restituite.
• Cache hit/miss.
• Utente che ha eseguito.
• Timestamp.

Vedi modulo Cronologia.

2. Log operazioni di scrittura

Audit completo per operazioni INSERT/UPDATE/DELETE:

• Tipo operazione.
• Database e tabella.
• Utente.
• SQL completa eseguita.
• Righe modificate / ID inserito.
• Successo/fallimento.
• Timestamp.

3. Log API pubbliche

Per ogni chiamata API:

• Token utilizzato.
• IP di provenienza.
• User-Agent.
• Endpoint chiamato.
• Body request.
• Response time.
• Esito HTTP code.
• Timestamp.

4. Debug log

Per troubleshooting tecnico:

• Stack trace errori.
• Contesto completo della query (prompt AI, schema embedded).
• SQL generata e tentativi di correzione.
• Tempi di ogni step (OpenAI, DB, formattazione).

5. Log avatar dedicato

Log specifico per integrazioni avatar/chatbot:

• Sessioni separate.
• Conversazioni complete.
• Performance integrazioni.

Filtri e ricerca avanzati

Per navigare tra migliaia di log:

• Filtri data: oggi, settimana, mese, custom.
• Filtri utente: chi ha fatto cosa.
• Filtri tipo: query, scrittura, API.
• Filtri esito: successo, errore.
• Ricerca testuale: nelle domande, SQL, errori.
• Filtri IP: utile per investigazioni sicurezza.

Esportazione log

Per compliance e analisi esterna:

• CSV: per analisi in Excel.
• JSON: per import in SIEM (Security Information and Event Management).
• PDF: per documentazione cartacea.

Compatibile con tool come Splunk, ELK, Datadog.

Conservazione configurabile

Audit trail immodificabile

I log sono immodificabili dagli utenti:

• Una volta scritto, un log non può essere alterato.
• Solo super admin può vedere TUTTI i log.
• Eliminazione log: solo per scadenza retention, non manuale.

Garantisce integrità per audit legali.

Statistiche aggregate

Dashboard logging con:

• Totale query nel periodo.
• Top utenti per attività.
• Database più utilizzati.
• Tempo medio risposta.
• % errori.
• Operazioni di scrittura per tabella.
• Chiamate API per token.

Alert su anomalie

Notifiche automatiche per:

• Query massivamente lente (timeout, possibile bug).
• Picco di errori (problema database o bug AI).
• Operazioni di scrittura inusuali (DELETE su tabella critica).
• Login anomali (IP estero, fuori orario).
• Rate limiting API superato.

Compliance e norme

GDPR

• Tracciabilità accessi a dati personali.
• Diritto di accesso (audit log per interessato).
• Conservazione limitata e cancellazione.
• Right to be forgotten.

ISO 27001

• Audit trail di sistema.
• Controllo degli accessi.
• Tracciabilità modifiche.

SOX (Sarbanes-Oxley)

• Per aziende quotate USA o gruppi internazionali.
• Audit trail finanziario.
• Immutabilità log.

PCI-DSS

• Per aziende che gestiscono carte di credito.
• Logging accessi a dati sensibili.

Casi d'uso

Compliance audit

Auditor chiede: "chi ha modificato la tabella clienti negli ultimi 6 mesi?".

Risposta: filtro log scrittura su tabella clienti, periodo 6 mesi. Esportazione PDF. 30 secondi.

Investigazione sospetto abuso

Sospetto che un dipendente esterno abbia esportato dati massivamente:

• Filtro log query per quell'utente.
• Identifica pattern (centinaia di query in poco tempo, esportazioni grandi).
• Decisione disciplinare con prove.

Troubleshooting bug

"L'AI sbaglia sempre quando chiedo X":

• Debug log mostra prompt completo, schema utilizzato, SQL generata.
• IT identifica il problema (schema mancante, glossario insufficiente).
• Fix.

Performance optimization

Query troppo lente:

• Log mostra tempi step-by-step.
• Identifico bottleneck (es. JOIN inefficiente, indice mancante).
• Ottimizzo.

I moduli ReportIA correlati

• Cronologia.
• Operazioni Scrittura.
• Public API.
• Gestione Utenti.

Scopri ReportIA con audit trail completo.