Domande frequenti e risoluzione dei problemi
Domande generali
Di cosa ho bisogno per usare DockTrace?
Un’istanza Dozzle self-hosted raggiungibile dal tuo iPhone — nella rete locale oppure, ad esempio, tramite VPN. DockTrace è il companion, Dozzle gira da te.
DockTrace sostituisce l'interfaccia web di Dozzle?
No, volutamente no. DockTrace non è un porting 1:1, ma è costruito per lo sguardo mobile: quadro della situazione, Incidents con priorità e Favorites invece di una console di amministrazione completa. Per le analisi approfondite resta giusto usare il browser al computer.
Cosa sono gli Incidents?
DockTrace raggruppa le righe di log di errore simili tramite un fingerprint in Incidents — con gravità, frequenza e ultima comparsa. Così vedi a colpo d’occhio se si tratta di un problema ricorrente, invece di scorrere lo stesso messaggio di errore cento volte.
Dove vengono salvate le mie credenziali?
Esclusivamente in locale sul tuo dispositivo, nel portachiavi iOS. Non c’è alcun cloud né alcun account; allo sviluppatore arriva solo una statistica d’uso anonima e disattivabile, senza alcun riferimento ai tuoi server o log (vedi l’informativa sulla privacy). Facoltativamente puoi proteggere l’app con Face ID.
Posso connettere più server?
Sì, tutte le istanze Dozzle che vuoi. L’elenco dei container si può filtrare per server, e l’Overview mostra tutti i server con il loro stato, affiancati.
Risoluzione dei problemi
La connessione al server non riesce
Controlla lo schema e la porta dell’URL di Dozzle (http o https) e se l’istanza è raggiungibile dalla rete attuale — fuori dalla rete locale ti serve tipicamente una VPN o un reverse proxy. Se l’autenticazione di Dozzle è attiva, le credenziali devono essere inserite nelle impostazioni del server.
Non compare nessun Incident
Gli Incidents nascono dalle righe di log di errore più recenti. Se i tuoi container girano senza problemi, l’elenco resta vuoto — è la condizione ideale. In caso di dubbio, controlla nei Live-Logs se arrivano davvero degli errori.
I Live-Logs restano vuoti o si interrompono
Un reverse proxy davanti a Dozzle deve consentire le connessioni di streaming (SSE/WebSocket) e non deve interromperle dopo poco tempo. Controlla i timeout e le impostazioni di buffering del tuo proxy.
Mancano dei container o sembrano non aggiornati
Trascina l’elenco verso il basso per aggiornarlo (pull-to-refresh) e controlla lo stato del server nell’Overview. Se non basta, passa brevemente a un altro server e ritorna, oppure riavvia l’app.