[Showcase] KNX-NG-Monitor: Busmonitor mit responsive Weboberfläche, zeichnet rund um die Uhr auf (Beta, Tester gesucht)

[frankthegreat]

Hab's auch installiert (als LXC Container in Proxmox) und es läuft. Gefällt mir gut.

Moin, ich fange auch gerade an mit Proxmox zu experimentieren bin aber noch ziemlich am Anfang.
Also LXC Container anlegen klappt schonmal, aber wie geht's dann weiter?
Vermutlich muß ich in der Konsole einen Befehl eingeben? Wenn ja, welchen? Oder muß ich was anderes machen...sorry für die Anfängerfragen

Das Projekt sieht sehr spannend aus, würde es gerne mal testen.
Wäre super, wenn du eine kleine Anleitung für Proxmox hier posten könntest. Wird vielleicht den einen oder anderen hier auch interessieren.

Danke schonmal.

[ploetman]

Moin,

klar, gerne! Hier meine Anleitung für Proxmox. Ich lasse die App direkt im Container als Dienst laufen, ohne Docker, das ist am schlanksten.

1. Template herunterladen
In der Proxmox-Oberfläche links auf deinen Node → local → CT Templates → Templates → ubuntu-24.04-standard auswählen und herunterladen.

2. Container anlegen
Oben rechts auf Create CT klicken:

• General: Hostname z. B. knx-monitor, Passwort vergeben, "Unprivileged container" angehakt lassen, "Nesting" ebenfalls angehakt lassen
  Template: das Ubuntu-24.04-Template
  Disks: 16–32 GB (für das Telegramm-Archiv)
  CPU: 1 Core
  Memory: 1024 MB
  Network: am besten eine feste IP, z. B. 192.168.x.y/24, dazu das Gateway (meist dein Router)
• DNS: Standard lassen

Nach dem Anlegen den Container starten und links auf ihn klicken → Console. Dort als root mit dem vergebenen Passwort anmelden.

3. Befehle in der Konsole
Diese Blöcke nacheinander in die Konsole kopieren.

System aktualisieren und benötigte Pakete installieren:

apt update && apt full-upgrade -y
apt install -y wget ca-certificates libicu-dev

Einen eigenen Benutzer für den Dienst anlegen (damit die App nicht als root läuft) und die App herunterladen:

useradd -r -m -d /opt/knx-monitor -s /usr/sbin/nologin knxmon
cd /opt/knx-monitor
wget https://github.com/ingel81/knx-ng-monitor/releases/latest/download/knx-ng-monitor-linux-x64.tar.gz
tar xzf knx-ng-monitor-linux-x64.tar.gz && rm knx-ng-monitor-linux-x64.tar.gz
chown -R knxmon: /opt/knx-monitor

Als Dienst einrichten, damit die App automatisch mit dem Container startet:

cat > /etc/systemd/system/knx-monitor.service <<'EOF'
[Unit]
Description=KNX-NG-Monitor
After=network-online.target
Wants=network-online.target

[Service]
User=knxmon
WorkingDirectory=/opt/knx-monitor
ExecStart=/opt/knx-monitor/KnxMonitor.Api
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now knx-monitor

Prüfen, ob alles läuft:

systemctl status knx-monitor

Dort sollte "active (running)" stehen.

4. Einrichtung im Browser
Im Browser http://<IP-des-Containers>:8080 aufrufen:

1. Im Setup-Assistenten einen Admin-Benutzer anlegen
   Unter Settings die KNX-Verbindung eintragen:
   • Mit KNX-IP-Router: Typ Routing, Adresse 224.0.23.12 (die Multicast-Adresse, nicht die IP des Routers!), Port 3671
     Mit KNX-IP-Interface: Typ Tunneling, die IP des Interfaces, Port 3671. Achtung: Das belegt einen Tunnel. Bei Interfaces mit nur einem Tunnel fliegt sonst z. B. deine Visu raus.
     Physikalische Adresse: eine freie Adresse in deiner Linie
   
   Optional unter Projects die .knxproj aus der ETS importieren. Dann haben alle Gruppenadressen Namen und DPTs.
