Troubleshooting e Log

Nonostante la cura costruttiva, a volte qualcosa può andare storto. Solo include strumenti diagnostici professionali per aiutarti a capire cosa succede “sotto il cofano” e per facilitare la risoluzione di bug o problemi di rete complessi.

---

Analisi Diagnostica

Quando incontri un comportamento inaspettato (es. un crash o una richiesta che non parte), Solo registra ogni evento importante nei suoi log interni.

Cosa viene registrato?

• Errori di Rete: Dettagli sugli handshake TLS falliti o timeout DNS.
• Script Panic: Errori di sintassi o logici nei tuoi script Lua.
• Operazioni Git: L’output completo dei comandi Git per diagnosticare problemi di sincronizzazione.
• Stato del Sistema: Errori di scrittura su disco o permessi insufficienti.

---

Esportazione per il Supporto

Se devi segnalare un bug agli sviluppatori di Solo, la cosa migliore da fare è inviare un pacchetto diagnostico completo.

1. Vai in Settings: Apri il pannello delle impostazioni.
2. Trova Troubleshooting: Naviga fino alla sezione “Troubleshooting”.
3. Genera l’Archivio: Clicca sul pulsante “Download logs (.zip)”.
4. Salva il File: Scegli una cartella sul tuo computer. Solo creerà un file ZIP contenente tutti i log recenti, pronti per essere allegati a un ticket di supporto o a una Issue su GitHub.

Privacy dei Log

Solo non registra mai i segreti (password, chiavi) all’interno dei log di sistema, a meno che tu non decida di loggarli esplicitamente usando la funzione env.log() nei tuoi script Lua.

---

Modalità Debug

Se hai bisogno di ancora più dettagli, puoi attivare la Debug Mode.

• Cosa fa: Aumenta la verbosità dei log, registrando ogni singola operazione interna dell’applicazione, inclusi i dettagli tecnici dello scambio dati tra il frontend e il backend.
• Quando usarla: Solo se richiesto dal supporto tecnico o se stai sviluppando script Lua molto complessi e vuoi vedere ogni passaggio intermedio.

Performance in Debug

Mantenere la Debug Mode attiva costantemente può rallentare leggermente l’applicazione e far crescere velocemente la dimensione dei file di log. Ti consigliamo di disattivarla una volta terminata la diagnosi.

---

Problemi Comuni e Soluzioni Rapide

Problema	Possibile Causa	Soluzione
L’app non si avvia	File di configurazione corrotto.	Prova a rinominare la cartella ~/.solo per farla rigenerare all’app.
Log Vuoti	App appena installata.	Esegui qualche richiesta o operazione per generare attività.
Sync Git Fallisce	Credenziali SSH non trovate.	Assicurati che ssh-agent sia attivo e contenga la tua chiave.
Script Errore 500ms	Loop infinito in Lua.	Controlla la logica dello script per evitare cicli senza fine.

---

Risoluzione Problemi (Failure Map)

Assenza di Log

Se clicchi su “Download logs” e Solo ti avvisa che non ci sono file, significa che non si sono verificati eventi degni di nota o che l’app non ha i permessi per scrivere nella sua cartella di log.

ZIP Danneggiato

Assicurati di avere abbastanza spazio sul disco prima di esportare i log. Se il processo di compressione viene interrotto, il file ZIP risultante potrebbe essere illeggibile.

Cartella di Configurazione

Per i più esperti: puoi trovare tutti i file di Solo (collezioni, ambienti, log) nella cartella nascosta .solo all’interno della tua Home directory (~/.solo su macOS/Linux o C:\Users\Nome\.solo su Windows).