Remote Logger for OpenTelemetry and Syslog für Home Assistant (Marketplace-Integration)

Installationen: 62 teilen Analysedaten
GitHub-Sterne: 13
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v2.0.7, 26. Oktober 2026
Kategorie: Computer und Netzwerk, Überwachung
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: remote_logger
Quelle: github.com/rhizomatics/remote_logger
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von rhizomatics/remote_logger.

Überblick

Remote Logger for OpenTelemetry and Syslog sendet Home Assistant Logs an einen entfernten Syslog- oder OTLP-Collector. Die Integration hört auf den Python-Root-Logger oder das System-Log-Ereignis, sodass mehrzeilige Logs und Stacktraces als einzelne Einträge erhalten bleiben. Die OTLP-Ausgabe läuft über HTTP als JSON oder Protobuf, wahlweise mit TLS, Token-Authentifizierung, zusätzlichen Headern und eigenen Ressourcenattributen, während Syslog RFC-5424-Nachrichten über UDP oder TCP verwendet. Auch andere Home Assistant Ereignisse können weitergeleitet werden, darunter Lebenszyklus-Ereignisse, Änderungen am Kern, Dienstaufrufe, Automationsläufe und Zustandsänderungen sowie beliebige eigene Ereignisnamen. Sensoren melden Formatierungsfehler, Sendefehler, Log-Ereignisse und gesendete Einträge, und die Integration lässt ihre eigenen Log-Einträge aus, um Schleifen zu vermeiden. Sie läuft lokal und wird nach der Installation über den Marketplace oder HACS in der Oberfläche eingerichtet.

Zusammenfassung der README und des Codes von rhizomatics/remote_logger, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

OTLP-Endpunkt konfigurieren

Collector-HostHostname oder IP-Adresse des OTLP-Collectors.
Collector-PortHTTP-Port des OTLP-Collectors (Standard: 4318).
TLS verwenden (HTTPS)HTTPS für die Verbindung zum Collector aktivieren.
Nutzlast-KodierungKodierungsformat der OTLP-Nutzlast: json oder protobuf.
Maximale Batch-GrößeMaximale Anzahl von Protokolleinträgen im Puffer vor dem Senden (1–10000, Standard: 100).
Benutzerdefinierte RessourcenattributeOptionale kommagetrennte Schlüssel=Wert-Paare, die jedem Protokolleintrag hinzugefügt werden (z. B. deployment.environment=production,service.namespace=home).
Token-TypAuthentifizierungsschema: Bearer sendet das Token unverändert; Basic kodiert es als 'Benutzername:Passwort' in Base64.
Zugriffstoken für den Authorization-HeaderOptionales Token. Wird im Authorization-Header gesendet.
Zusätzliche HeaderOptionale zusätzliche HTTP-Header im Format 'Name: Wert' (z. B. stream-name: mein-stream). Einen Header pro Eintrag eingeben.
Endpunkt-Pfad für ProtokollePfad, der an Host:Port für den Protokoll-Endpunkt angehängt wird (Standard: /v1/logs).

Syslog-Endpunkt konfigurieren

Syslog-Server-HostHostname oder IP-Adresse des Syslog-Servers.
Syslog-Server-PortPort des Syslog-Servers (Standard: 514).
TransportprotokollTransportprotokoll: UDP (ohne Bestätigung) oder TCP (zuverlässige Zustellung).
TLS verwenden (nur TCP)TLS-Verschlüsselung für TCP-Verbindungen aktivieren. Wird bei UDP ignoriert.
AnwendungsnameDas APP-NAME-Feld in RFC 5424-Nachrichten (Standard: homeassistant).
Syslog-FacilitySyslog-Facility-Code zur Berechnung des PRI-Werts (Standard: user).

Zusätzliche HA-Ereignisse

system_log_event statt Python-Root-Logger verwendenWenn deaktiviert (Standard), werden Protokolle über den Python-Root-Logger erfasst – alle Log-Level sind verfügbar und der Mindest-Level ist konfigurierbar. Wenn aktiviert, werden Protokolle über den Home Assistant system_log_event-Bus-Event erfasst, der nur WARNING- und ERROR-Einträge liefert.
Mindest-Log-Level (nur Root-Logger-Modus)Mindest-Schweregrad, der an den Remote-Endpunkt weitergeleitet wird. Gilt nur, wenn der Root-Logger-Modus aktiv ist (system_log_event deaktiviert). Standard: INFO.
Ereignisdaten in den Log-Körper serialisierenWenn aktiviert, werden die vollständigen Ereignisdaten als JSON in den Log-Körper geschrieben. Als strukturierte Attribute werden nur entity_id, domain und service beibehalten.
system_log_event als Ereignisname unterdrückenWenn aktiviert, werden system_log_event-Einträge ohne eventName-Feld exportiert. Deaktivieren, wenn remote_logger als allgemeiner Ereignisrekorder genutzt wird, damit alle Ereignistypen unterschieden werden können.
Ein oder mehrere EreignisseOptionale Liste zusätzlicher HA-Ereignisnamen (z. B. zha_event). Einen Ereignisnamen pro Eintrag eingeben.
HA-LebenszyklusereignisseAbonniert homeassistant_start, homeassistant_started und homeassistant_stop.
HA-KernänderungsereignisseAbonniert component_loaded, core_config_updated, service_registered, service_removed, lovelace_updated, panels_updated, themes_updated, labs_updated, user_added, user_updated und user_removed.
HA-KernaktivitätHA-Kernaktivität, einschließlich Dienstaufrufe, Automatisierungs- und Skriptausführung.
HA-Zustandsänderungen, ohne Attribute oder KontextHome Assistant-Zustandsänderungen (ohne Attribute oder Kontext) und Logbucheinträge.
HA-ZustandsänderungenHome Assistant-Zustandsänderungen (vollständiges Ereignis) und Logbucheinträge.