2. Unter Monitor sollten jetzt die Telegramme einlaufen.

Update auf eine neue Version
Vorher in Proxmox einen Snapshot vom Container anlegen (Snapshots → Take Snapshot). Dann in der Konsole:

systemctl stop knx-monitor
cd /tmp && rm -rf knx-new && mkdir knx-new && cd knx-new
wget https://github.com/ingel81/knx-ng-monitor/releases/latest/download/knx-ng-monitor-linux-x64.tar.gz
tar xzf knx-ng-monitor-linux-x64.tar.gz && rm knx-ng-monitor-linux-x64.tar.gz
cp -a /tmp/knx-new/. /opt/knx-monitor/
chown -R knxmon: /opt/knx-monitor
systemctl start knx-monitor

Der Ordner data mit Datenbank und Einstellungen bleibt dabei unangetastet.

Viel Erfolg! Bei Fragen einfach melden.

[Taxus]

Gerne damit nochmals testen.

Danke, ist erledigt, das auf github bin/war ich. Ich hatte das issue aus alter Gewohnheit zunächst fälschlich hier aufgemacht.

[frankthegreat]

Moin,

klar, gerne! Hier meine Anleitung für Proxmox. Ich lasse die App direkt im Container als Dienst laufen, ohne Docker, das ist am schlanksten.

Viel Erfolg! Bei Fragen einfach melden.

Hab mal einen Versuch gestartet. Ich komme bis zum Punkt: Eigenen Benutzer für den Dienst anzulegen. Das hat wohl geklappt.
Es hakt dann beim Download der App. (siehe Fehlermeldung unten)

Hat sich vielleicht der Pfad geändert oder hab ich den Befehl falsch eingegeben?
Hatte eigentlich einfach copy/paste gemacht.

grafik.png

[Noschvie]

Warum verwendest du nicht die Docker Variante? Docker macht das Leben einfacher…

[ploetman]

Hat sich vielleicht der Pfad geändert oder hab ich den Befehl falsch eingegeben?
Hatte eigentlich einfach copy/paste gemacht

Du musst URL und /URL (inkl der eckigen Klammern) aus den Befehlen entfernen.

Habe die Anleitung oben korrigiert...

[frankthegreat]

Habe die Anleitung oben korrigiert...

Jepp...und läuft

Super Sache, danke nochmal für deine Anleitung. Klappt genauso, wie beschrieben.
Bei mir läuft allerdings kein Ubuntu, sondern ein Debian (Trixie). Geht aber auch.

KNX-NG-Monitor - Login.jpg

KNX-NG-Monitor - Aufzeichnung.jpg

[frankthegreat]

ingel81

Hey, finde dein Projekt super spannend und eine gelungene Erweiterung für KNX.
Bin ab sofort auch Tester und freue mich auf weitere Ergänzungen, obwohl es schon jetzt einen runden Eindruck macht.

Läuft bei mir unter Proxmox Debian (Trixie).
Dank ploetman und seiner tollen Anleitung.

[Taxus]

Frage zur Anwendung / Statistik:
v 0.12 läuft jetzt seit etwa 16 Tagen nonstop. Die <Datum>.ndjson.gz werden täglich geschrieben. Kein Fehlereintrag im log.
Einstellungen/Ringpuffer = default (1 Mio, Archiv unbegrenzt, Langzeit = ja).
Heute habe ich die Statistikseite aufgerufen / Auswahl 30 Tage. Geladen wurden knapp 4,5 Tage (das sind hier 1 Mio. Telegramme), egal, wie lange ich warte, egal, ob ich über Preset 7 Tage / 30 Tage wähle oder eine Datumseingrenzung (Bug: -> github) von Hand vorgebe.
Kann man Telegramme aus dem Archiv in der Statistik anzeigen lassen, oder ist das grundsätzlich auf den Ringpuffer beschränkt?

[ingel81]

Das ist aktuell auf den Ringpuffer beschränkt.

Das Archiv anzuladen kommt irgendwann aber ich kann noch nicht versprechen wann.

Eine Millionen in 4,5 Tagen ist ordentlich. Was ist das für ein Objekt interessehalber?

