Jak zapobiec zapełnianiu dysku systemowego przez logi Home Assistant

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Zapobiegaj zapełnianiu dysku przez logi Home Assistant, najpierw ustalając, który dokładnie plik rośnie, usuwając przyczynę powtarzających się zdarzeń i stosując retencję na poziomie, który odpowiada za dany log.

Na małym serwerze domowym logi Home Assistant Core, logi Dockera, logi Supervisora lub dodatków oraz dziennik hosta mogą zajmować ten sam dysk systemowy, a każdy z tych przypadków wymaga innego rozwiązania. Mierz przyrost w krótkim, kontrolowanym przedziale, zachowaj dość danych, by ustalić źródło zapisów, stosuj odwracalne limity i zatrzymaj nieistotne zapisy, jeśli pozostało zbyt mało miejsca na bezpieczny restart lub kopię zapasową.

Ustal, który log zajmuje miejsce

Zapisz całkowitą ilość wolnego miejsca, a następnie wyświetl największe pliki i katalogi w zajętym systemie plików, niczego nie usuwając. Po pięciu do dziesięciu minutach ponownie porównaj rozmiary, gdy Home Assistant działa normalnie. Plik, którego rozmiar się zmienia, jest bardziej przydatną wskazówką niż nieruchoma lista starych, dużych plików.

Przypadki związane z Home Assistant pokazują, że przyczyną zapełnienia dysku mogą być różne warstwy, w tym logi systemowe, a nie baza danych Recorder. W jednym rozwiązanym wątku ustalono, że przyczyną wzrostu był dziennik systemd, więc najpierw trzeba sprawdzić, który katalog stale rośnie, zamiast zakładać, że winne jest wzmożone działanie Home Assistant.

Jeśli rośnie rozmiar pojedynczego logu Core, sprawdź powtarzający się komponent i komunikat. Jeśli rosną logi JSON Dockera, sprawdź sterownik logów kontenera. Jeśli rośnie dziennik, sprawdź usługę emitującą wpisy. Jeśli wolnego miejsca jest już krytycznie mało, zatrzymaj najbardziej hałaśliwy, nieistotny kontener albo samo Home Assistant, zanim kolejne zapisy utrudnią odzyskiwanie systemu.

Napraw powtarzające się błędy, zanim ograniczysz widoczność

Policz dominujący komunikat i dopasuj jego znaczniki czasu do urządzenia, integracji, automatyzacji, dodatku lub zdarzenia sieciowego. Ostrzeżenie powtarzane tysiące razy zwykle ma większą wartość zapobiegawczą niż dziesiątki niezwiązanych, jednorazowych wpisów. Zapisz krótki fragment wraz z wersją i zdarzeniem wyzwalającym, zanim zmienisz ustawienia.

Problem z Home Assistant Core opisany w dokumentacji dotyczył błędu Tradfri, który doprowadził do wzrostu logu powyżej 10 GB i zapełnienia dysku systemowego. To przykład zalewania logu przez jedną integrację związany z konkretną wersją; przemawia za ustaleniem źródła wpisów, a nie zakładaniem, że przyczyną zawsze jest Tradfri lub rotacja logów.

Po zakończeniu rejestrowania wyłącz debugowanie, a następnie przeładuj lub wyłącz tylko potwierdzoną, nadmiernie logującą integrację i powtórz pierwotny wyzwalacz. Jeśli częstotliwość komunikatów gwałtownie spadnie, napraw tę integrację lub jej zależność. Jeśli się nie zmieni, przywróć poprzednie ustawienie i przejdź do następnego potwierdzonego źródła, zamiast wyciszać wszystkie ostrzeżenia.

Ustaw retencję na poziomie, który odpowiada za dany log

Ustaw osobne limity dla dziennika systemu, sterownika logów Dockera, odwrotnego serwera proxy i pozostałych dodatków. Poziom logowania Core nie ogranicza miejsca zajmowanego przez dziennik systemd, a opcja określająca rozmiar w Dockerze nie rotuje pliku zapisywanego bezpośrednio w zamontowanym katalogu konfiguracji.

Dobierz limity tak, by zachować wystarczającą ilość historii między kolejnymi kontrolami, a zarazem zostawić miejsce na kopie zapasowe, aktualizacje, operacje na bazie danych i odzyskiwanie systemu. Powiązany artykuł ZimaSpace o wolnym miejscu na dysku w Home Assistant wyjaśnia, dlaczego wykorzystanie ostatniego zapasu miejsca może uniemożliwić wykonanie operacji wymagających tymczasowo dodatkowej przestrzeni.

Zapisz każdą zasadę w konfiguracji, która przetrwa ponowne utworzenie usługi. Uruchom ponownie lub utwórz ponownie tylko tę usługę, której dotyczy problem, potwierdź, że ustawienie jest aktywne, i przygotuj poprzednią wartość na wypadek cofnięcia zmiany. Nie zastępuj szukania nietypowego źródła zapisu zaplanowanym, powszechnym usuwaniem plików.

Sprawdź, czy wzrost pozostaje ograniczony przy pierwotnym wyzwalaczu

Odtwórz zdarzenie, które spowodowało lawinowy przyrost logów, na przykład przejście urządzenia w tryb offline, ponawianie prób przez integrację, tworzenie kopii zapasowej lub awarię sieci. Przez czas dłuższy niż poprzedni okres wzrostu monitoruj ten sam rozmiar pliku, częstotliwość komunikatów, ilość wolnego miejsca, stan usług i reakcje automatyzacji.

Wynik jest prawidłowy, jeśli rozmiar logów pozostaje stabilny lub logi są rotowane, nie dochodzi do utraty niezbędnych danych diagnostycznych, historia jest zapisywana normalnie, a wolnego miejsca wystarcza na następną kopię zapasową i aktualizację. Uruchom hosta ponownie jeden raz i powtórz wyzwalacz, aby potwierdzić, że limity działają po ponownym utworzeniu usługi.

Cofnij zmianę retencji, jeśli usuwa ona dowody potrzebne do zdiagnozowania utrzymującej się usterki. Jeśli log nadal się powiększa po potwierdzeniu i odizolowaniu źródła, zgłoś problem, podając powtarzający się komunikat, emitujący go komponent, wersję, tempo wzrostu i ścieżkę do pliku. Ponownie wstrzymaj zapis, jeśli dysk jest bliski zapełnienia.

Wsparcie i porady

Więcej do przeczytania

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.