No description
Find a file
2026-11-09 11:44:02 +01:00
.gitignore feat: Bolero-PTP-Monitor (Stand sacn-bridge 26.10.2026) 2026-10-26 21:02:46 +01:00
arista.env.example feat: Bolero-PTP-Monitor (Stand sacn-bridge 26.10.2026) 2026-10-26 21:02:46 +01:00
bolero_ptp_monitor.py feat: Beltpack-Log je Antenne, Soll-Liste und Meldung fehlender Antennen 2026-11-09 09:45:39 +00:00
CLAUDE.md docs: CLAUDE.md mit Arbeitsweise (hier ändern, auf sacn-bridge nur pull) 2026-11-09 11:44:02 +01:00
ntfy.env.example feat: Bolero-PTP-Monitor (Stand sacn-bridge 26.10.2026) 2026-10-26 21:02:46 +01:00
README.md feat: Beltpack-Log je Antenne, Soll-Liste und Meldung fehlender Antennen 2026-11-09 09:45:39 +00:00

bolero-monitor

Überwacht PTP und Zustand des Riedel-Bolero-Intercoms der Staatsoper (32 Antennen, VLAN 121) samt Netz darunter (Luminex GigaCores, Arista-Core) und schickt wichtige Ereignisse gebündelt an ntfy (ntfy.stellwerk.cloud, Topic inspi-clock). Läuft auf sacn-bridge unter /root/bolero-monitor.

Nur lesende Zugriffe, nur Python-Standardbibliothek.

Was überwacht wird

Quelle Takt Was
Bolero /rest/nodeStatus über 3 Beobachter-Antennen 1 s PTP-Lock/Port/GM, Funk an/aus, DECT-Master, Antenne weg/da, Offset
Luminex GigaCores (REST, ohne Login) 5 s, BG-04 (.31/.32) 1 s / 2 s PTP-Boundary-Clock (Lock, Slave-Port, Unlocks), Port-Zähler
Arista-Core (eAPI oder SSH) 2 s / 5 s show ptp, Discards, Errors, Spanning Tree

Alles landet in data/events.log, bei Ereignissen zusätzlich 30 s Rohdaten davor und danach in data/snapshots/. Benachrichtigt werden PTP- und Funkwechsel, Geräte, Switch-/Core-PTP und Erreichbarkeit (nicht: normale Port-Discards der GigaCores).

Fehlt eine Antenne aus BOLERO_ANTENNAS (Soll-Liste im Skript, Name -> IP) länger als 15 min bei allen erreichbaren Beobachtern, kommt eine Meldung, danach alle 4 h eine Erinnerung und eine Meldung, wenn sie wieder da ist. Die Liste steht fest im Skript, weil eine ausgefallene Antenne auch aus /rest/nodeConfig verschwindet. Neue oder ersetzte Antennen dort eintragen; Antennen, die nicht in der Liste stehen, meldet der Monitor einmal im events.log. Der Heartbeat (OK …, jede Minute) zählt nur Antennen, die der Beobachter gerade sieht, und nennt fehlende unter fehlt:.

Beltpack-Log

Jede volle Minute (BP_LOG_INTERVAL) schreibt der Monitor je Antenne eine Zeile nach data/beltpacks/beltpacks-JJJJ-MM-TT.csv (eine Datei pro Tag, Semikolon-getrennt, UTF-8):

Spalte Inhalt
zeit ISO 8601 mit UTC-Offset, z. B. 2026-11-09T10:01:00+01:00
antenne Name aus /rest/nodeConfig
ip IP der Antenne
anzahl verbundene Beltpacks an dieser Antenne
beltpacks deren Namen (aus /rest/bp, alle 10 min neu geladen; unbekannt = #<id>)

Welcher Beltpack an welcher Antenne hängt, steht in /rest/audioPorts (Port-Typ 1 = Beltpack, nodeId = Antenne; so zeigt es auch die Web-UI), einmal pro Minute von allen Beobachtern abgefragt. Nicht nodeStatus[].bp: das ist die Liste aller verbundenen Beltpacks im Netz (Akku, Signal, Timeslots) und steht nur bei einer Antenne. Die Antennenliste kommt aus /rest/nodeStatus; ist kein Beobachter erreichbar, fehlen die Zeilen: Lücke statt falscher Null.

# Höchstlast je Antenne an einem Tag
awk -F';' 'NR>1 && $4>m[$2]{m[$2]=$4} END{for(a in m) print m[a]"\t"a}' \
    data/beltpacks/beltpacks-2026-11-09.csv | sort -rn

Dateien

Datei Zweck
bolero_ptp_monitor.py der Monitor (Konfiguration oben im Skript)
ntfy.env.example Vorlage für ntfy.env (chmod 600)
arista.env.example Vorlage für arista.env (chmod 600)

Betrieb

python3 bolero_ptp_monitor.py --once        # einmal abfragen, Übersicht
python3 bolero_ptp_monitor.py --test-ntfy   # Testnachricht

# im Hintergrund (Zeitzone wie bisher):
pkill -f 'python3 bolero_ptp_monitor.py'; sleep 3
TZ=Europe/Berlin setsid nohup python3 bolero_ptp_monitor.py >> monitor.out 2>&1 < /dev/null &

Netz (von sacn-bridge 172.16.10.11 aus)

  • Bolero-Antennen 10.121.1.x: HTTP (Lese-Login der Web-UI)
  • GigaCores 10.100.0.11–34: HTTP
  • Arista 10.100.0.3: HTTPS eAPI (ACL EAPI-MON, nur 172.16.10.11)
  • ntfy.stellwerk.cloud: HTTPS (Cloudflare-Regel "ntfy ohne Browser Integrity Check")

Aktualisieren auf sacn-bridge

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

cd /root/bolero-monitor
git pull
pkill -f 'python3 bolero_ptp_monitor.py'; sleep 3
TZ=Europe/Berlin setsid nohup python3 bolero_ptp_monitor.py >> monitor.out 2>&1 < /dev/null &