No description
  • Python 88.6%
  • Shell 11.4%
Find a file
2026-11-09 11:44:04 +01:00
legacy feat: Q-SYS-Monitor (QRC + SNMP + Amps + Moxa) 2026-10-26 21:02:46 +01:00
qrc feat: Q-SYS-Monitor (QRC + SNMP + Amps + Moxa) 2026-10-26 21:02:46 +01:00
systemd feat: Q-SYS-Monitor (QRC + SNMP + Amps + Moxa) 2026-10-26 21:02:46 +01:00
.gitignore feat: Q-SYS-Monitor (QRC + SNMP + Amps + Moxa) 2026-10-26 21:02:46 +01:00
CLAUDE.md docs: CLAUDE.md mit Arbeitsweise (hier ändern, auf sacn-bridge nur pull) 2026-11-09 11:44:04 +01:00
ntfy.env.example feat: Q-SYS-Monitor (QRC + SNMP + Amps + Moxa) 2026-10-26 21:02:46 +01:00
qsys_monitor.py feat: Q-SYS-Monitor (QRC + SNMP + Amps + Moxa) 2026-10-26 21:02:46 +01:00
README.md docs: Aktualisieren auf sacn-bridge per git pull 2026-10-26 21:27:24 +01:00

qsys-watcher

Überwacht den Q-SYS-Core der Staatsoper (Core 610, redundant, Design X-Stage_HSO) und schickt Zustandswechsel gebündelt an ntfy (ntfy.stellwerk.cloud, Topic inspi-qsys). Läuft auf sacn-bridge unter /root/qsys-watcher als systemd-Dienst qsys-monitor.

Nur lesende Zugriffe. Python-Standardbibliothek plus net-snmp (snmpbulkwalk, snmpget).

Was überwacht wird

Quelle Takt Was
QRC (TCP 1710, Core 10.100.1.101) Push Core-Zustand, Redundanz, Design; Status aller benannten Plugins; script.status / script.error.count aller Skripte; AllMute / EvacPaging der AdamController
SNMP-Inventar des Cores 2 s Stränge (Loudspeaker), Amps, I/O, UCI-Viewer …
CX-Q-Amps direkt (https://<amp>/cgi-bin/status_xml) 10 s Fehler, Zustand, Neustart, Link, Netzwerkfehler, Switch-Port (LLDP)
Moxa NPort 5650-16 (SNMP) 10 s erreichbar, Neustart, Core-Verbindung je Port 4001–4016 (Relais der 100-V-Linien per RS-485)

Gegen Fehlalarme: fehlende SNMP-Einträge zählen nicht, OK ist immer OK (Zusatzinfos wie Uptime/Strom werden ignoriert), Initializing wird übersprungen, Plugins nur nach Zustandsklasse, Filter für No clients connected / Enter IP Address, Flatter-Bremse, höchstens 30 Nachrichten pro Stunde. Einstellungen oben in qsys_monitor.py.

Dateien

Datei Zweck
qsys_monitor.py der Monitor
ntfy.env.example Vorlage für ntfy.env (Token, chmod 600)
systemd/qsys-monitor.service Dienst-Datei (/etc/systemd/system/)
qrc/qrc_inventory.py Bestandsaufnahme aller Components/Controls → qrc/discovery.json
qrc/qrc_discover.py, qrc/list_all_components.py ältere QRC-Hilfsskripte
legacy/ alter Bash/SNMP-Monitor (bis 15.09.2026, Topic inspi-strom), deaktiviert

Betrieb

python3 qsys_monitor.py --once        # einmal abfragen, Übersicht, nichts senden
python3 qsys_monitor.py --test-ntfy   # Testnachricht
systemctl restart qsys-monitor        # nach Änderungen
tail -f data/events.log               # Log, jede Minute eine Statuszeile

Installation auf einem neuen Host:

cp systemd/qsys-monitor.service /etc/systemd/system/
cp ntfy.env.example ntfy.env && chmod 600 ntfy.env   # Token eintragen
systemctl daemon-reload && systemctl enable --now qsys-monitor

Netz (von sacn-bridge 172.16.10.11 aus freigegeben)

  • Core 10.100.1.101: TCP 1710 (QRC), UDP 161 (SNMP)
  • Amps 10.111.0.163–169: TCP 443
  • Moxa 10.111.0.161: UDP 161
  • ntfy.stellwerk.cloud: HTTPS (Cloudflare blockt den User-Agent Python-urllib, der Monitor sendet einen eigenen)

Grenzen

  • Temperatur, Clip, Limiter der Amps gibt es nur über den Core, wenn die Amp-Components im Designer auf Script Access: External stehen.
  • Ob ein einzelnes Relais-Modul hinter dem Moxa antwortet, meldet das Design nicht (AdamController haben keinen Status).

Aktualisieren auf sacn-bridge

/root/qsys-watcher ist ein Klon dieses Repos (HTTPS, öffentlich). Zugangsdaten (*.env) und Laufzeitdaten sind per .gitignore ausgenommen.

cd /root/qsys-watcher
git pull
systemctl restart qsys-monitor