[Taxus]

Ok - Langzeit ist mein Interesse.-
Objekt ist unser EFH, normale Größe, (ohne Not) auf Telegrammsparsamkeit < 2 T/Sek getrimmt. War früher das doppelte - weil es eben geht.
Hauptsender sind die beiden Smartmeter (Enertex) und das Wiregate, außerdem haben wir einige Aktoren mit Stromwertmessung. Sensorseitig geht inzwischen einiges an Kommunikation über MQTT, was sonst via HS über Telegramme vermittelt wurde.

[ingel81]

KNX-NG-Monitor v0.13.1 ist da

Danke für das viele Feedback hier, einiges davon steckt direkt in diesem Release:

• SD-Karten schonen: Unter Einstellungen > Datenaufzeichnung kannst du "Verlauf schreiben" jetzt auf 5 s bis 10 min stellen. Die Telegramme werden dann gesammelt in einem Rutsch geschrieben statt jedes einzeln, die Live-Ansicht bleibt in Echtzeit. Standard ist weiter "sofort".
• Statistik deutlich schneller: Verlauf und Heatmap werden jetzt direkt in der Datenbank gezählt. Bei rund einer Million Telegrammen ist das etwa 7x schneller, auf dem Pi merkt man das am meisten.
• Top-Gruppenadressen: Neue Karte in der Statistik. Sie zeigt, welche GAs und welche Geräte im gewählten Zeitraum die meisten Telegramme erzeugen (Anzahl, Anteil, pro Stunde). Ein Klick springt ins Archiv, gefiltert auf genau diese GA.
• Docker-Rechte: Der Container übergibt ./data beim Start selbst an PUID/PGID (Standard 1000:1000) und läuft danach nicht als root. Das manuelle chown auf dem NAS entfällt, und statt einer leeren Login-Maske gibt es eine klare Meldung, wenn etwas mit den Rechten nicht stimmt.
• Tunnel-Optionen: TCP-Tunneling wählbar, automatischer Reconnect bei kurzen Aussetzern, feste Tunnel-Adresse mit Rückfall auf einen freien Slot, Hostname statt IP möglich. Wer eine wacklige WLAN-Strecke zum Router hat: TCP ausprobieren.
• Diagramme: jede Einheit auf eigener Achse, Tooltip mit allen Serien, GA-Auswahlen speichern, Live-Fenster läuft mit, Startwert vor dem Zeitraum, geglättete Kurve. Vieles davon kam als Beitrag aus der Community, danke!
• Kleinigkeiten: Datums- und Zeitfeld ohne sechsstellige Jahre, Datumsformat nach Browser-Einstellung, Heatmap-Woche beginnt auf Deutsch am Montag, Suche wortweise, / springt ins Suchfeld, die Version steht jetzt im Benutzermenü.

Unter der Haube läuft nun alles auf .NET 10. Update wie immer per Docker-Image oder Binary von GitHub, die Datenbank wird beim Start automatisch migriert.

Release: https://github.com/ingel81/knx-ng-mo...es/tag/v0.13.1

Rückmeldungen gerne hier oder als Issue.

[Noschvie]

Bei mir wird im GUI "Version 0.11.0" angezeigt, obwohl das neue Feature "Datumsformat nach Browser-Einstellung" verfügbar ist.

Siehe backend/KnxMonitor.Api/KnxMonitor.Api.csproj

Trotzdem ein Danke für die neue Release!

[ingel81]

Bei mir wird im GUI "Version 0.11.0" angezeigt, obwohl das neue Feature "Datumsformat nach Browser-Einstellung" verfügbar ist.

Siehe backend/KnxMonitor.Api/KnxMonitor.Api.csproj

Danke für den Hinweis! Die offiziellen Builds (Docker-Image und Binaries aus den GitHub-Releases) bekommen die Version beim Release aus dem Tag und zeigen korrekt 0.13.1. Wer selbst baut, bekommt den Wert aus der csproj, und der stand noch auf 0.11.0.

Ist korrigiert und wird ab jetzt bei jedem Release mitgezogen.