Log per l'assistenza

Aggiornato a ottobre 2026

Quando qualcosa si inceppa, i log sono la via più rapida verso la causa: YouniqMail scrive di continuo procedure, avvisi ed errori in file che registrano con precisione che cosa è andato storto e quando. Una richiesta di assistenza con i log risparmia quasi sempre il giro di «puoi descriverlo meglio?».

Aprire la cartella dei log

La strada comoda passa dall’applicazione: in Impostazioni → Avanzate, nella sezione Registrazione log, accanto a Posizione dei file di log: c’è il percorso come link. Un clic apre la cartella.

Se l’applicazione non parte proprio, raggiungi la cartella direttamente nel file system: sta nella cartella dei dati, sotto logs:

Sistema operativo:macOSWindowsLinux

~/Library/Application Support/YouniqMail/logs/

Nel Finder: Vai → Vai alla cartella… e incolla il percorso.

%APPDATA%\YouniqMail\logs\

Incolla la riga così com’è nella barra degli indirizzi di Esplora risorse, %APPDATA% lo risolve Windows da solo.

~/.config/YouniqMail/logs/

Il file attuale si chiama main.log. Quando raggiunge 5 MB diventa main.old.log e ne comincia uno nuovo; le versioni più vecchie vengono sovrascritte.

Registrazione di debug

Per i casi ostinati c’è il livello dettagliato: l’interruttore Abilita registrazione di debug in Impostazioni → Avanzate. Così l’applicazione annota molto più in dettaglio, anche la durata di molte procedure, e intanto diventa un po’ più lenta. La procedura sensata è questa:

1. Attiva la registrazione di debug.
2. Provoca il problema una volta di proposito.
3. Raccogli i log e disattiva di nuovo il livello di debug.

Che cosa c’è nei log e che cosa no

I log contengono processi tecnici: marche temporali, messaggi di errore, ID degli account interessati e nomi dei server. Password, token di accesso e chiavi YouniqMail li filtra prima di scrivere, e i nomi delle cartelle vengono abbreviati in molti punti. I testi e gli oggetti dei messaggi non ci sono, ma possono comparire indirizzi e-mail. Se la cosa ti sta a cuore, dai un’occhiata veloce prima di inoltrarli; i file sono normale testo.

All’assistenza

Manda il file main.log (se il problema è appena stato riprodotto, basta quello, altrimenti anche main.old.log) insieme a tre indicazioni:

• Che cosa hai fatto? («ho controllato l’account X», «ho aperto un messaggio con un allegato grande»)
• Che cosa è successo, e che cosa ti aspettavi?
• Da quando? («dopo l’aggiornamento», «da quando ho cambiato fornitore»)

Utile è anche un rapporto diagnostico: in Impostazioni → Importa / Esporta, nella sezione Segnala un problema, Esporta rapporto diagnostico crea un file con la versione dell’app, il sistema operativo, statistiche del database (solo quantità) e la struttura anonimizzata delle tue regole. Contenuti dei messaggi, contatti e password non sono inclusi.

Con questo, nella maggior parte dei casi, la ricerca dell’errore è breve.