HKS mit HA - Die Anleitung zum Nachbauen - #03.06 Monitoring (Netzwerk und HA)

Zurück zur Startseite und zum Inhaltsverzeichnis

Version: 2024-10-17

#HA System Monitor

Für ein stabiles System müssen wir wissen, ob es unserem HomeAssistant gut geht.

Hierfür gibt es die Standard Integration <System Monitor>.

Das <System Monitor> Dashboard sieht in unserer Heimkinosteuerung aktuell so aus:

pasted-from-clipboard.png

Damit wir diese Daten anzeigen können ist folgendes zu tun:

• HA-Menü: Settings/Devices&Services/Integrations => Add Integration
• "System Monitor" auswählen
• Inital Setup
• Area leer lassen => Finish

Die Installierte Integration präsentiert sich so:

pasted-from-clipboard.png

Klicken wir auf die "70 entities", sehen wir, dass alle Sensoren deaktiviert sind.

Jene Sensoren die wir abfragen wollen, sind zu aktivieren.

pasted-from-clipboard.png

• Load 1m
• Load 5m
• Load 15m
• Processor Use
• Processor Temperature
• Disk free
• Disk usage
• Memory usage

Logfile

Wichtig ist es noch die Fehler im Logfile im Blick zu halten.

Über das HA-Menü: Settings/System/Log wird eine Zusammenfassung aller Erros und Warnings im Log seit dem letzten Reboot angezeigt.

Um die die Anzahl der Fehler und Warnungen im System-Dashboard anzuzeigen, bin ich wie folgt vorgegangen:

(Ist für unsere Heimkino-Steuerung nicht relevant, aber ich möchte an diesem kurzen Beispiel zeigen was man noch so alles tun kann.)

In der <configuration.yaml> folgende Zeilen eintragen

counter:
    warning_counter:
        name: Warnings
    error_counter:
        name: Errors

Damit werden die Zähler (Counter) erstellt.

Damit auch gezählt wird sind zwei Automatisierungen zu erstellen:

alias: Count Log Errors
mode: queued
max: 10
triggers:
  - event_type: system_log_event
    event_data:
      level: ERROR
    trigger: event
actions:
  - action: counter.increment
    target:
      entity_id: counter.error_counter

alias: Count Log Warnings
mode: queued
max: 10
triggers:
  - event_type: system_log_event
    event_data:
      level: WARNING
    trigger: event
actions:
  - action: counter.increment
    target:
      entity_id: counter.warning_counter

Und noch eine Automatisierung damit nach einem Reboot die Counter wieder auf 0 gesetzt werden:

alias: Reset Log Coutners
mode: single
triggers:
  - trigger: homeassistant
    event: start
actions:
  - action: counter.reset
    target:
      entity_id:
        - counter.error_counter
        - counter.warning_counter

Die Dashboard-Konfiguration des Buttons, welche dann die Anzahl der Warnungen anzeigt und bei dessen Klicken man zur Log-File-Ansicht gelangt, ist dieser:

type: custom:button-card
label: |-
  [[[ try { 
    return ("Warnings: " + states['counter.warning_counter'].state)
  } catch (error) { return '---'} ]]]
show_name: false
show_label: true
styles:
  card:
    - font-size: 20px
    - height: 30px
tap_action:
  action: url
  url_path: |-
    [[[ try { 
      return "http://192.168.31.31:8123/config/logs";
    } catch (error) { return '---'} ]]]

#Ping_nn aka Simple_Ping

Die Standard Ping-Integration erfüllt nicht ganz meine Anforderung, daher habe ich ein eigene Ping-Integration erstellt. Diese Integration nutze ich auch für die Heimkinosteuerung.

Konfigurationszeilen in der configuration.yaml

pasted-from-clipboard.png

In der Sensor-Entity sieht es dann so aus:

pasted-from-clipboard.png

Und in einem Custum:Button-Card Dashboard zB so

pasted-from-clipboard.png

Installation als custum_component, wie schon beschrieben.

# Router (Mikrotik)

Nachdem Streaming eine wesentliche Medienquelle darstellt, ist es relevant zu wissen ob mit unserem lokalen Netzwerk und dem Internetanschluss alles passt,

In der Regel lassen sind alle gängigen Router in HomeAssistant gut einbinden.

