Hoe voorkom je dat Docker-logs de opstartschijf van een host vullen?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Stop direct het proces dat de logs produceert, identificeer de actieve logbestemming en stel vervolgens begrensde logrotatie in. Los ook de fout of herstartlus op die de overmatige logs veroorzaakt.

Op een NAS of homeserver op basis van Docker kan de opstartschijf vol raken, zelfs wanneer media en databases op een andere pool staan, omdat stdout en stderr van containers, gegevens uit het systemd-journaal en systeemeigen applicatiebestanden nog steeds op het systeembestandssysteem kunnen staan. De veilige volgorde is: voldoende recente bewijzen bewaren, onbeheersbare groei stoppen, vaststellen welke logginglaag de ruimte inneemt, retentie instellen voor bestaande en toekomstige services en controleren of de onderliggende applicatie niet langer dezelfde hoeveelheid gegevens produceert.

Zoek de logopslag die daadwerkelijk groeit

Controleer de vrije ruimte op het opstartbestandssysteem en vergelijk vervolgens de grootte van de gegevensroot van Docker, logbestanden per container, het systeemjournaal en applicatielogmappen die vanaf de host zijn gekoppeld. Noteer de grootste paden voordat je iets verwijdert of afkapt.

In een Docker-geval rond schijfruimte bleek uit de gebruikelijke Docker-overzichten niet wat de meeste ruimte innam, omdat het standaardlogbestand afzonderlijk groeide. Het doorslaggevende bewijs was een steeds groter wordend containerlog in het lokale Docker-opslagpad.

Controleer de geconfigureerde logdriver en het logpad van elke actieve container en koppel vervolgens het grootste bestand aan de containernaam en recente berichten. Als geen containerlog het ruimtegebruik verklaart, onderzoek dan journald en de eigen mappen van de applicatie in plaats van ervan uit te gaan dat elk Docker-gerelateerd schijfprobleem bij json-file hoort.

Stop de container die de meeste logs produceert voordat je noodopruiming uitvoert

Wanneer de opstartschijf bijna vol is, pauzeer of stop je de container die het snelst groeit. Bewaar een begrensd deel van de meest recente log, het aantal herstarts, de afsluitstatus, de imageversie, de omgeving, de mounts en de eerste terugkerende fout voordat je ruimte vrijmaakt.

Beheerders ontdekken vaak dat JSON-logs van containers de resterende schijfruimte kunnen verbruiken wanneer er geen groottebeperking is ingesteld. Een lange discussie op Stack Overflow wijst onbeperkte groei van JSON-logs aan als een afzonderlijk capaciteitsrisico, los van gegevens van images en volumes.

Verwijder een actief logbestand niet zomaar terwijl Docker het nog geopend heeft en verwijder nooit willekeurige mappen uit de metagegevensstructuur van Docker. Gebruik de door het platform ondersteunde procedure voor rotatie of het leegmaken van bestanden pas nadat de producent is gestopt. Controleer vervolgens of de vrijgekomen blokken zichtbaar zijn voordat je een getroffen service opnieuw start.

Pas begrensde rotatie toe op elke langdurig actieve service

Stel expliciete logboekstuurprogramma's en eindige rotatielimieten in bij de Compose-service of in de containerconfiguratie. Voor het gangbare JSON-stuurprogramma zijn de belangrijkste instellingen een maximale bestandsgrootte en een beperkt aantal bewaarde bestanden.

Een discussiethread van de Docker-community over logrotatie legt uit dat opties zoals max-size en max-file begrenzen hoeveel lokale geschiedenis รฉรฉn container bewaart. De operationele vereiste is een eindig rotatiebeleid, geen bestand dat onbeperkt blijft groeien.

Kies limieten op basis van hoe snel een incident moet kunnen worden vastgesteld en hoeveel ruimte op de opstartschijf de host veilig kan reserveren. Maak de service opnieuw aan, zodat de actieve container de nieuwe loggingconfiguratie krijgt, controleer vervolgens de effectieve instellingen en voer een kleine, gecontroleerde test uit om te bevestigen dat bestanden naar verwachting worden geroteerd.

Stel standaarden in voor toekomstige containers zonder aan te nemen dat bestaande containers worden aangepast

Configureer een standaardinstelling op daemon- of platformniveau voor nieuw aangemaakte containers, zodat een ontbrekende service-instelling niet ongemerkt leidt tot onbeperkte lokale logging. Laat kritieke services zo nodig een specifiekere instelling gebruiken als hun diagnostische behoeften verschillen.

Een wijziging van de standaardinstelling voor Docker-logging past niet met terugwerkende kracht de hostconfiguratie van elke bestaande container aan. Dezelfde communityrichtlijnen maken onderscheid tussen daemonstandaarden en instellingen per container bij het aanmaken, dus oude services moeten worden gecontroleerd en bewust opnieuw worden aangemaakt.

Voer de wijziging eerst door voor รฉรฉn niet-kritieke service. Controleer of het ophalen van logs, monitoring, waarschuwingen en ondersteuningsprocessen nog werken. Maak daarna de overige services in beheersbare batches opnieuw aan, zonder hun persistente volumes te verwijderen.

Los de gebeurtenis op die de logvloed veroorzaakt

Rotatie beperkt de schade, maar lost niets op aan een container die om de paar seconden herstart, een onbereikbare database opnieuw probeert te bereiken, bij elke gezondheidscontrole een logbericht schrijft, te maken krijgt met een aanval of een stortvloed aan verzoeken, of na het oplossen van problemen in de debugmodus is blijven staan.

Een Docker-gebruiker herleidde een JSON-logbestand van ongeveer 80 GB tot overmatige debuguitvoer. Dit laat zien hoe uitvoer op debugniveau een opstartschijf kan overbelasten, zelfs wanneer rotatie de directe noodmaatregel is.

Groepeer herhaalde berichten op frequentie en eerste tijdstip en herstel vervolgens de vroegste onderliggende fout. De ZimaSpace-handleiding voor het opsporen van een afhankelijkheid die een herstartlus veroorzaakt is de volgende stap in de diagnose wanneer verbindings-, mount-, geheim- of gereedheidsproblemen een logstorm veroorzaken.

Houd Docker-, Journald- en applicatielogs apart bij

Een container kan stdout naar Docker sturen en tegelijkertijd eigen bestanden naar een bind-mount schrijven, terwijl de Docker-service zelf daemon-gebeurtenissen naar journald kan sturen. Voor elke bestemming bepaalt een andere component het retentiebeleid, en elk ervan kan afzonderlijk hetzelfde opstartbestandssysteem vullen.

Beheerders van homeservers melden dat logmappen van applicaties blijven groeien, ondanks de verwachting dat rotatie op Docker-niveau dit zou beperken. Een casus uit de TrueNAS-community laat zien dat het belangrijk is om eerst vast te stellen welke logginglaag het retentiebeleid beheert voordat limieten worden aangepast.

Leg een post-fix-nulmeting vast van het gebruik van de opstartschijf, de grootste logbestanden, de journaalgrootte, het aantal containerherstarts en de dagelijkse groei. De reparatie is pas voltooid wanneer elke actieve logbestemming een begrensd beleid heeft, de luidruchtige service stabiel blijft onder de normale belasting en een bewuste herstart niet opnieuw onbeperkte bestanden aanmaakt.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.