Jak skonfigurować kontrole stanu Home Assistant i jego zależności

Eva Wong

IceWhale author

Eva Wong jest Technicznym pisarzem i stałym majsterkowiczem w ZimaSpace. Całe życie geek z pasją do homelabów i oprogramowania open-source, specjalizuje się w tłumaczeniu skomplikowanych koncepcji technicznych na przystępne, praktyczne przewodniki. Eva wierzy, że samodzielne hostowanie powinno być zabawą, a nie czymś onieśmielającym. Poprzez swoje samouczki umożliwia społeczności rozwiewanie tajemnic konfiguracji sprzętu, od budowy pierwszego NAS po opanowanie kontenerów Docker.

How to Configure Health Checks for Home Assistant and Its Dependencies

Konfiguruj testy kondycji warstwowo: najpierw zweryfikuj odpowiedź aplikacji Home Assistant, a następnie testuj bazę danych, MQTT, DNS, pamięć masową i ścieżkę zdalną tylko tam, gdzie dana zależność ma rzeczywiste znaczenie.

Kontener oznaczony jako uruchomiony może wciąż się uruchamiać, być zablokowany przez pamięć masową, odłączony od brokera lub niezdolny do zapisywania historii. Zacznij od niedrogiego lokalnego testu gotowości, dodaj osobne testy zależności z jasnymi nazwami, zapewnij wystarczający czas na uruchomienie i włącz alerty przed aktywowaniem automatyzacji naprawczych. Każda sonda powinna określać, co zawiodło i co potwierdza pomyślny wynik.

Zdefiniuj prawidłowe działanie przed napisaniem sondy

Wymień funkcje, które muszą działać w Twoim domu: lokalny interfejs odpowiada, automatyzacje są wykonywane, Recorder może zapisywać dane, urządzenia MQTT wymieniają stany, DNS rozwiązuje wymagane nazwy, a zamontowana pamięć masowa pozwala na zapis. Jeden zielony status nie może potwierdzić wszystkich tych funkcji.

Praktyczny przewodnik po testach kondycji Dockera odróżnia kondycję aplikacji od samego istnienia procesu i wyjaśnia, że sonda działa wewnątrz kontenera oraz zgłasza powodzenie lub niepowodzenie. Wykorzystaj to rozróżnienie na poziomie aplikacji, definiując, co powinien obserwować test Home Assistant.

Przypisz jednego właściciela i jedno znaczenie awarii do każdej sondy. Test Core nie powinien udawać, że sprawdza bazę danych, a test gniazda MQTT nie powinien twierdzić, że wiadomości urządzeń są aktualne. Jeśli wynik nie może prowadzić do konkretnego następnego działania, uprość tę sondę albo ją usuń.

Dodaj lekki test gotowości Home Assistant

Użyj lokalnego punktu końcowego lub polecenia, które kończy się szybko i potwierdza, że aplikacja odpowiada, a nie tylko że istnieje proces Pythona. Ustaw limit czasu krótszy niż interwał, rozsądną liczbę ponowień oraz okres karencji wystarczająco długi dla zmierzonego czasu zimnego uruchomienia.

Testy kondycji Compose zwykle udostępniają ustawienia interwału, limitu czasu, liczby ponowień i okresu początkowego, a warunki zależności mogą opóźnić uruchomienie konsumenta do momentu, gdy wymagany element osiągnie stan zdrowy. Najważniejszym zachowaniem operacyjnym jest gotowość zamiast stanu uruchomienia, a nie agresywny harmonogram odpytywania.

Uruchom Home Assistant z zimnej pamięci masowej i zapisz moment, w którym sonda po raz pierwszy zakończy się powodzeniem. Jeśli zawodzi podczas każdego normalnego uruchomienia, wydłuż okres karencji zamiast osłabiać test. Jeśli kończy się powodzeniem, zanim interfejs lub wymagana usługa będą użyteczne, test jest zbyt płytki i wymaga bardziej reprezentatywnej odpowiedzi.

Sprawdzaj zależności osobno i zachowuj znaczenie awarii

Utwórz niezależne testy połączenia z bazą danych, brokera MQTT, rozwiązywania nazw DNS oraz wymaganego punktu montowania pamięci masowej. Preferuj zapytanie tylko do odczytu lub niewielki, odwracalny zapis do przeznaczonej do tego ścieżki testowej; nigdy nie modyfikuj tabel Home Assistant ani nie publikuj poleceń do rzeczywistych urządzeń wyłącznie po to, by potwierdzić dostępność.

Utrzymuj rozdzielenie między zależnościami wykrywania urządzeń i sterowania lokalnego a zależnościami dostępu zdalnego. Przegląd zależności komponentów Home Assistant w ZimaSpace, zależności komponentów Home Assistant, stanowi przydatną mapę pomagającą zdecydować, która awaria powinna natychmiast wywołać alarm, a która może pozostać ostrzeżeniem o obniżonej funkcjonalności.

Oznacz wynik nazwą warstwy, która zawiodła. Jeśli Home Assistant działa prawidłowo, ale test bazy danych kończy się niepowodzeniem, sprawdź pamięć masową lub dane uwierzytelniające zamiast restartować Core. Jeśli zawodzi tylko dostęp zdalny, utrzymaj działanie sterowania lokalnego. Taki podział zapobiega temu, by jedna czerwona zależność zacierała dowody prawidłowego działania pozostałych usług.

Featured

ZimaCube 2 Osobisty domowy NAS w chmurze

ZimaCube2

Testuj awarie, odzyskiwanie i czas wysyłania alertów

W oknie serwisowym zatrzymuj po jednej niekrytycznej zależności naraz albo tymczasowo blokuj jej ścieżkę testową. Potwierdź, że odpowiednia sonda kończy się niepowodzeniem, niezwiązane z nią testy pozostają zielone, a alert wskazuje właściwą warstwę. Przywróć zależność i sprawdź, czy ten sam test zostanie wyczyszczony bez ręcznej edycji stanu.

Dodaj automatyczne restarty dopiero po zaobserwowaniu kilku rzeczywistych awarii. Stosuj okresy schładzania i maksymalną liczbę prób, a także nigdy nie restartuj jednocześnie bazy danych i Home Assistant bez zachowania logów. Restart jest bramką weryfikacyjną, a nie dowodem odzyskania podstawowej zależności.

Dobrze zaprojektowany system wykrywa kontrolowaną awarię w oczekiwanym czasie, zachowuje lokalne funkcje, które od niej nie zależą, i usuwa alert po przywróceniu działania. Wycofaj sondy powodujące znaczne obciążenie lub fałszywe alarmy; eskaluj problem, jeśli usługa pozostaje niegotowa mimo pomyślnego wyniku wszystkich testów zależności, ponieważ test na poziomie aplikacji wymaga wtedy głębszych dowodów.