Archivio S3 e monitoraggio

Monitoraggio aziendale

Dal collegamento Monitoraggio aziendale del portale, un amministratore diretto dell’azienda può consultare richieste, errori, latenza, log operativi e tracce attribuite ai propri tenant autorizzati.

Le viste sono di sola lettura e non espongono prompt o contenuti chat. Non accettano query arbitrarie dei clienti. Un membro, un responsabile gruppo o un amministratore reseller senza ruolo diretto nell’azienda non acquisisce automaticamente accesso al monitoraggio di quell’azienda.

Le query hanno un intervallo massimo di sette giorni e risultati limitati. I dati iniziano dalla telemetria attribuita dopo l’attivazione: l’assenza di dati precedenti non indica assenza di consumi contabili.

Attivare l’archivio chat

Dove: Archivio chat S3. Richiede un ruolo amministrativo aziendale consentito.

1. Predisponi un bucket AWS S3 e una credenziale con i permessi richiesti.
2. Inserisci bucket, regione, prefisso e credenziali nella pagina.
3. Mantieni Maschera i dati personali riconosciuti se desideri l’esportazione pseudonimizzata.
4. Esegui il test della destinazione, salva e attiva l’esportazione.
5. Controlla contatori e Ultimi invii dopo una nuova richiesta completata.

Il test verifica l’accesso al bucket; il primo upload verifica anche i permessi sul prefisso. Sono supportati bucket AWS S3, non endpoint arbitrari inseriti dal cliente.

Contenuti inclusi ed esclusi

Sono inclusi i nuovi scambi API e portale completati e contabilizzati, anche in streaming. Non è un export storico. Sono esclusi classificazioni interne Switchyard, risposte interrotte, immagini/audio, firme e contenuti opachi cifrati.

Con mascheramento, i frammenti di ogni canale SSE vengono uniti prima della rilevazione: i confini originali dei chunk non sono conservati. Un servizio PII non disponibile blocca l’invio mascherato. Il rilevamento automatico può comunque non identificare ogni dato personale.

Un evento troppo grande può generare un record con export_error=payload_too_large, senza testo parziale. L’archivio non garantisce ogni risposta in caso di crash tra completamento e accodamento.

Permessi del bucket

La credenziale necessita di s3:ListBucket sul bucket e s3:PutObject/s3:GetObject sul prefisso destinato all’archivio. L’applicazione non richiede DeleteObject. Non usare credenziali più ampie del necessario.

I file sono Parquet compressi Zstd, con cifratura server-side richiesta e oggetti immutabili. Il percorso segue questa struttura:

PREFIX/tenant_id=UUID/schema_version=1/date=YYYY-MM-DD/hour=HH/part-BATCH_UUID.parquet

Il portale propone una query DuckDB da adattare alla propria destinazione. Configura le credenziali nel tuo ambiente, senza incollarle nel codice della query condiviso.

Conservazione e modifiche

I payload locali in attesa scadono dopo 24 ore; i metadati operativi degli invii restano per 30 giorni. Il cliente decide retention, accessi e cancellazione degli oggetti già ricevuti.

Le nuove impostazioni si applicano ai nuovi eventi. Quelli già accodati mantengono destinazione, credenziali e scelta PII originali: coordina la rotazione prima di revocare la vecchia credenziale. Disattivare l’archivio annulla gli eventi in attesa; un invio già iniziato può completarsi.