aiohomematic 2026.1.29__py3-none-any.whl

aiohomematic/tracing.py

@@ -0,0 +1,236 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2021-2026
+"""
+Tracing support with context variable propagation.
+
+This module provides tracing spans that automatically propagate through async
+call chains, enabling performance monitoring and distributed tracing.
+
+Key features:
+- Span: Represents a unit of work with timing and attributes
+- Automatic parent-child span relationships via context variables
+- Context manager for scoped span creation
+
+Example:
+    async with span(name="fetch_devices") as s:
+        s.set_attribute(key="count", value=len(devices))
+        for device in devices:
+            async with span(name="process_device") as child:
+                child.set_attribute(key="address", value=device.address)
+                await process(device)
+
+Public API of this module is defined by __all__.
+
+"""
+
+from __future__ import annotations
+
+from contextvars import ContextVar, Token
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Any
+import uuid
+
+
+@dataclass(slots=True)
+class Span:
+    """
+    Tracing span for performance monitoring.
+
+    Spans can be nested to form a trace tree. Each span tracks:
+    - Timing (start, end, duration)
+    - Attributes (key-value metadata)
+    - Events (timestamped occurrences within the span)
+
+    Attributes:
+        name: Human-readable name for this span.
+        trace_id: Unique identifier for the entire trace (shared by all spans).
+        span_id: Unique identifier for this specific span.
+        parent_span_id: ID of the parent span, or None for root spans.
+        started_at: Timestamp when the span started.
+        ended_at: Timestamp when the span ended, or None if still active.
+        attributes: Key-value metadata for this span.
+        events: List of (timestamp, name, attributes) events within this span.
+
+    """
+
+    name: str
+    trace_id: str
+    span_id: str
+    parent_span_id: str | None
+    started_at: datetime = field(default_factory=datetime.now)
+    ended_at: datetime | None = None
+    attributes: dict[str, Any] = field(default_factory=dict)
+    events: list[tuple[datetime, str, dict[str, Any]]] = field(default_factory=list)
+
+    @property
+    def duration_ms(self) -> float | None:
+        """
+        Return span duration in milliseconds.
+
+        Returns:
+            Duration in milliseconds, or None if span hasn't ended.
+
+        """
+        if self.ended_at is None:
+            return None
+        return (self.ended_at - self.started_at).total_seconds() * 1000
+
+    @property
+    def is_root(self) -> bool:
+        """Return True if this is a root span (no parent)."""
+        return self.parent_span_id is None
+
+    def add_event(self, *, name: str, **attributes: Any) -> None:
+        """
+        Add an event to this span.
+
+        Events are timestamped occurrences within a span, useful for
+        marking significant points during execution.
+
+        Args:
+            name: Name of the event.
+            **attributes: Key-value attributes for the event.
+
+        """
+        self.events.append((datetime.now(), name, attributes))
+
+    def end(self) -> None:
+        """Mark span as ended with current timestamp."""
+        self.ended_at = datetime.now()
+
+    def set_attribute(self, *, key: str, value: Any) -> None:
+        """
+        Set a span attribute.
+
+        Args:
+            key: Attribute key.
+            value: Attribute value.
+
+        """
+        self.attributes[key] = value
+
+
+# Context variable for current span
+_current_span: ContextVar[Span | None] = ContextVar("current_span", default=None)
+
+
+def get_current_span() -> Span | None:
+    """
+    Get the current active span.
+
+    Returns:
+        The current Span, or None if no span is active.
+
+    """
+    return _current_span.get()
+
+
+def get_current_trace_id() -> str | None:
+    """
+    Get the current trace ID.
+
+    Returns:
+        The current trace ID, or None if no span is active.
+
+    """
+    current = _current_span.get()
+    return current.trace_id if current else None
+
+
+class span:  # noqa: N801
+    """
+    Context manager for tracing spans.
+
+    Creates a span that is automatically linked to any parent span in
+    the current context. The span is ended when the context manager exits.
+
+    Example:
+        async with span(name="fetch_devices") as s:
+            s.set_attribute(key="count", value=len(devices))
+            for device in devices:
+                async with span(name="process_device") as child:
+                    child.set_attribute(key="address", value=device.address)
+                    await process(device)
+
+    """
+
+    __slots__ = ("_span", "_token")
+
+    def __init__(self, *, name: str, **attributes: Any) -> None:
+        """
+        Initialize a new span.
+
+        Args:
+            name: Human-readable name for this span.
+            **attributes: Initial attributes for the span.
+
+        """
+        parent = _current_span.get()
+
+        self._span = Span(
+            name=name,
+            trace_id=parent.trace_id if parent else str(uuid.uuid4()),
+            span_id=str(uuid.uuid4())[:8],
+            parent_span_id=parent.span_id if parent else None,
+            attributes=dict(attributes),
+        )
+        self._token: Token[Span | None] | None = None
+
+    async def __aenter__(self) -> Span:
+        """Async enter - delegates to sync enter."""
+        return self.__enter__()
+
+    async def __aexit__(self, *args: object) -> None:
+        """Async exit - delegates to sync exit."""
+        self.__exit__()
+
+    def __enter__(self) -> Span:
+        """Enter context and set the current span."""
+        self._token = _current_span.set(self._span)
+        return self._span
+
+    def __exit__(self, *args: object) -> None:
+        """Exit context, end span, and reset current span."""
+        self._span.end()
+        if self._token is not None:
+            _current_span.reset(self._token)
+
+
+def set_current_span(*, s: Span) -> Token[Span | None]:
+    """
+    Manually set the current span.
+
+    Returns a token that must be used with reset_current_span().
+    Prefer using the span context manager instead.
+
+    Args:
+        s: The Span to set as current.
+
+    Returns:
+        Token for resetting the span.
+
+    """
+    return _current_span.set(s)
+
+
+def reset_current_span(*, token: Token[Span | None]) -> None:
+    """
+    Reset the current span using a token from set_current_span().
+
+    Args:
+        token: Token returned from set_current_span().
+
+    """
+    _current_span.reset(token)
+
+
+# Define public API for this module
+__all__ = [
+    "Span",
+    "get_current_span",
+    "get_current_trace_id",
+    "reset_current_span",
+    "set_current_span",
+    "span",
+]

