Soluzione della community

Visualizzatore dei log di ZimaOS: spiegazione dei log Docker e dei log di sistema

A user requested both system and Docker log viewing; IceWhale clarified that container logs were already available in the app settings UI.

ZimaOS disponeva già di un visualizzatore dei log dei container Docker quando è stata pubblicata questa richiesta di funzionalità del 2025, ma la richiesta di un visualizzatore completo dei log di sistema/journal era rimasta separata. IceWhale ha corretto la risposta iniziale e ha mostrato il controllo “Terminale e log” già disponibile per le app.

Ciò significa che non bisogna confondere due esigenze diverse: i log dei container delle app fanno parte del flusso di lavoro dell’applicazione, mentre journalctl a livello di host e i log dei servizi di sistema servono per una diagnostica più approfondita.

I log delle app Docker erano già disponibili

Impostazioni dell’app ZimaOS con un pulsante Terminale e log
IceWhale ha fatto notare che i log delle applicazioni Docker erano già disponibili dall’interfaccia delle impostazioni dell’app. Fonte: forum della community IceWhale.

Lo screenshot di IceWhale mostra l’interfaccia delle impostazioni dell’app con un pulsante Terminale e log. Se un container non si avvia, si chiude ripetutamente o restituisce un’interfaccia Web non funzionante, questa dovrebbe essere la prima fonte di log da consultare.

I log di sistema appartengono a un livello diverso

Una risposta successiva della community chiedeva specificamente un visualizzatore dei log dell’intero sistema ZimaOS, simile a journalctl. La discussione originale non mostra che, in seguito alla richiesta, sia stato distribuito un browser completo dei log dell’host.

La documentazione attuale di ZimaOS offre ancora il terminale per la diagnostica più approfondita. La panoramica delle funzionalità di ZimaOS indica che, durante la risoluzione dei problemi, sono disponibili i log integrati e l’accesso al terminale.

Inizia dalla fonte di log più circoscritta

Se un’app Docker non funziona, esamina i log di quell’app prima di cercare tra tutti i servizi di sistema. Se si verificano problemi di archiviazione, rete, avvio o nei servizi nativi di ZimaOS, passa al terminale dell’host e al log di sistema pertinente.

La guida alle basi delle app Docker aiuta a distinguere i problemi a livello di container da quelli a livello di host.

Acquisisci i log prima di riavviare tutto

Un riavvio può cancellare lo stato che ha causato un errore temporaneo. Salva l’errore, il timestamp, il nome del container e la versione di ZimaOS prima di riavviare un’app o l’intero NAS.

In sintesi

La richiesta del 2025 si basava in parte su una funzionalità già presente ma trascurata: i log Docker erano già disponibili nell’interfaccia delle impostazioni dell’app. La richiesta più ampia di un visualizzatore del journal dell’intero host è diversa. Inizia dal log dell’app per i problemi delle app e usa i log del terminale e del sistema solo quando il problema si trova al di sotto del livello Docker.