Ich nutze Mikrotik-Router. Dessen Einbindung stelle ich kurz hier vor. Andere Router sollten ähnlich einzubinden sein.

Das ist das Custum:Button-Card Dashboard zum Netzwerkmonitoring:

pasted-from-clipboard.png

Installation:

(Geht auch über HACS, ich mache es aber manuell)

1) Das ZIP von Github laden:

https://github.com/tomaae/home…krotik_router/tree/master

pasted-from-clipboard.png

2) Upload der ZIP-Datei mit dem HA <File editor> nach config/custom_components

3) Das HA <Terminal> öffnen und folgende Kommandos eingeben:

>cd config/custom_components
>unzip homeassistant-mikrotik_router-master.zip
>mv homeassistant-mikrotik_router-master/custom_components/mikrotik_router mikrotik_router
>rm homeassistant-mikrotik_router-master -r
>ls

LS sollte den neuen Ordner <mikrotik_router> listen.

4) Hinzufügen der Integration

HA Menü:

/Settings/Devices&Services/Integrations => ADD INTEGRATION

5) Konfigurieren

Suche nach der „Mikrotik Router“-Integration (Custom Integration !) und wähle diese aus.

pasted-from-clipboard.png

Gib die Login-Daten für den Router ein.

HALT! Wir nutzen natürlich nicht den Admin-Zugang, sondern legen zuvor einen neuen User für Home-Assistant mit eingeschränkten Rechten an.

Also, wir öffnen das Admin-Tool (Winbox oder nutze das Web-Interface) und öffnen das User-Management.

pasted-from-clipboard.png

Unter dem Reiter <Groups> erstellen wir eine neue Gruppe mit den Namen „ha“. Diese erhält die nur die Policies „read“ und „api“

pasted-from-clipboard.png

Und jetzt noch den neuen User erstellen „ha“ und der Gruppe „ha“ zuordnen.

pasted-from-clipboard.png

Das IP-Port für die API-Schnittstelle, welches wir in der HA-Integration eintragen müssen, finden wir im Router unter

/IP/Services

Hier sind alle Router-Services mit ihren Ports gelistet.

Für uns muss hier das Service „api“ aktiv sein. Die Portnummer (hier „8728“) bitte merken.

pasted-from-clipboard.png

Die Firewall sollte per Default der Zugang zu den Service-Ports (=input) aktiviert sein.

Jetzt können wird endlich das Konfigurationsblatt der Mikrotik-Integration ausfüllen:

pasted-from-clipboard.png

Es wird uns die Liste der gefunden Devices angezeigt. Jedes Device könnten wir einer Area (Raum) zuordnen. Das benötigen wir nicht, da wir hier nur eine Heimkino-Steuerung erstellen!

pasted-from-clipboard.png

Die installierte Integration wird dann am Ende so angezeigt.

pasted-from-clipboard.png

Fortsetzung im nächsten Post:

Fortseztung:

Unter „CONFIGURE“ müssen wir noch die benötigten Sensoren „Port traffic sensors“ aktivieren.

pasted-from-clipboard.png

Klicken wir nach <Submit> dann auf „xx Devices“ sehen wir die Devices der Router-Integration für die Interfaces und System-Infos.

pasted-from-clipboard.png

Nach einem Klick auf ein Port-Device zB. „ether 1“ (=WAN=Internet) werden uns die Daten zu diesem Netzwerk-Interface angezeigt:

pasted-from-clipboard.png

Ein Klick auf das Main-Device zeigt die Status-Infos des Routers.

pasted-from-clipboard.png

Alle diese Infos können wird dann in den Dashboards anszeigen.

Zeitverlauf:

Um den Zeitverlauf von Sensordaten zu speichern und anzuzeigen benötigen wir noch die „history“-Integration. Diese ist eigentlich standardmäßig aktiv. Da wir aber die „default_config:“ im Basis-Setup deaktiviert haben müssen wir die „history“-Integration jetzt explizit in unserer <configuration.yaml> hinzufügen.

pasted-from-clipboard.png

Nach einem HA-Restart und kurze Zeit zum Datensammeln wird bei den Sensoren die History angezeigt:

pasted-from-clipboard.png

Die Router-Integrationen sind sehr umfangreich und können wesentlich mehr als hier gezeigt.

Praktisch jede Funktion des Routers lässt sich aufrufen und konfigurieren, sofern die gesetzten Rechte dies erlauben.