Come impedire ai log di Docker di riempire il disco di avvio dell’host?

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Arresta subito il processo che genera i log, individua la destinazione attiva dei log, poi applica una rotazione con limiti e correggi l’errore o il ciclo di riavvii che genera il flusso eccessivo.

Su un NAS basato su Docker o su un server domestico, il disco di avvio può riempirsi anche quando i contenuti multimediali e i database risiedono in un altro pool, perché stdout e stderr dei container, i dati del journal di systemd e i file nativi delle applicazioni possono comunque rimanere nel filesystem di sistema. La sequenza sicura consiste nel conservare una quantità sufficiente di prove recenti, arrestare la crescita incontrollata, identificare il livello di logging che occupa lo spazio, configurare la conservazione per i servizi esistenti e futuri e verificare che l’applicazione sottostante non generi più lo stesso volume di log.

Individua l’archivio dei log che sta davvero crescendo

Controlla lo spazio libero sul filesystem di avvio, poi confronta le dimensioni della directory dati di Docker, dei file di log dei singoli container, del journal di sistema e delle directory dei log delle applicazioni montate dall’host. Registra i percorsi più ingombranti prima di eliminare o troncare qualsiasi cosa.

Un caso di esaurimento dello spazio su disco di Docker ha rivelato che i normali riepiloghi di Docker non mostravano il principale responsabile, perché il file di log predefinito cresceva separatamente. La prova decisiva era un log di container in continua crescita nel percorso di archiviazione Docker locale.

Esamina il driver di logging configurato e il percorso dei log di ogni container in esecuzione, poi associa il file più grande al nome del container e ai messaggi recenti. Se nessun log dei container spiega l’utilizzo, controlla journalD e le cartelle native delle applicazioni invece di presumere che ogni problema di spazio su disco relativo a Docker dipenda da json-file.

Arresta il container che genera troppo rumore prima della pulizia d’emergenza

Quando il disco di avvio è quasi pieno, sospendi o arresta il container che sta crescendo più rapidamente. Salva una porzione limitata delle righe finali del log, il numero di riavvii, lo stato di uscita, la versione dell’immagine, l’ambiente, i mount e il primo errore ripetuto prima di recuperare spazio.

Gli amministratori scoprono spesso che i log JSON dei container possono occupare lo spazio libero rimanente sul disco se non è configurato un limite di dimensione. Una lunga discussione su Stack Overflow identifica la crescita illimitata dei log JSON come un rischio di capacità distinto dai dati di immagini e volumi.

Non eliminare alla cieca un file di log attivo mentre Docker lo tiene aperto e non rimuovere mai directory a caso dall’albero dei metadati di Docker. Usa la procedura di rotazione o troncamento supportata dalla piattaforma solo dopo aver arrestato il processo che genera i log, quindi verifica che i blocchi liberati siano effettivamente disponibili prima di riavviare i servizi interessati.

Applica una rotazione con limiti a ogni servizio a esecuzione prolungata

Imposta un driver di log esplicito e limiti di rotazione finiti nella configurazione del servizio Compose o del container. Per il comune driver JSON, i controlli importanti sono la dimensione massima del file e un numero limitato di file conservati.

Una discussione sulla rotazione nella community Docker spiega che opzioni come max-size e max-file limitano la quantità di cronologia locale conservata da un container. Il requisito operativo è una policy di rotazione con limiti finiti, non un unico file che cresce all’infinito.

Scegli i limiti in base alla rapidità con cui deve essere diagnosticato un incidente e alla quantità di spazio su disco di avvio che l’host può riservare in sicurezza. Ricrea il servizio affinché il container in esecuzione riceva la nuova configurazione di logging, quindi controlla le impostazioni effettive ed esegui un piccolo test controllato per verificare che i file vengano ruotati come previsto.

Imposta le impostazioni predefinite per i container futuri senza presumere che modifichino quelli esistenti

Configura un’impostazione predefinita a livello di daemon o piattaforma per i nuovi container, in modo che l’assenza di un’impostazione nel servizio non ripristini silenziosamente un logging locale illimitato. Lascia ai servizi critici la possibilità di usare un override più specifico quando le loro esigenze diagnostiche sono diverse.

La modifica delle impostazioni predefinite di logging di Docker non riscrive retroattivamente la configurazione host di tutti i container esistenti. Le indicazioni della community distinguono allo stesso modo le impostazioni predefinite del daemon dalle impostazioni di creazione specifiche del container, quindi i vecchi servizi devono essere esaminati e ricreati intenzionalmente.

Applica prima la modifica a un servizio non critico. Verifica che il recupero dei log, il monitoraggio, gli avvisi e i flussi di lavoro dell'assistenza continuino a funzionare, quindi ricrea gli altri servizi in batch controllati senza rimuovere i rispettivi volumi persistenti.

Correggi l'evento che genera la tempesta di log

La rotazione limita i danni, ma non risolve il problema di un container che si riavvia ogni pochi secondi, riprova a raggiungere un database irraggiungibile, registra ogni controllo di integrità, subisce un attacco o un'ondata di richieste, oppure è rimasto in modalità debug dopo la risoluzione dei problemi.

Un utente Docker ha ricondotto un file JSON di circa 80 GB a un eccesso di output di debug, mostrando come l'output a livello di debug possa saturare un disco di avvio, anche quando la rotazione è la misura di protezione immediata.

Raggruppa i messaggi ripetuti in base alla frequenza e all'ora della prima comparsa, quindi correggi l'errore di origine più precoce. La guida di ZimaSpace per individuare una dipendenza che causa un ciclo di riavvio è il passaggio diagnostico successivo quando problemi di connessione, mount, secret o readiness generano una tempesta di log.

Tieni separati i log di Docker, Journald e delle applicazioni

Un container può inviare stdout a Docker e scrivere anche i propri file in un bind mount, mentre il servizio Docker stesso può inviare gli eventi del daemon a journald. Ogni destinazione ha un responsabile diverso per la conservazione e può riempire autonomamente lo stesso filesystem di avvio.

Gli operatori di server domestici hanno segnalato che le directory dei log delle applicazioni continuano a crescere, nonostante le aspettative che la rotazione a livello Docker le contenga. Un caso della community TrueNAS evidenzia la necessità di identificare quale livello di logging gestisce la conservazione prima di modificare i limiti.

Registra una situazione di riferimento post-intervento per l'uso del disco di avvio, i file di log più grandi, le dimensioni del journal, il numero di riavvii dei container e la crescita giornaliera. La riparazione è completa solo quando ogni destinazione attiva ha una policy con limiti, il servizio che genera rumore rimane stabile con il suo carico di lavoro abituale e un riavvio intenzionale non ricrea file senza limiti.

Assistenza e consigli

Altre letture

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.