Home Assistant Remote Logger¶

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.

Instalacja¶

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.

yaml title="Konfiguracja Home Assistant" system_log: fire_event: true

Open Telemetry (OTEL)¶

Dzienniki 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.

Syslog¶

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.

Zdarzenia¶

Zdarzenie dziennika systemowego¶

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.

Dodatkowe atrybuty¶

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.path
• code.line.number
• code.function.name (jest to wartość logger z Home Assistant)
• exception.count
• exception.first_occurred
• exception.stacktrace

Taksonomia OTEL jest używana zarówno dla OTEL, jak i Sysloga, ponieważ na tym poziomie Sysloga nie istnieje standardowa taksonomia.

Inne zdarzenia¶

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ń.

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.

Serwery dziennikó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.

Encje diagnostyczne¶

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.

Rhizomatics Open Source dla Home Assistant¶

HACS¶

• 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.

Python / Docker¶

• 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