Nasłuchuje zdarzeń dziennika systemowego Home Assistant i wysyła ustrukturyzowane zdarzenia dziennika do zdalnego kolektora Syslog lub OpenTelemetry (OTLP). Opcjonalnie przekazuje inne zdarzenia Home Assistant, takie jak zdarzenia cyklu życia, wywołania usług, aktualizacje konfiguracji i zmiany stanu.
Struktura dzienników jest zachowywana z wewnętrznego zdarzenia Home Assistant, dzięki czemu wieloliniowe dzienniki i ślady stosu są przechowywane jako pojedyncze wpisy — w przeciwieństwie do scraperów konsoli, które tworzą jedno zdarzenie na wiersz. Nazwy skryptów, numery linii i wersje są prawidłowo przechwytywane.
Obsługiwany jest wyłącznie serwer Home Assistant wraz z jego niestandardowymi komponentami. Dzienniki z aplikacji (dawniej „dodatków"), HAOS ani supervisora HA nie są dostępne jako przechwytywalne zdarzenia i wymagają alternatywnego rozwiązania. LogSpout Home Assistant App Berta Barona pokrywa te przypadki. Może być używana w połączeniu z Remote Logger, aby Home Assistant miał dobre ustrukturyzowane dzienniki, a wszystko inne było przynajmniej rejestrowane.
Remote Logger jest komponentem HACS, który należy najpierw zainstalować zgodnie z instrukcją Getting Started with HACS.
Integracja instaluje się ze strony integracji Home Assistant i nie wymaga konfiguracji YAML.
Wymagana jest jednak zmiana YAML w integracji System Log Home Assistant, aby włączyć przekazywanie zdarzeń system_log_event.
system_log:
fire_event: trueDzienniki są wysyłane zgodnie ze specyfikacją Open Telemetry Logs przez połączenie Open Telemetry Protocol (OTLP), jako Protobuf lub JSON, obecnie wyłącznie przez HTTP (gRPC może zostać dodane w przyszłości).
Więcej informacji znajdziesz w OpenTelemetry Logging.
Rekordy dzienników są zbierane i wysyłane partiami.
Wiadomości są wysyłane w nowszym formacie RFC5424 z dodatkowymi danymi strukturalnymi według taksonomii OTEL (zob. Dodatkowe atrybuty).
Syslog może być wysyłany przez TCP lub UDP.
Zwróć uwagę na wymóg w sekcji Instalacja dotyczący włączenia tego zdarzenia, które domyślnie nie jest wyzwalane.
Remote Logger wyklucza własne zdarzenia dziennika ze strumienia, aby zapobiec możliwości pętli zdarzeń. Alternatywnie statystyki i komunikaty błędów są dostępne jako encje diagnostyczne.
Następujące dodatkowe atrybuty, wywodzone bezpośrednio ze zdarzenia dziennika
Home Assistant, są udostępniane jako atrybuty STRUCTURED-DATA Sysloga lub atrybuty OTEL.
code.file.pathcode.line.numbercode.function.name(jest to wartośćloggerz Home Assistant)exception.countexception.first_occurredexception.stacktrace
Taksonomia OTEL jest używana zarówno dla OTEL, jak i Sysloga, ponieważ na tym poziomie Sysloga nie istnieje standardowa taksonomia.
Remote Logger może rejestrować dowolne zdarzenia Home Assistant i zna główne z nich, aby tworzyć bardziej czytelne komunikaty.
Dla wygody można włączyć cztery predefiniowane zestawy zdarzeń.
| Zestaw | Opis |
|---|---|
| Cykl życia | Zdarzenia uruchamiania i zatrzymywania serwera Home Assistant |
| Zmiany rdzenia | Ładowanie lub wyładowywanie komponentów i usług, ponowne zastosowanie konfiguracji |
| Aktywność rdzenia | Akcje, akcje mobilne, skrypty, wykonane automatyzacje |
| Zmiany stanu | Zmiany stanu encji i wpisy dziennika, bez atrybutów i kontekstu, aby unikać zbyt dużych wpisów |
| Pełne zmiany stanu | Zmiany stanu encji i wpisy dziennika, pełne i nieprzycinane |
Pole zdarzeń w formacie swobodnym może być używane jako alternatywa do wybierania konkretnych zdarzeń Home Assistant lub dowolnych innych zdarzeń niestandardowych komponentów.
Istnieje niezliczona liczba rozwiązań do przechwytywania, analizowania, agregowania i przechowywania dzienników.
Dobrze działającą kombinacją jest Vector i GreptimeDb — szybkie, lekkie, open source, konfigurowalne i działające pod Dockerem. Vector obsługuje logowanie OTEL oraz Syslog i ma dobre możliwości przemapowania do dostrajania każdego źródła. Następnie łatwo jest zbierać dzienniki z serwerów Docker, zapór sieciowych, przełączników Unifi i innych źródeł w jednej osi czasu, wraz z metrykami serwera i sieci.
Sensory Home Assistant są tworzone i aktualizowane w celu monitorowania aktywności dzienników oraz wszelkich błędów podczas generowania komunikatów dziennika lub wysyłania ich do zdalnych serwerów.
- AutoArm - Automatyczne uzbrajanie i rozbrajanie paneli alarmowych Home Assistant za pomocą fizycznych przycisków, obecności, kalendarzy, słońca i nie tylko
- Supernotify - Ujednolicone powiadomienia dla łatwej wielokanałowej komunikacji, z potężną integracją dzwonków i kamer bezpieczeństwa.
- Anpr2MQTT - Integracja kamer ANPR/ALPR do rozpoznawania tablic rejestracyjnych przez system plików (NAS/FTP) do MQTT z opcjonalną analizą obrazu i integracją z brytyjskim DVLA.
- Updates2MQTT - Automatyczne powiadamianie przez MQTT o aktualizacjach obrazów Docker, z zaawansowaną obsługą wyodrębniania wersji i informacji o wydaniu z obrazów oraz opcją zdalnego pobierania i restartowania kontenerów z Home Assistant. Dostępny również na PyPI