OTLP-Endpunkt erneut authentifizieren

Token-TypAuthentifizierungsschema: Bearer sendet das Token unverändert; Basic kodiert es als 'Benutzername:Passwort' in Base64. Raw Basic sendet wie konfiguriert. ApiKey sendet mit dem Präfix 'ApiKey'.
TokenNeues Token zur Authentifizierung beim OTLP-Collector.

Nach der Einrichtung

Collector-HostHostname oder IP-Adresse des OTLP-Collectors.
Collector-PortHTTP-Port des OTLP-Collectors (Standard: 4318).
TLS verwenden (HTTPS)HTTPS für die Verbindung zum Collector aktivieren.
Nutzlast-KodierungKodierungsformat der OTLP-Nutzlast: json oder protobuf.
Maximale Batch-GrößeMaximale Anzahl von Protokolleinträgen im Puffer vor dem Senden (1–10000, Standard: 100).
Benutzerdefinierte RessourcenattributeOptionale kommagetrennte Schlüssel=Wert-Paare, die jedem Protokolleintrag hinzugefügt werden (z. B. deployment.environment=production,service.namespace=home).
Token-TypAuthentifizierungsschema: Bearer sendet das Token unverändert; Basic kodiert es als 'Benutzername:Passwort' in Base64.
Zugriffstoken für den Authorization-HeaderOptionales Token. Wird im Authorization-Header gesendet.
Zusätzliche HeaderOptionale zusätzliche HTTP-Header im Format 'Name: Wert' (z. B. stream-name: mein-stream). Einen Header pro Eintrag eingeben.
Endpunkt-Pfad für ProtokollePfad, der an Host:Port für den Protokoll-Endpunkt angehängt wird (Standard: /v1/logs).
Syslog-Server-HostHostname oder IP-Adresse des Syslog-Servers.
Syslog-Server-PortPort des Syslog-Servers (Standard: 514).
TransportprotokollTransportprotokoll: UDP (ohne Bestätigung) oder TCP (zuverlässige Zustellung).
TLS verwenden (nur TCP)TLS-Verschlüsselung für TCP-Verbindungen aktivieren. Wird bei UDP ignoriert.
AnwendungsnameDas APP-NAME-Feld in RFC 5424-Nachrichten (Standard: homeassistant).
Syslog-FacilitySyslog-Facility-Code zur Berechnung des PRI-Werts (Standard: user).
system_log_event statt Python-Root-Logger verwendenWenn deaktiviert (Standard), werden Protokolle über den Python-Root-Logger erfasst – alle Log-Level sind verfügbar und der Mindest-Level ist konfigurierbar. Wenn aktiviert, werden Protokolle über den Home Assistant system_log_event-Bus-Event erfasst, der nur WARNING- und ERROR-Einträge liefert.
Mindest-Log-Level (nur Root-Logger-Modus)Mindest-Schweregrad, der an den Remote-Endpunkt weitergeleitet wird. Gilt nur, wenn der Root-Logger-Modus aktiv ist (system_log_event deaktiviert). Standard: INFO.
Benutzerdefinierte EreignisnamenOptionale Liste zusätzlicher HA-Ereignisnamen (z. B. zha_event). Einen Ereignisnamen pro Eintrag eingeben.
Ereignisdaten in den Log-Körper serialisierenWenn aktiviert, werden die vollständigen Ereignisdaten als JSON in den Log-Körper geschrieben. Als strukturierte Attribute werden nur entity_id, domain und service beibehalten.
system_log_event als Ereignisname unterdrückenWenn aktiviert, werden system_log_event-Einträge ohne eventName-Feld exportiert. Deaktivieren, wenn remote_logger als allgemeiner Ereignisrekorder genutzt wird, damit alle Ereignistypen unterschieden werden können.
HA-LebenszyklusereignisseAbonniert homeassistant_start, homeassistant_started und homeassistant_stop.
HA-KernänderungsereignisseAbonniert component_loaded, core_config_updated, service_registered, service_removed, lovelace_updated, panels_updated, themes_updated, labs_updated, user_added, user_updated und user_removed.
HA-KernaktivitätHA-Kernaktivität, einschließlich Dienstaufrufe, Automatisierungs- und Skriptausführung.
HA-Zustandsänderungen, ohne Attribute oder KontextHome Assistant-Zustandsänderungen (ohne Attribute oder Kontext) und Logbucheinträge.
HA-ZustandsänderungenHome Assistant-Zustandsänderungen (vollständiges Ereignis) und Logbucheinträge.

Texte aus dem Code von rhizomatics/remote_logger.

Entitäten

SensorenFormatierungsfehler, Sendefehler, Protokollereignisse, Sendungen

Aus der README

Use log aggregation and analysis tools to get a complete picture of your home automation. Remote Logger for Home Assistant listens to Home Assistant logging at source and sends structured log events to a remote Syslog or OpenTelemetry (OTLP) collector. Optionally forwards other Home Assistant events, such as lifecycle events, service calls, configuration updates, state changes.

Aus der README von rhizomatics/remote_logger, Apache License 2.0. Gekürzt.