Hoe voorkom je dat Home Assistant-logs de systeemschijf vullen

Eva Wong

IceWhale author

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

How to Prevent Home Assistant Logs From Filling the System Disk

Voorkom dat Home Assistant-logboeken de schijf vullen door eerst het exacte groeiende bestand te identificeren, de terugkerende gebeurtenis te corrigeren en bewaarbeleid toe te passen op de laag die dat logboek beheert.

Op een kleine homeserver kunnen Core-logboeken van Home Assistant, Docker-logboeken, logboeken van Supervisor of add-ons en het journal van de host allemaal dezelfde systeemschijf vullen, terwijl hiervoor verschillende oplossingen nodig zijn. Meet de groei gedurende een korte, gecontroleerde periode, bewaar voldoende bewijsmateriaal om de schrijver te identificeren, gebruik omkeerbare limieten en stop niet-essentiële schrijfbewerkingen als er te weinig ruimte over is voor een veilige herstart of back-up.

Identificeer welk logboek ruimte inneemt

Noteer eerst de totale vrije ruimte en geef vervolgens de grootste bestanden en mappen op het getroffen bestandssysteem weer, zonder iets te verwijderen. Vergelijk de grootte na vijf tot tien minuten opnieuw terwijl Home Assistant normaal draait. Het bestand waarvan de grootte verandert, is nuttiger dan een statische lijst met oude grote bestanden.

Uit Home Assistant-gevallen blijkt dat schijfruimte ook door andere lagen kan worden uitgeput, waaronder systeemlogboeken in plaats van de Recorder-database. In een opgeloste discussie werd de groei teruggevoerd naar het systemd-journal. Het eerste onderscheid is dus welke map blijft groeien, niet of Home Assistant druk lijkt te zijn.

Als één Core-logboek groeit, controleer dan de terugkerende component en het bericht. Als JSON-logboeken van Docker groeien, controleer dan het logstuurprogramma van de container. Als het journal groeit, controleer dan de service die de berichten genereert. Als de vrije ruimte al kritiek laag is, stop dan de luidruchtigste niet-essentiële container of Home Assistant zelf voordat verdere schrijfbewerkingen herstel moeilijker maken.

Los terugkerende fouten op voordat je de zichtbaarheid vermindert

Tel het meest voorkomende bericht en koppel de tijdstempels aan een apparaat, integratie, automatisering, add-on of netwerkgebeurtenis. Een waarschuwing die duizenden keren wordt herhaald, heeft doorgaans meer preventieve waarde dan tientallen losstaande vermeldingen. Bewaar een kort voorbeeld met de versie en trigger voordat je instellingen wijzigt.

In een probleem met Home Assistant Core werd een Tradfri-fout beschreven die een logboek tot meer dan 10 GB liet groeien en de systeemschijf volledig vulde. Dit is een versiegebonden voorbeeld van één integratie die een logboek overspoelt; het ondersteunt het isoleren van de bron, niet de aanname dat Tradfri of logrotatie altijd de oorzaak is.

Schakel foutopsporingslogboeken uit zodra het vastleggen is voltooid. Laad vervolgens alleen de bevestigde problematische integratie opnieuw of schakel deze uit en herhaal de oorspronkelijke trigger. Als de berichtfrequentie sterk afneemt, herstel dan die integratie of de bijbehorende afhankelijkheid. Als dat niet gebeurt, zet je de instelling terug en ga je naar de volgende geverifieerde bron, in plaats van alle waarschuwingen te onderdrukken.

Stel bewaarbeleid in op de laag die het logboek beheert

Stel afzonderlijk een begrensd beleid in voor het journal van de host, het Docker-logstuurprogramma, de reverseproxy en andere add-ons. Een logboekniveau van Core begrenst de opslag van het systemd-journal niet, en een Docker-grootteoptie roteert geen bestand dat rechtstreeks in een gekoppelde configuratiemap wordt geschreven.

Kies limieten die voldoende geschiedenis bewaren voor de periode tussen controles, maar ruimte vrijhouden voor back-ups, updates, databasewerkzaamheden en herstel. Het gerelateerde ZimaSpace-artikel over vrije opslagruimte voor Home Assistant legt uit waarom het opgebruiken van de laatste marge werkzaamheden kan verstoren waarvoor tijdelijk extra schijfruimte nodig is.

Documenteer elk beleid in de configuratie die behouden blijft wanneer een service opnieuw wordt aangemaakt. Herstart of maak alleen de getroffen service opnieuw aan, controleer of de instelling actief is en houd de vorige waarde gereed voor terugdraaien. Gebruik geen geplande algemene verwijdering als vervanging voor het vinden van een abnormale schrijver.

-15% OFF

ZimaBoard 2 - Mini-thuisserver voor jouw grote idee

Single board computer zimaboard2

Controleer of de groei begrensd blijft onder de oorspronkelijke trigger

Reproduceer de gebeurtenis die de overvloed aan logberichten veroorzaakte, zoals een apparaat dat offline gaat, een integratie die opnieuw probeert, een back-up of een netwerkstoring. Houd dezelfde bestandsgrootte, berichtfrequentie, vrije ruimte, servicestatus en reactie van automatiseringen langer bij dan de eerdere groeiperiode.

Een geslaagd resultaat bestaat uit een stabiele of roterende logvoetafdruk, geen verlies van noodzakelijke diagnostische informatie, normale schrijfbewerkingen naar de geschiedenis en voldoende vrije ruimte voor de volgende back-up en update. Herstart de host eenmaal en herhaal de trigger, zodat de limieten ook na het opnieuw aanmaken van services zijn bewezen.

Draai een wijziging in het bewaarbeleid terug als daardoor het bewijsmateriaal verdwijnt dat nodig is om een aanhoudende fout te diagnosticeren. Schakel hulp in met het herhaalde bericht, de broncomponent, versie, groeisnelheid en opslaglocatie als het logboek blijft groeien nadat de bevestigde bron is geïsoleerd. Stop de schrijfbewerkingen opnieuw als de schijf bijna vol raakt.