sphings-dev.de

Systemüberwachung: Zigbee2MQTT, Uptime Kuma, Diun und Anmeldeversuche

Ein Smart-Home besteht aus mehr als Lampen: Zigbee-Koordinatoren, Docker-Container, Webdienste und der Zugang zu Home Assistant selbst. Damit mir Ausfälle nicht erst auffallen, wenn ein Licht nicht angeht, laufen bei mir fünf kleine Überwachungsautomationen. Keine ist groß. Zusammen decken sie Zigbee2MQTT, Uptime Kuma, Diun und die Anmeldeversuche ab.

Was du brauchst

  • Zigbee2MQTT mit dem MQTT-Broker in Home Assistant. Die Bridge liefert pro Instanz einen Verbindungsstatus (binary_sensor.zigbee2mqtt_bridge_…_connection_state)
  • Uptime Kuma mit der Home-Assistant-Integration uptime_kuma, die pro überwachtem Dienst einen Status-Sensor anlegt
  • Optional für die Überwachung von Home Assistant selbst: einen MQTT-Monitor in Uptime Kuma auf das Thema uptimekuma/heartbeat
  • Diun (Docker Image Update Notifier) auf einem Docker-Host mit Webhook-Benachrichtigung
  • Die Companion-App auf dem Handy für notify.mobile_app_…

So funktioniert es

Zigbee2MQTT läuft bei mir in drei Instanzen, je eine für Wohnzimmer, Schlafzimmer und Arbeitszimmer. Jede Bridge meldet ihren Zustand an Home Assistant. Fällt der Status für zehn Sekunden von on auf etwas anderes, geht eine Push-Mitteilung raus. Das sind drei fast identische Automationen, die sich nur in Sensor und Text unterscheiden. Sie sind im Modus single und haben keine Bedingungen. Dass auch ein Wechsel auf unavailable zählt, ist gewollt.

Die Integration legt für jeden Monitor einen Sensor an, dessen Name auf _status endet. Die Automation betrachtet alle diese Sensoren zusammen. Steht mindestens einer drei Minuten ununterbrochen auf down, erscheint eine persistente Meldung in Home Assistant mit der Liste der betroffenen Dienste. Sobald kein Sensor mehr down ist, wird die Meldung wieder entfernt. Weil die Entitäten über integration_entities aufgelöst werden, musst du neue Monitore nicht eintragen.

Eine weitere Automation veröffentlicht alle 30 Sekunden die Nutzlast alive auf dem Thema uptimekuma/heartbeat. Legt man in Uptime Kuma einen MQTT-Monitor auf dieses Thema an, fällt auf, wenn Home Assistant nicht mehr läuft. Das ist die Gegenrichtung zu den übrigen Automationen: Hier überwacht Uptime Kuma Home Assistant.

Die Automation für Anmeldeversuche lauscht auf neue persistente Meldungen. Enthält der Text „Too many login attempts“, „invalid authentication“ oder „login attempt“, schickt sie Titel und Text aufs Handy. Bei den beiden letzten Varianten hängt sie einen Link zu einem IP-Lookup-Dienst an, der die Adresse aus dem Text zieht. Wichtig: Der Link wird nur angezeigt, an den Dienst geht die Adresse erst, wenn du ihn antippst.

Diun prüft Container-Images auf neue Versionen und ruft bei einem Fund einen Webhook in Home Assistant auf. Die Automation erzeugt daraus eine persistente Meldung mit Image, Host und Status. Die Meldungs-ID enthält den Image-Namen, ein zweites Update desselben Images ersetzt die erste Meldung also, statt sich zu stapeln. Dazu geht eine Push-Mitteilung mit Link zur Docker-Hub-Seite raus, mit der Unterbrechungsstufe passive, damit sie nicht klingelt. Der Webhook ist local_only, nimmt also nur Aufrufe aus dem lokalen Netz an. Auf der Diun-Seite zeigt die Webhook-Benachrichtigung auf /api/webhook/<Webhook-Name> deiner Home-Assistant-Adresse.

Die Automation

Der Webhook-Name steht in der Adresse und ist de facto ein Passwort: Wähle einen langen, zufälligen Namen und lege ihn nirgends öffentlich ab.

alias: "Z2M Wohnzimmer ist nicht erreichbar"
triggers:
  - trigger: state
    entity_id:
      - binary_sensor.zigbee2mqtt_bridge_wohnzimmer_connection_state
    from:
      - "on"
    for:
      hours: 0
      minutes: 0
      seconds: 10
actions:
  - action: notify.mobile_app_handy
    data:
      message: "Zigbee2MQTT Wohnzimmer ist nicht erreichbar!"
mode: single
# Je Instanz eine Kopie mit anderem Sensor und Text (bei mir drei)
alias: "Uptime Kuma – Ausfallbenachrichtigung"
description: >-
  Benachrichtigt, wenn ein Uptime-Kuma-Dienst 3 Minuten ununterbrochen down ist,
  und entfernt die Meldung wieder, sobald kein Dienst mehr down ist.
