- Python 100%
|
|
||
|---|---|---|
| .gitignore | ||
| arista.env.example | ||
| bolero_ptp_monitor.py | ||
| CLAUDE.md | ||
| ntfy.env.example | ||
| README.md | ||
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 &