aiohomematic/translations/de.json

@@ -0,0 +1,237 @@
+{
+  "exception.central.create_devices.no_clients": "CREATE_DEVICES fehlgeschlagen: Keine Clients initialisiert. Zentrale {name} wird nicht gestartet.",
+  "exception.central.decorators.backend_system_handler.args_exception": "args-exception backend_system_callback [{reason}]",
+  "exception.central.decorators.backend_system_handler.identify_central_failed": "EXEC_BACKEND_SYSTEM_CALLBACK fehlgeschlagen: Problem beim Ermitteln der Zentrale: {reason}",
+  "exception.central.decorators.event_handler.args_exception": "args-exception event_callback [{reason}]",
+  "exception.central.get_client.interface_missing": "GET_CLIENT fehlgeschlagen: Kein Client für {interface_id} in Zentrale {name}",
+  "exception.central.get_client.interface_type_missing": "GET_CLIENT fehlgeschlagen: Kein Client für Interface {interface} in Zentrale {name}",
+  "exception.central.get_client.no_parameter": "GET_CLIENT fehlgeschlagen: interface_id oder interface muss angegeben werden für Zentrale {name}",
+  "exception.central.rpc_server.invalid_xml": "Ungültiges XML: {error}",
+  "exception.central.rpc_server.parse_error": "Parsefehler: {error}",
+  "exception.central.start.failed": "Start der Zentrale {name} fehlgeschlagen: {reason}",
+  "exception.central.validate_config.no_clients": "VALIDATE_CONFIG: Keine Clients definiert.",
+  "exception.client.add_link.failed": "ADD_LINK fehlgeschlagen für {sender}/{receiver}/{name}/{description}: {reason}",
+  "exception.client.client_config.no_connection": "Keine Verbindung zu {interface_id}",
+  "exception.client.client_config.unable_to_connect": "Verbindung nicht möglich {reason}",
+  "exception.client.get_all_device_data.failed": "GET_ALL_DEVICE_DATA fehlgeschlagen: Gerätedaten für Schnittstelle {interface} konnten nicht abgerufen werden",
+  "exception.client.get_install_mode.failed": "GET_INSTALL_MODE fehlgeschlagen für {interface_id}: {reason}",
+  "exception.client.get_link_peers.failed": "GET_LINK_PEERS fehlgeschlagen für {address}: {reason}",
+  "exception.client.get_links.failed": "GET_LINKS fehlgeschlagen für {address}: {reason}",
+  "exception.client.get_metadata.failed": "GET_METADATA fehlgeschlagen für {address}/{data_id}: {reason}",
+  "exception.client.get_paramset.failed": "GET_PARAMSET fehlgeschlagen für {address}/{paramset_key}: {reason}",
+  "exception.client.get_value.failed": "GET_VALUE fehlgeschlagen für {channel_address}/{parameter}/{paramset_key}: {reason}",
+  "exception.client.interface_config.port_required": "VALIDATE Schnittstellenkonfiguration fehlgeschlagen: Port muss für Schnittstelle {interface} definiert sein",
+  "exception.client.json_ccu.get_paramset.failed": "GET_PARAMSET fehlgeschlagen für {address}/{paramset_key}: {reason}",
+  "exception.client.json_ccu.get_value.failed": "GET_VALUE fehlgeschlagen für: {channel_address}/{parameter}/{paramset_key}: {reason}",
+  "exception.client.json_ccu.set_value.unknown_type": "SET_VALUE fehlgeschlagen: Parametertyp {channel_address}/{paramset_key}/{parameter} konnte nicht ermittelt werden",
+  "exception.client.json_post.connector_certificate_error": "Zertifikatfehler des Connectors: {reason}",
+  "exception.client.json_post.connector_error": "Connector-Fehler: {reason}",
+  "exception.client.json_post.http_status": "HTTP-Status: {status}",
+  "exception.client.json_post.login_failed": "Fehler beim Anmelden",
+  "exception.client.json_post.method_unsupported": "POST: Methode '{method} wird vom Backend nicht unterstützt.",
+  "exception.client.json_post.no_credentials": "Keine Zugangsdaten gesetzt",
+  "exception.client.json_post.no_response": "POST-Methode ohne Antwort fehlgeschlagen",
+  "exception.client.json_post.no_session": "ClientSession nicht initialisiert",
+  "exception.client.json_rpc.circuit_open": "Circuit Breaker ist offen für {url} - Anfragen werden vorübergehend blockiert",
+  "exception.client.parameter.not_found": "Parameter {parameter} wurde nicht gefunden: {interface_id}/{channel_address}/{paramset_key}",
+  "exception.client.parameter.operation_unsupported": "Parameter {parameter} unterstützt die angeforderte Operation {operation} nicht",
+  "exception.client.parameter.value_above_max": "Wert {value} für Parameter {parameter} überschreitet Maximum {max_value}",
+  "exception.client.parameter.value_below_min": "Wert {value} für Parameter {parameter} liegt unter Minimum {min_value}",
+  "exception.client.paramset_key.invalid": "Parameter paramset_key ist weder ein gültiger ParamsetKey noch eine Kanaladresse.",
+  "exception.client.put_paramset.failed": "PUT_PARAMSET fehlgeschlagen für {channel_address}/{paramset_key}/{values}: {reason}",
+  "exception.client.remove_link.failed": "REMOVE_LINK fehlgeschlagen für {sender}/{receiver}: {reason}",
+  "exception.client.report_value_usage.failed": "REPORT_VALUE_USAGE fehlgeschlagen: {address}/{value_id}/{ref_counter}: {reason}",
+  "exception.client.rx_mode.unsupported": "Nicht unterstützter rx_mode: {rx_mode}",
+  "exception.client.script.missing": "Skriptdatei für {script} existiert nicht",
+  "exception.client.set_install_mode.failed": "SET_INSTALL_MODE fehlgeschlagen für {interface_id}: {reason}",
+  "exception.client.set_metadata.failed": "SET_METADATA fehlgeschlagen für {address}/{data_id}/{value}: {reason}",
+  "exception.client.set_value.failed": "SET_VALUE fehlgeschlagen für {channel_address}/{parameter}={value}: {reason}",
+  "exception.client.update_device_firmware.failed": "UPDATE_DEVICE_FIRMWARE fehlgeschlagen: {reason}",
+  "exception.client.xmlrpc.circuit_open": "Circuit Breaker ist offen für {interface_id} - Anfragen vorübergehend blockiert",
+  "exception.client.xmlrpc.http_connection_state_error": "HTTP-Verbindungszustandsfehler auf {interface_id}: {reason}",
+  "exception.client.xmlrpc.method_unsupported": "XmlRPC.__ASYNC_REQUEST: Methode '{method} wird vom Backend nicht unterstützt.",
+  "exception.client.xmlrpc.no_connection": "Keine Verbindung zu {interface_id}",
+  "exception.client.xmlrpc.no_connection_with_reason": "Keine Verbindung zu {context}: {reason}",
+  "exception.client.xmlrpc.null_proxy_unsupported": "XML-RPC wird auf {interface_id} nicht unterstützt - verwende JSON-RPC-Methoden stattdessen",
+  "exception.client.xmlrpc.os_error": "OSError auf {interface_id}: {reason}",
+  "exception.client.xmlrpc.ssl_error": "SSLError auf {interface_id}: {reason}",
+  "exception.config.check.callback_host.invalid": "Ungültiger Callback-Hostname oder IPv4-Adresse",
+  "exception.config.check.callback_port_xml_rpc.invalid": "Ungültiger XML-RPC-Callback-Port",
+  "exception.config.check.host.invalid": "Ungültiger Hostname oder IPv4-Adresse",
+  "exception.config.check.instance_name.separator": "Instanzname darf {sep} nicht enthalten",
+  "exception.config.check.json_port.invalid": "Ungültiger JSON-Port",
+  "exception.config.check.password.invalid": "Passwort ist nicht gültig",
+  "exception.config.check.password.required": "Passwort ist erforderlich",
+  "exception.config.check.primary_interface.missing": "Keine primäre Schnittstelle ({interfaces}) definiert",
+  "exception.config.check.username.empty": "Benutzername darf nicht leer sein",
+  "exception.config.invalid": "Ungültige Konfiguration: {failures}",
+  "exception.create_central.failed": "Zentrale konnte nicht erstellt werden: {reason}",
+  "exception.model.action_select.value_not_in_value_list": "ACTION_SELECT {name} (unique_id={unique_id}): Wert nicht in Werteliste",
+  "exception.model.custom.climate.set_temperature.invalid": "SET_TEMPERATURE fehlgeschlagen: Ungültige Temperatur: {temperature} (min: {min}, max: {max})",
+  "exception.model.custom.definition.create_custom_data_point.failed": "_CREATE_CUSTOM_DATA_POINT: benutzerdefinierter Datenpunkt konnte nicht erstellt werden: {reason}",
+  "exception.model.custom.light.invalid_brightness": "Ungültige Helligkeit für Datenpunkt {full_name}: {value}. Muss 0.0-1.0 sein.",
+  "exception.model.custom.light.invalid_color": "Ungültige Farbe für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.light.invalid_duration_unit": "Ungültige Dauereinheit für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.light.invalid_on_time": "Ungültige Einschaltzeit für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.light.invalid_repetitions": "Ungültige Wiederholungen für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.siren.invalid_duration_unit": "Ungültige Dauereinheit für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.siren.invalid_light": "Ungültiges Licht für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.siren.invalid_repetitions": "Ungültige Wiederholungen für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.siren.invalid_soundfile": "Ungültige Sounddatei für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.siren.invalid_soundfile_index": "Sounddatei-Index muss 1-189 sein, erhalten {index}",
+  "exception.model.custom.siren.invalid_tone": "Ungültiger Ton für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.siren.invalid_volume": "Ungültige Lautstärke für Datenpunkt {full_name}: {value}. Muss 0.0-1.0 sein.",
+  "exception.model.custom.text_display.invalid_alignment": "Ungültige Ausrichtung für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_background_color": "Ungültige Hintergrundfarbe für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_display_id": "Ungültige Display-ID für Datenpunkt {full_name}: {value}. Muss 1-5 sein.",
+  "exception.model.custom.text_display.invalid_icon": "Ungültiges Symbol für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_interval": "Ungültiges Intervall für Datenpunkt {full_name}: {value}. Muss 1-15 sein.",
+  "exception.model.custom.text_display.invalid_repeat": "Ungültige Wiederholungsanzahl für Datenpunkt {full_name}: {value}. Muss 0-15 sein.",
+  "exception.model.custom.text_display.invalid_sound": "Ungültiger Ton für Datenpunkt {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_text_color": "Ungültige Textfarbe für Datenpunkt {full_name}: {value}",
+  "exception.model.data_point.subscribe_handler.already_registered": "REGISTER_DATA_POINT_UPDATED_CALLBACK fehlgeschlagen: hm_data_point: {full_name} ist bereits registriert von {custom_id}",
+  "exception.model.device.export_device_definition.failed": "EXPORT_DEVICE_DEFINITION fehlgeschlagen: {reason}",
+  "exception.model.event.create_event.failed": "CREATE_EVENT_AND_APPEND_TO_CHANNEL: Ereignis konnte nicht erstellt werden: {reason}",
+  "exception.model.generic.create_data_point.failed": "CREATE_DATA_POINT_AND_APPEND_TO_CHANNEL: Datenpunkt konnte nicht erstellt werden: {reason}",
+  "exception.model.hub.number.invalid_value": "SYSVAR.NUMBER fehlgeschlagen: Ungültiger Wert: {value} (min: {min}, max: {max})",
+  "exception.model.number.invalid_value": "NUMBER fehlgeschlagen: Ungültiger Wert: {value} (min: {min}, max: {max}, special:{special})",
+  "exception.model.select.value_not_in_value_list": "Wert nicht in value_list für {name}/{unique_id}",
+  "exception.model.week_profile.copy_schedule.profile_count_mismatch": "Kopieren des Zeitplans nicht möglich: Anzahl der Profil-Zeitpläne muss identisch sein",
+  "exception.model.week_profile.copy_schedule.same_device_invalid": "Kopieren des Zeitplans auf demselben Gerät nur mit definierten und unterschiedlichen Quell-/Zielprofilen möglich",
+  "exception.model.week_profile.schedule.unsupported": "Zeitplan wird vom Gerät {name} nicht unterstützt",
+  "exception.model.week_profile.source_profile.not_loaded": "Quellprofil {source_profile} konnte nicht geladen werden.",
+  "exception.model.week_profile.validate.base_temperature_out_of_range": "VALIDATE_PROFILE: Basistemperatur {base_temperature} liegt nicht im gültigen Bereich (min: {min}, max: {max})",
+  "exception.model.week_profile.validate.endtime_missing": "VALIDATE_PROFILE: ENDTIME fehlt.",
+  "exception.model.week_profile.validate.overlap": "VALIDATE_PROFILE: Zeitspannen überschneiden sich mit einem vorherigen Slot: Start {start} / Ende {end}",
+  "exception.model.week_profile.validate.profile_name_invalid": "Kein gültiger Profilname: {profile_name}",
+  "exception.model.week_profile.validate.sequence_rising": "VALIDATE_PROFILE: Zeitfolge muss aufsteigend sein. {time} ist kleiner als der vorherige Wert {previous} für Profil: {profile} / Wochentag: {weekday} / Slot-Nr.: {no}",
+  "exception.model.week_profile.validate.slot_missing": "VALIDATE_PROFILE: Slot-Nr. {no} fehlt im Profil: {profile} / Wochentag: {weekday}",
+  "exception.model.week_profile.validate.slot_type_missing": "VALIDATE_PROFILE: Slot-Typ {slot_type} fehlt im Profil: {profile} / Wochentag: {weekday} / Slot-Nr.: {no}",
+  "exception.model.week_profile.validate.start_before_end": "VALIDATE_PROFILE: Startzeit {start} muss kleiner als Endzeit {end} sein",
+  "exception.model.week_profile.validate.starttime_missing": "VALIDATE_PROFILE: STARTTIME fehlt.",
+  "exception.model.week_profile.validate.temperature_missing": "VALIDATE_PROFILE: TEMPERATURE fehlt.",
+  "exception.model.week_profile.validate.temperature_out_of_range_for_profile_slot": "VALIDATE_PROFILE: Temperatur {temperature} liegt nicht im gültigen Bereich (min: {min}, max: {max}) für Profil: {profile} / Wochentag: {weekday} / Slot-Nr.: {no}",
+  "exception.model.week_profile.validate.temperature_out_of_range_for_times": "VALIDATE_PROFILE: Temperatur {temperature} liegt nicht im gültigen Bereich (min: {min}, max: {max}) für Startzeit: {start} / Endzeit: {end}",
+  "exception.model.week_profile.validate.time_convert_failed": "Zeit {time} konnte nicht konvertiert werden. Format muss hh:mm sein.",
+  "exception.model.week_profile.validate.time_invalid_format": "Zeit {time} ist ungültig. Format muss hh:mm sein mit min: {min} und max: {max}",
+  "exception.model.week_profile.validate.time_out_of_bounds_profile_slot": "VALIDATE_PROFILE: Zeit {time} muss zwischen {min_time} und {max_time} liegen für Profil: {profile} / Wochentag: {weekday} / Slot-Nr.: {no}",
+  "exception.model.week_profile.validate.too_few_slots": "VALIDATE_PROFILE: Zu wenige Slots im Profil: {profile} / Wochentag: {weekday}",
+  "exception.model.week_profile.validate.too_many_slots": "VALIDATE_PROFILE: Zu viele Slots im Profil: {profile} / Wochentag: {weekday}",
+  "exception.startup.validation_failed": "AioHomematic-Startvalidierung fehlgeschlagen: {reason}",
+  "exception.store.device_description.not_found": "Beschreibung für {address} auf Schnittstelle {interface_id} nicht gefunden",
+  "exception.store.session_recorder.ttl_positive": "default_ttl_seconds muss positiv sein",
+  "exception.support.boolean.invalid_type": "Ungültiger Boolescher Wert. Keine Zeichenkette.",
+  "exception.support.check_or_create_directory.failed": "Verzeichnis {directory} konnte nicht erstellt werden: {reason}",
+  "exception.support.get_local_ip.resolve_failed": "Host kann nicht aufgelöst werden für {host}:{port}: {reason}",
+  "exception.support.host_empty": "Host darf nicht leer sein",
+  "exception.support.host_invalid": "Ungültiges Host-Format: {host}. Muss ein gültiger Hostname oder eine IP-Adresse sein",
+  "exception.validator.categories.not_exhaustive": "BLOCKED_CATEGORIES/CATEGORIES/HUB_CATEGORIES sind nicht vollständig. Fehlende Kategorien: {missing}",
+  "exception.validator.channel_address.invalid": "CHANNEL_ADDRESS ist ungültig",
+  "exception.validator.custom_definition.invalid": "Schema für benutzerdefinierte Datenpunkdefinition ist ungültig",
+  "exception.validator.device_address.invalid": "DEVICE_ADDRESS ist ungültig",
+  "exception.validator.hostname.invalid": "Hostname ist ungültig",
+  "exception.validator.ipv4_address.invalid": "IPv4_address ist ungültig",
+  "exception.validator.paramset_key.invalid": "PARAMSET_KEY ist ungültig",
+  "exception.validator.password.invalid": "Password ist ungültig",
+  "exception.validator.undefined_in_lists": "DataPointCategory.UNDEFINED darf nicht in BLOCKED_CATEGORIES/CATEGORIES/HUB_CATEGORIES enthalten sein",
+  "issue.fetch_data_failed": "Abrufen von Gerätedaten von Interface {interface_id} fehlgeschlagen",
+  "issue.ping_pong_mismatch": "Ping-Pong-Diskrepanz auf {interface_id} erkannt ({mismatch_type}: {mismatch_count} Abweichungen)",
+  "log.backend_detection.detect_backend.backend_type": "DETECT_BACKEND: Erkannter Backend-Typ: {backend}",
+  "log.backend_detection.detect_backend.found_interfaces": "DETECT_BACKEND: Interfaces via JSON-RPC gefunden: {interfaces}",
+  "log.backend_detection.detect_backend.found_version": "DETECT_BACKEND: Version '{version}' auf Port {port} gefunden",
+  "log.backend_detection.detect_backend.json_rpc_fallback": "DETECT_BACKEND: JSON-RPC-Abfrage fehlgeschlagen, verwende erkanntes Interface",
+  "log.backend_detection.detect_backend.no_backend_found": "DETECT_BACKEND: Kein Backend auf Host {host} gefunden",
+  "log.backend_detection.detect_backend.probing": "DETECT_BACKEND: Teste {host}:{port} (TLS={tls}, Interface={interface})",
+  "log.backend_detection.detect_backend.starting": "DETECT_BACKEND: Starte Erkennung für Host {host} (Timeout={total_timeout}s)",
+  "log.backend_detection.detect_backend.total_timeout": "DETECT_BACKEND: Erkennung nach {total_timeout}s abgebrochen für Host {host}",
+  "log.backend_detection.json_rpc.auth_failed": "DETECT_BACKEND: Authentifizierung fehlgeschlagen bei {url}",
+  "log.backend_detection.json_rpc.connection_failed": "DETECT_BACKEND: Verbindung fehlgeschlagen bei {url}",
+  "log.backend_detection.json_rpc.interface_not_present": "DETECT_BACKEND: Interface '{interface}' ist installiert aber nicht gestartet - wird übersprungen",
+  "log.backend_detection.json_rpc.interface_present": "DETECT_BACKEND: Interface '{interface}' ist verfügbar und läuft",
+  "log.backend_detection.json_rpc.is_present_failed": "DETECT_BACKEND: Prüfung ob Interface '{interface}' verfügbar ist fehlgeschlagen: {reason}",
+  "log.backend_detection.json_rpc.query_failed": "DETECT_BACKEND: JSON-RPC-Abfrage fehlgeschlagen bei {url} - {exc_type}: {reason}",
+  "log.backend_detection.json_rpc.querying": "DETECT_BACKEND: JSON-RPC-Abfrage an {url}",
+  "log.backend_detection.json_rpc.unknown_interface": "DETECT_BACKEND: Unbekanntes Interface '{interface}', wird übersprungen",
+  "log.backend_detection.xml_rpc.probe_error": "DETECT_BACKEND: XML-RPC-Testfehler für {host}:{port} - {exc_type}: {reason}",
+  "log.backend_detection.xml_rpc.probe_failed": "DETECT_BACKEND: XML-RPC-Test fehlgeschlagen für {host}:{port} - {exc_type}: {reason}",
+  "log.backend_detection.xml_rpc.probe_timeout": "DETECT_BACKEND: XML-RPC-Test Zeitüberschreitung für {host}:{port}",
+  "log.central.accept_device_in_inbox.no_client": "ACCEPT_DEVICE_IN_INBOX fehlgeschlagen: Kein primärer Client verfügbar für {device_address} auf {name}",
+  "log.central.create_client.no_connection": "CREATE_CLIENT fehlgeschlagen: Keine Verbindung zur Schnittstelle {interface_id} [{reason}]",
+  "log.central.create_clients.already_created": "CREATE_CLIENTS: Clients für {name} sind bereits erstellt",
+  "log.central.create_clients.created_count_failed": "CREATE_CLIENTS fehlgeschlagen: {created} von {total} Clients erstellt",
+  "log.central.create_clients.interface_not_available": "CREATE_CLIENTS fehlgeschlagen: Schnittstelle: {interface} ist für das Backend {name} nicht verfügbar",
+  "log.central.create_clients.no_interfaces": "CREATE_CLIENTS fehlgeschlagen: Keine Schnittstellen für {name} definiert",
+  "log.central.create_clients.no_primary_identified": "CREATE_CLIENTS fehlgeschlagen: Kein primärer Client für {name} identifiziert",
+  "log.central.rename_device.not_found": "RENAME_DEVICE fehlgeschlagen: Gerät {device_address} nicht gefunden auf {name}",
+  "log.central.restart_clients.restarted": "RESTART_CLIENTS: Zentrale {name} hat Clients neu gestartet",
+  "log.central.rpc_server.background_task_failed": "Hintergrundaufgabe {task_name} fehlgeschlagen: {error}",
+  "log.central.rpc_server.error": "ERROR fehlgeschlagen: interface_id = {interface_id}, error_code = {error_code}, message = {msg}",
+  "log.central.rpc_server.method_failed": "XML-RPC-Methode {method_name} fehlgeschlagen",
+  "log.central.rpc_server.protocol_error": "XML-RPC-Protokollfehler: {error}",
+  "log.central.rpc_server.unexpected_error": "Unerwarteter Fehler bei der Verarbeitung der XML-RPC-Anfrage",
+  "log.central.scheduler.check_connection.attempting_reconnect": "CHECK_CONNECTION: RPC stabil für {name} - versuche vollständige Wiederverbindung",
+  "log.central.scheduler.check_connection.connection_loss_detected": "CHECK_CONNECTION: Verbindungsverlust für {name} erkannt - starte stufenweise Wiederverbindung",
+  "log.central.scheduler.check_connection.failed": "CHECK_CONNECTION fehlgeschlagen: {exc_type} [{reason}]",
+  "log.central.scheduler.check_connection.no_clients": "CHECK_CONNECTION fehlgeschlagen: Es existieren keine Clients. Versuche, Clients für Server {name} zu erstellen",
+  "log.central.scheduler.check_connection.no_connection": "CHECK_CONNECTION fehlgeschlagen: keine Verbindung: {reason}",
+  "log.central.scheduler.check_connection.reconnect_failed": "CHECK_CONNECTION: Wiederverbindung für {name} fehlgeschlagen - wird erneut versucht",
+  "log.central.scheduler.check_connection.reconnect_success": "CHECK_CONNECTION: Wiederverbindung für {name} erfolgreich - Interfaces: {interfaces}",
+  "log.central.scheduler.check_connection.rpc_check_passed": "CHECK_CONNECTION: Erste RPC-Prüfung erfolgreich für {name} - starte Warmup",
+  "log.central.scheduler.check_connection.rpc_stable": "CHECK_CONNECTION: Zweite RPC-Prüfung erfolgreich für {name} - Dienste stabil",
+  "log.central.scheduler.check_connection.rpc_unstable": "CHECK_CONNECTION: RPC wurde während Warmup instabil für {name} - wiederhole",
+  "log.central.scheduler.check_connection.tcp_check_timeout": "CHECK_CONNECTION: TCP-Port-Prüfung Timeout ({timeout}s) für {name} - starte Prüfung neu",
+  "log.central.scheduler.check_connection.tcp_port_available": "CHECK_CONNECTION: TCP-Port {host}:{port} für {name} verfügbar",
+  "log.central.set_system_variable.not_found": "SET_SYSTEM_VARIABLE fehlgeschlagen: Variable {legacy_name} nicht gefunden auf {name}",
+  "log.central.validate_config_and_get_system_information.client_failed": "VALIDATE_CONFIG_AND_GET_SYSTEM_INFORMATION fehlgeschlagen für Client {interface}: {reason}",
+  "log.client.circuit_breaker.state_transition": "CIRCUIT_BREAKER: {old_state} → {new_state} für {interface_id} (Fehler={failure_count}, Erfolge={success_count})",
+  "log.client.create_backup_and_download.completed": "CREATE_BACKUP_AND_DOWNLOAD: Backup abgeschlossen: {filename} ({size} Bytes)",
+  "log.client.create_backup_and_download.failed": "CREATE_BACKUP_AND_DOWNLOAD: Backup-Erstellung fehlgeschlagen",
+  "log.client.create_backup_and_download.idle": "CREATE_BACKUP_AND_DOWNLOAD: Unerwarteter Idle-Status während Backup",
+  "log.client.create_backup_and_download.running": "CREATE_BACKUP_AND_DOWNLOAD: Backup läuft noch ({elapsed:.1f}s vergangen)",
+  "log.client.create_backup_and_download.timeout": "CREATE_BACKUP_AND_DOWNLOAD: Backup-Timeout nach {max_wait_time:.1f}s",
+  "log.client.is_callback_alive.no_events": "IS_CALLBACK_ALIVE: Callback für {interface_id} hat seit {seconds}s keine Ereignisse erhalten",
+  "log.client.json_rpc.accept_device_in_inbox.failed": "ACCEPT_DEVICE_IN_INBOX für {device_address} fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.create_backup_start.failed": "CREATE_BACKUP_START fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.create_backup_status.failed": "CREATE_BACKUP_STATUS fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.do_login.max_attempts_reached": "DO_LOGIN fehlgeschlagen: Maximale Anzahl fehlgeschlagener Anmeldeversuche ({max_attempts}) erreicht. Bitte Zugangsdaten überprüfen.",
+  "log.client.json_rpc.do_login.no_credentials": "DO_LOGIN fehlgeschlagen: Keine Zugangsdaten gesetzt",
+  "log.client.json_rpc.do_login.rate_limited": "DO_LOGIN: Ratenlimitiert nach {attempts} fehlgeschlagenen Versuchen. Warte {wait_time:.1f} Sekunden.",
+  "log.client.json_rpc.download_backup.error": "DOWNLOAD_BACKUP fehlgeschlagen: {reason}",
+  "log.client.json_rpc.download_backup.failed": "DOWNLOAD_BACKUP fehlgeschlagen: HTTP-Status {status}",
+  "log.client.json_rpc.download_backup.no_session": "DOWNLOAD_BACKUP fehlgeschlagen: Keine Session-ID verfügbar",
+  "log.client.json_rpc.download_firmware.error": "DOWNLOAD_FIRMWARE fehlgeschlagen: {reason}",
+  "log.client.json_rpc.download_firmware.failed": "DOWNLOAD_FIRMWARE fehlgeschlagen: HTTP-Status {status}",
+  "log.client.json_rpc.download_firmware.no_session": "DOWNLOAD_FIRMWARE fehlgeschlagen: Keine Session-ID verfügbar",
+  "log.client.json_rpc.get_all_system_variables.parse_failed": "GET_ALL_SYSTEM_VARIABLES fehlgeschlagen: {exc_type} [{reason}] SysVar {legacy_name} konnte nicht geparst werden",
+  "log.client.json_rpc.get_backend_info.failed": "GET_BACKEND_INFO fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.get_inbox_devices.decode_failed": "GET_INBOX_DEVICES fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.get_program_descriptions.decode_failed": "GET_PROGRAM_DESCRIPTIONS fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.get_service_messages.decode_failed": "GET_SERVICE_MESSAGES fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.get_system_update_info.decode_failed": "GET_SYSTEM_UPDATE_INFO fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.get_system_variable_descriptions.decode_failed": "GET_SYSTEM_VARIABLE_DESCRIPTIONS fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.rename_channel.failed": "RENAME_CHANNEL für {channel_address} fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.rename_device.failed": "RENAME_DEVICE für {device_address} fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.set_system_variable.value_contains_html": "SET_SYSTEM_VARIABLE: Wert ({value}) enthält HTML-Tags. Diese werden beim Schreiben herausgefiltert.",
+  "log.client.json_rpc.trigger_firmware_update.failed": "TRIGGER_FIRMWARE_UPDATE fehlgeschlagen: JSON konnte nicht dekodiert werden: {reason}",
+  "log.client.json_rpc.trigger_firmware_update.not_triggered": "TRIGGER_FIRMWARE_UPDATE: {message}",
+  "log.client.json_rpc.trigger_firmware_update.success": "TRIGGER_FIRMWARE_UPDATE: {message}",
+  "log.client.reconnect.reconnected": "RECONNECT: Client {interface_id} wurde erneut verbunden",
+  "log.client.update_device_firmware.result": "UPDATE_DEVICE_FIRMWARE: Firmware-Update für {device_address} ausgeführt mit Ergebnis '{result}'",
+  "log.client.update_device_firmware.try": "UPDATE_DEVICE_FIRMWARE: Firmware-Update für {device_address} wird versucht",
+  "log.core.signal.shutdown": "Signal empfangen: {sig}. Zentrale wird heruntergefahren",
+  "log.metrics.observer.counter_key_limit": "METRICS OBSERVER: Zähler-Schlüsselgrenze erreicht, verworfen: {metric_key}",
+  "log.metrics.observer.gauge_key_limit": "METRICS OBSERVER: Messwert-Schlüsselgrenze erreicht, verworfen: {metric_key}",
+  "log.metrics.observer.latency_key_limit": "METRICS OBSERVER: Latenz-Schlüsselgrenze erreicht, verworfen: {metric_key}",
+  "log.model.custom.definition.validate_failed": "Die benutzerdefinierte Datenpunktdefinition konnte nicht validiert werden. {path}, {msg}",
+  "log.model.custom.text_display.send_text.burst_limit_warning": "SEND_TEXT: {full_name}: Burst-Limit-Warnung aktiv - Befehl könnte gedrosselt werden",
+  "log.model.device.channel_description_not_found": "INIT_DEVICE: Überspringe Kanal {address} - Beschreibung konnte nicht von der CCU abgerufen werden",
+  "log.model.generic_data_point.send_value.not_writable": "SEND_VALUE: Schreiben auf nicht beschreibbaren Datenpunkt {full_name} ist nicht möglich",
+  "log.model.hub.update.progress_completed": "Hub Firmware-Update abgeschlossen: {old_version} -> {new_version}",
+  "log.model.hub.update.progress_poll_error": "Fehler beim Abfragen des Update-Status (CCU wird möglicherweise neu gestartet): {error}",
+  "log.model.hub.update.progress_timeout": "Hub Firmware-Update Überwachung nach {timeout}s abgelaufen",
+  "log.store.dynamic.pending_pong_mismatch": "Ausstehende PONG-Abweichung: Es besteht eine Abweichung zwischen gesendeten Ping-Ereignissen und empfangenen Pong-Ereignissen für Instanz {interface_id}. Möglicher Grund 1: Es laufen mehrere Instanzen mit demselben Instanznamen für diese Integration. Fügen Sie eine Instanz erneut hinzu! Andernfalls erhält diese Instanz keine Update-Ereignisse von Ihrer CCU. Möglicher Grund 2: Auf der CCU hängt etwas oder wurde nicht bereinigt. Versuchen Sie daher einen Neustart der CCU. Möglicher Grund 3: Ihre Einrichtung ist falsch konfiguriert und diese Instanz kann keine Ereignisse von der CCU empfangen.",
+  "log.store.dynamic.unknown_pong_mismatch": "Unbekannte PONG-Abweichung: Ihre Instanz {interface_id} erhält PONG-Ereignisse, die sie nicht gesendet hat. Möglicher Grund 1: Es laufen mehrere Instanzen mit demselben Instanznamen für diese Integration. Fügen Sie eine Instanz erneut hinzu! Andernfalls erhält die andere Instanz keine Update-Ereignisse von Ihrer CCU. Möglicher Grund 2: Auf der CCU hängt etwas oder wurde nicht bereinigt. Versuchen Sie daher einen Neustart der CCU.",
+  "log.store.session_recorder.activate.already_running": "ACTIVATE: Aufzeichnungssitzung läuft bereits.",
+  "log.store.session_recorder.deactivate.already_running": "DEACTIVATE: Aufzeichnungssitzung läuft bereits.",
+  "log.support.check_password.invalid_chars": "CHECK_CONFIG: Passwort enthält nicht erlaubte Zeichen. Nur erlaubte Zeichen verwenden. Siehe Passwort-RegEx: {pattern}"
+}