- Python 88.6%
- Shell 11.4%
|
|
||
|---|---|---|
| legacy | ||
| qrc | ||
| systemd | ||
| .gitignore | ||
| CLAUDE.md | ||
| ntfy.env.example | ||
| qsys_monitor.py | ||
| README.md | ||
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