triggers:
  - trigger: template
    id: down
    value_template: >-
      {{ integration_entities('uptime_kuma') | select('match', 'sensor\..*_status$')
         | select('is_state', 'down') | list | count > 0 }}
    for: "00:03:00"
  - trigger: template
    id: recovered
    value_template: >-
      {{ integration_entities('uptime_kuma') | select('match', 'sensor\..*_status$')
         | select('is_state', 'down') | list | count == 0 }}
actions:
  - choose:
      - conditions: [{condition: trigger, id: down}]
        sequence:
          - action: persistent_notification.create
            data:
              title: "Uptime Kuma: Ausfall erkannt"
              notification_id: uptime_kuma_down
              message: >-
                Die folgenden Dienste sind aktuell **nicht erreichbar**:
                {%- for entity_id in integration_entities('uptime_kuma')
                    if entity_id.endswith('_status') and states(entity_id) == 'down' %}
                - {{ (state_attr(entity_id, 'friendly_name') or entity_id).replace(' Status', '') }}
                {%- endfor %}
      - conditions: [{condition: trigger, id: recovered}]
        sequence:
          - action: persistent_notification.dismiss
            data:
              notification_id: uptime_kuma_down
mode: queued
alias: "UptimeKuma MQTT alive helper"
triggers:
  - trigger: time_pattern
    seconds: "/30"
actions:
  - action: mqtt.publish
    data:
      topic: uptimekuma/heartbeat
      payload: alive
mode: single
alias: "Too Many Login Attempts Notification"
triggers:
  - trigger: persistent_notification
    update_type: [added]
    notification_id: ""
conditions:
  - condition: template
    value_template: >-
      {% set message = trigger.notification.message %}
      {{ 'Too many login attempts' in message or 'invalid authentication' in message or 'login attempt' in message }}
actions:
  - action: notify.mobile_app_handy
    data:
      title: "{{ trigger.notification.title }}"
      message: >-
        {% set message = trigger.notification.message %}
        {% set now = now().strftime('%d %b: %X') %}
        {% if 'Too many login attempts' in message %}
          Login notification: {{ now }}: {{ message }}
        {% elif 'invalid authentication' in message or 'login attempt' in message %}
          Login notification: {{ now }}: {{ message }}
          Track offending ip on http://www.ip-tracker.org/locator/ip-lookup.php?ip={{ message.split('from ')[1] }}
        {% else %}
          Login notification other: {{ now }}: {{ message }}
        {% endif %}
mode: single
alias: "Diun: Container-Image-Update melden"
description: Nimmt Update-Meldungen von Diun entgegen und meldet sie per Push und persistenter Benachrichtigung.
triggers:
  - trigger: webhook
    webhook_id: DEIN-GEHEIMER-WEBHOOK-NAME
    allowed_methods: [POST]
    local_only: true
actions:
  - action: persistent_notification.create
    data:
      title: "Container-Update verfügbar"
      message: |-
        {{ trigger.json.image }}
        Host: {{ trigger.json.hostname }}
        Status: {{ trigger.json.status }}
      notification_id: "diun_{{ trigger.json.image | replace('/', '_') | replace(':', '_') }}"
  - action: notify.mobile_app_handy
    data:
      title: "Container-Update verfügbar"
      message: "{{ trigger.json.image }}"
      data:
        url: "{{ trigger.json.hub_link }}"
        push:
          interruption-level: passive
mode: queued
max: 25

Anpassen

  • Dupliziere die Z2M-Automation je Instanz und ersetze Sensor und Text. Mit nur einer Instanz bleibt es bei einer Automation.
  • Die drei Minuten bei Uptime Kuma sind ein Kompromiss zwischen kurzen Ausfällen und späten Meldungen. Passe sie an die Prüfintervalle deiner Monitore an.
  • Wer die Uptime-Kuma-Meldung auch aufs Handy braucht, ergänzt eine notify-Aktion im down-Zweig. Bei mir bleibt es bei der Meldung in der Oberfläche.
  • Hast du Diun nicht, lässt du die letzten beiden Blöcke weg.

Stolpersteine

Der Uptime-Kuma-Trigger prüft einen Zustand, nicht einzelne Dienste. Fällt ein zweiter Dienst aus, während der erste noch down ist, bleibt das Template wahr und die Meldung wird nicht neu erzeugt. Der zweite Dienst erscheint also erst dann in der Liste, wenn die Meldung einmal verschwunden ist. Bei den Anmeldeversuchen holt message.split('from ')[1] die Adresse aus dem Text. Fehlt „from “ in der Meldung, schlägt das Template fehl. Teste Template-Zeilen in den Entwicklerwerkzeugen, bevor du sie übernimmst.

Tags

Unterstützen

Diese Tools entstehen in meiner Freizeit und bleiben kostenlos, offen und cloud-frei. Wenn dir eins davon einen Nachmittag gespart hat, freue ich mich über einen Kaffee oder ein Stück Pizza.

Kaffee oder Pizza

Weitere Beiträge