Communityoplossing

ZimaOS-logviewer: Docker-logs versus systeemlogs uitgelegd

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

ZimaOS had al een logviewer voor Docker-containers toen dit functievoorstel uit 2025 werd geplaatst, maar het verzoek om een volledige viewer voor systeem- en journaallogs bleef afzonderlijk bestaan. IceWhale corrigeerde zijn eerste antwoord en toonde de bestaande knop ‘Terminal en logs’ voor apps.

Dat betekent dat twee verschillende behoeften niet door elkaar gehaald mogen worden: logs van app-containers maken deel uit van de applicatieworkflow, terwijl journalctl-logs op hostniveau en logs van systeemservices diepgaandere diagnostiek bieden.

Docker-applogs waren al beschikbaar

ZimaOS-appinstellingen met een knop Terminal en logs
IceWhale wees erop dat Docker-applogs al beschikbaar waren vanuit de interface met appinstellingen. Bron: IceWhale Community Forum.

De schermafbeelding van IceWhale toont de interface met appinstellingen en een knop Terminal en logs. Als een container niet start, steeds opnieuw afsluit of een defecte webinterface oplevert, hoort dit de eerste logbron te zijn.

Systeemlogs bevinden zich op een andere laag

Een later antwoord van de community vroeg specifiek om een ZimaOS-brede logviewer, vergelijkbaar met journalctl. Uit de oorspronkelijke thread blijkt niet dat er naar aanleiding van het verzoek een volledige logbrowser voor de host is uitgebracht.

De huidige ZimaOS-documentatie biedt nog steeds toegang tot de terminal voor diepgaandere diagnostiek. Het overzicht van ZimaOS-functies vermeldt dat ingebouwde logs en terminaltoegang beschikbaar zijn bij het oplossen van problemen.

Gebruik eerst de meest specifieke logbron

Als één Docker-app defect is, bekijk dan de logs van die app voordat je alle systeemservices doorzoekt. Als opslag, netwerk, opstartproces of ZimaOS-eigen services problemen geven, ga dan naar de hostterminal en het relevante systeemlogboek.

De basisprincipes van Docker-apps helpen om fouten op containerniveau te onderscheiden van fouten op hostniveau.

Leg logs vast voordat je alles opnieuw opstart

Een herstart kan de toestand wissen die een tijdelijke fout heeft veroorzaakt. Sla de foutmelding, het tijdstip, de containernaam en de ZimaOS-versie op voordat je een app of de hele NAS opnieuw start.

Kort samengevat

Het verzoek uit 2025 was deels gebaseerd op een over het hoofd geziene functie: Docker-logs waren al beschikbaar in de interface met appinstellingen. Het bredere verzoek om een hostbrede journalviewer is iets anders. Begin bij appfouten met het applogboek en gebruik terminal- en systeemlogs alleen wanneer de oorzaak zich onder Docker bevindt.