Home Assistant Remote Logger¶

Escucha los eventos del registro del sistema de Home Assistant y envía eventos de registro estructurados a un colector remoto Syslog u OpenTelemetry (OTLP). Opcionalmente reenvía otros eventos de Home Assistant, como eventos del ciclo de vida, llamadas a servicios, actualizaciones de configuración y cambios de estado.

La estructura de los registros se preserva del evento interno de Home Assistant, por lo que los registros multilínea y las trazas de pila se conservan como entradas únicas, a diferencia de los scrapers de consola que crean un evento por línea, y captura correctamente nombres de scripts, números de línea y versiones.

Solo se admite el servidor de Home Assistant con sus componentes personalizados. Los registros de las apps (anteriormente llamadas «add-ins»), de HAOS o del supervisor de HA no se proporcionan como eventos capturables, por lo que requieren una solución alternativa. La LogSpout Home Assistant App de Bert Baron cubre estos casos. Puede usarse en combinación con Remote Logger para que Home Assistant tenga buenos registros estructurados y todo lo demás quede al menos registrado.

Instalación¶

Remote Logger es un componente HACS, por lo que primero hay que instalarlo siguiendo las instrucciones de Getting Started with HACS.

La integración se instala desde la página de integraciones de Home Assistant y no requiere configuración YAML.

Sin embargo, sí es necesario un cambio en el YAML de la integración System Log de Home Assistant para habilitar el reenvío de eventos system_log_event.

yaml title="Configuración de Home Assistant" system_log: fire_event: true

Open Telemetry (OTEL)¶

Los registros se envían usando la especificación Open Telemetry Logs a través de una conexión Open Telemetry Protocol (OTLP), como Protobuf o JSON, actualmente solo por HTTP (gRPC podría añadirse en el futuro).

Para más información, consulta OpenTelemetry Logging.

Los registros se recopilan y se envían en lotes.

Syslog¶

Los mensajes se envían usando el formato más reciente RFC5424, con datos estructurados adicionales que utilizan la taxonomía OTEL (ver Atributos adicionales).

Syslog puede enviarse por TCP o UDP.

Eventos¶

Evento System Log¶

Ten en cuenta el requisito en Instalación para habilitar este evento, que no se activa por defecto.

Remote Logger excluirá sus propios eventos de registro del flujo, para evitar la posibilidad de bucles de eventos. Como alternativa, las estadísticas y mensajes de error están disponibles como entidades de diagnóstico.

Atributos adicionales¶

Los siguientes atributos adicionales, derivados directamente del evento de registro de Home Assistant, se proporcionan como atributos STRUCTURED-DATA de Syslog o atributos OTEL.

• code.file.path
• code.line.number
• code.function.name (este es el valor logger de Home Assistant)
• exception.count
• exception.first_occurred
• exception.stacktrace

La taxonomía OTEL se usa tanto para OTEL como para Syslog ya que no existe una taxonomía estándar a este nivel de Syslog.

Otros eventos¶

Remote Logger puede registrar cualquier evento de Home Assistant y conoce los principales para crear mensajes más legibles.

Por comodidad, se pueden activar cuatro conjuntos de eventos predefinidos.

El campo de eventos en formato libre puede usarse como alternativa para seleccionar eventos específicos de Home Assistant o cualquier otro evento de componentes personalizados.

Servidores de registros¶

Existen infinidad de soluciones para capturar, analizar, agregar y almacenar registros.

Una combinación que funciona bien es Vector y GreptimeDb — rápidos, ligeros, de código abierto, personalizables y que funcionan con Docker. Vector admite el registro OTEL y Syslog, con buenas capacidades de remapping para ajustar cada fuente. Luego es fácil integrar registros de servidores Docker, cortafuegos, switches Unifi u otras fuentes en una única línea de tiempo, junto con métricas de servidor y red.

Entidades de diagnóstico¶

Se crean y actualizan sensores de Home Assistant para monitorizar la actividad de los registros, así como cualquier error al generar mensajes de registro o al enviarlos a servidores remotos.

Rhizomatics Open Source para Home Assistant¶

HACS¶

• AutoArm - Arma y desarma automáticamente los paneles de control de alarma de Home Assistant usando botones físicos, presencia, calendarios, el sol y más
• Supernotify - Notificación unificada para mensajería multicanal sencilla, con potente integración de timbres y cámaras de seguridad.

Python / Docker¶

• Anpr2MQTT - Integra cámaras ANPR/ALPR de reconocimiento de matrículas a través del sistema de archivos (NAS/FTP) hacia MQTT con análisis opcional de imágenes e integración con la DVLA del Reino Unido.
• Updates2MQTT - Notifica automáticamente por MQTT las actualizaciones de imágenes Docker, con gestión avanzada para extraer versiones y notas de versión de las imágenes, y la opción de activar remotamente la descarga y el reinicio de contenedores desde Home Assistant. También disponible en PyPI