Home Assistant Remote Logger¶

Luistert naar Home Assistant-systeemloggebeurtenissen en stuurt gestructureerde loggebeurtenissen naar een externe Syslog- of OpenTelemetry (OTLP)-collector. Optioneel worden andere Home Assistant-gebeurtenissen doorgestuurd, zoals levenscyclusgebeurtenissen, serviceaanroepen, configuratie-updates en statuswijzigingen.

De logstructuur wordt bewaard vanuit de interne Home Assistant-gebeurtenis, zodat meerdere logregels en stack traces als één logitem worden bewaard — in tegenstelling tot consolescrapers die per regel een gebeurtenis aanmaken. Scriptnamen, regelnummers en versies worden correct vastgelegd.

Alleen de Home Assistant-server zelf met zijn aangepaste componenten wordt ondersteund. Logboeken van apps (voorheen bekend als 'add-ins'), HAOS of de HA Supervisor worden niet als vastlegbare gebeurtenissen aangeboden en vereisen een alternatieve oplossing. Bert Barons LogSpout Home Assistant App dekt deze gevallen af. Deze kan samen met Remote Logger worden gebruikt zodat Home Assistant goede gestructureerde logboeken heeft en al het overige tenminste wordt vastgelegd.

Installatie¶

Remote Logger is een HACS-component, die daarom eerst moet worden geïnstalleerd via de instructies op Getting Started with HACS.

De integratie wordt geïnstalleerd via de Home Assistant-integratiepagina en heeft geen YAML-configuratie.

Er is echter een YAML-wijziging vereist in de Home Assistant System Log-integratie om het doorsturen van system_log_event in te schakelen.

yaml title="Home Assistant-configuratie" system_log: fire_event: true

Open Telemetry (OTEL)¶

Logboeken worden verzonden via de Open Telemetry Logs-specificatie over een Open Telemetry Protocol (OTLP)-verbinding, als Protobuf of JSON, momenteel alleen via HTTP (gRPC kan in de toekomst worden toegevoegd).

Zie voor meer informatie OpenTelemetry Logging.

Logrecords worden verzameld en gebundeld verzonden.

Syslog¶

Berichten worden verzonden in het nieuwere RFC5424-formaat met aanvullende gestructureerde gegevens op basis van OTEL-taxonomie (zie Aanvullende attributen).

Syslog kan worden verzonden via TCP of UDP.

Gebeurtenissen¶

Systeemloggebeurtenis¶

Let op de vereiste in Installatie om deze gebeurtenis in te schakelen, die standaard niet wordt geactiveerd.

Remote Logger sluit eigen loggebeurtenissen uit van de stream om de mogelijkheid van gebeurtenislussen te voorkomen. Als alternatief zijn foutstatistieken en berichten beschikbaar als diagnostische entiteiten.

Aanvullende attributen¶

De volgende aanvullende attributen, rechtstreeks afgeleid van de Home Assistant-loggebeurtenis, worden aangeboden als Syslog STRUCTURED-DATA-attributen of OTEL-attributen.

• code.file.path
• code.line.number
• code.function.name (dit is de logger-waarde van Home Assistant)
• exception.count
• exception.first_occurred
• exception.stacktrace

OTEL-taxonomie wordt gebruikt voor zowel OTEL als Syslog, omdat er op dit niveau van Syslog geen standaardtaxonomie bestaat.

Andere gebeurtenissen¶

Remote Logger kan elke Home Assistant-gebeurtenis vastleggen en kent de kernevenementen om beter leesbare berichten te maken.

Voor het gemak kunnen vier vooraf gedefinieerde gebeurtenisbundels worden ingeschakeld.

Het vrije-tekstveld voor gebeurtenissen kan als alternatief worden gebruikt om specifieke Home Assistant-gebeurtenissen of andere aangepaste componentgebeurtenissen te selecteren.

Logservers¶

Er zijn talloze oplossingen voor het vastleggen, analyseren, aggregeren en opslaan van logboeken.

Een goede combinatie is Vector en GreptimeDb — snel, lichtgewicht, open source, aanpasbaar en draaiend onder Docker. Vector heeft ondersteuning voor OTEL-logboekregistratie en Syslog, met goede herbestemmingsmogelijkheden om elke bron af te stemmen. Vervolgens is het eenvoudig om logboeken van Docker-servers, firewalls, Unifi-switches of andere bronnen samen te brengen in één tijdlijn, aangevuld met server- en netwerkstatistieken.

Diagnostische entiteiten¶

Home Assistant-sensoren worden aangemaakt en bijgewerkt om logactiviteit te bewaken, plus eventuele fouten bij het genereren van logberichten of het plaatsen ervan op externe servers.

Rhizomatics Open Source voor Home Assistant¶

HACS¶

• AutoArm - Automatisch beveiligen en beveiligen opheffen van Home Assistant-alarmbedieningspanelen via fysieke knoppen, aanwezigheid, agenda's, zon en meer
• Supernotify - Uniforme notificaties voor eenvoudige multi-channel berichten, inclusief krachtige integratie van deurbellen en beveiligingscamera's.

Python / Docker¶

• Anpr2MQTT - Integreer ANPR/ALPR-kentekenplaatcamera's via het bestandssysteem (NAS/FTP) naar MQTT met optionele beeldanalyse en UK DVLA-integratie.
• Updates2MQTT - Automatisch melden via MQTT bij Docker-image-updates, met geavanceerde verwerking om versies en releasenotes uit images te halen, en de mogelijkheid om containers op afstand te pullen en opnieuw te starten vanuit Home Assistant. Ook beschikbaar op PyPI