Was ist der Stream Monitor?
Der Stream Monitor ist ein umfassendes Überwachungstool, mit dem du die Gesundheit und Verfügbarkeit deines Audio-Streaming-Dienstes in Echtzeit verfolgen kannst. Der Monitor überprüft deinen Stream in regelmäßigen Abständen und erkennt automatisch Probleme wie Ausfälle, Stille und Qualitätsverlust.
Stream Monitor Dashboard
Der Stream Monitor ist als Add-on zu deinem Audio-Streaming-Paket verfügbar und wird in drei Abonnementstufen angeboten: Basic, Pro und Enterprise.
Abonnementstufen
Der Stream Monitor ist in drei Stufen verfügbar, jede mit mehr Funktionen:
Basic
- Prüfintervall: alle 5 Minuten
- Online/Offline-Statuserkennung
- Uptime-Statistiken (24 Stunden, 7 Tage, 30 Tage)
- E-Mail-Benachrichtigungen bei Ausfällen
- Vorfallhistorie
Pro
Alle Basic-Funktionen, plus:
- Prüfintervall: jede Minute
- Stille-Erkennung — erkennt, wenn dein Stream still ist (konfigurierbarer Schwellenwert)
- Metadaten-Überwachung — verfolgt, was gerade gespielt wird, und erkennt feststeckende Metadaten
- Erweiterte Vorfalltypen (Stille, Bitraten-Abfall, feststeckende Metadaten)
Enterprise
Alle Pro-Funktionen, plus:
- Prüfintervall: alle 30 Sekunden
- Multi-Mountpoint-Überwachung — überwache mehrere Mountpoints (z.B. main, mobile, fallback) gleichzeitig
- Webhook-Benachrichtigungen — empfange Echtzeit-Benachrichtigungen per Webhook mit HMAC-SHA256-Signierung
- Wartungsfenster — plane Zeiten, in denen Benachrichtigungen unterdrückt werden
Das Dashboard
Nach der Aktivierung findest du den Stream Monitor in deinem Dashboard unter Services > [Dein Streaming-Service] > Verwalten > Stream Monitor.
Statusseite
Die Hauptseite zeigt eine Übersicht deines Streams:
- Aktueller Status — Online, Offline, Still, Degradiert oder Fehler
- Protokoll — Shoutcast oder Icecast
- Abonnementstufe — Basic, Pro oder Enterprise
- Letzte Prüfung — Zeitpunkt der letzten Überprüfung
- Uptime-Prozentsätze — Verfügbarkeit über 24 Stunden, 7 Tage und 30 Tage
Prüfverlauf
Eine visuelle Zeitleiste zeigt die Ergebnisse der letzten Prüfungen. Jede Prüfung erfasst:
- Status (online/offline/still/degradiert/fehler)
- Antwortzeit in Millisekunden
- Bitrate (kbps)
- Audiopegel (dB)
- Aktueller Titel (Künstler und Titel)
- Anzahl der Zuhörer
- AutoDJ-Status
Aktive Vorfälle
Wenn ein Problem erkannt wird, erscheint ein Vorfall im Dashboard. Vorfälle enthalten:
- Typ — offline, Stille, Bitraten-Abfall, feststeckende Metadaten, AutoDJ-Übernahme, hohe Latenz
- Schweregrad — Warnung oder Kritisch
- Startzeit und Dauer
- Beschreibung des Problems
Du kannst Vorfälle bestätigen, um anzuzeigen, dass du davon Kenntnis hast.
Benachrichtigungen Einrichten
E-Mail-Benachrichtigungen
Standardmäßig werden Benachrichtigungen an die E-Mail-Adresse deines Kontos gesendet. Du kannst dies anpassen:
- Gehe zu Stream Monitor > Einstellungen
- Aktiviere Benachrichtigungen
- Gib eine Benachrichtigungs-E-Mail-Adresse ein
- Stelle die Abkühlzeit ein (Standard: 15 Minuten) — dies verhindert, dass du mit Benachrichtigungen überflutet wirst
Webhook-Benachrichtigungen (Enterprise)
Für erweiterte Integrationen kannst du Webhook-Benachrichtigungen einrichten:
- Gehe zu Stream Monitor > Einstellungen
- Gib deine Webhook-URL ein
- Webhooks werden mit einer HMAC-SHA256-Signatur im
X-Maenda-Signature-Header gesendet
Webhook-Payload-Beispiel:
{
"event": "incident.offline",
"timestamp": "2025-02-25T12:00:00Z",
"monitor": {
"id": "mon_123",
"serviceId": "svc_456",
"streamUrl": "https://stream.example.nl:8000/live",
"tier": "enterprise"
},
"incident": {
"id": "inc_789",
"type": "offline",
"severity": "critical",
"status": "active",
"startedAt": "2026-02-25T12:00:00Z",
"description": "Stream ist nicht erreichbar"
},
"check": {
"status": "offline",
"responseTimeMs": 10000,
"bitrate": null,
"audioLevelDb": null,
"isSilent": false,
"nowPlaying": null
}
}
Webhook-Events:
incident.{type}— neuer Vorfall erkannt (z. B.incident.offline,incident.silence)incident.resolved.{type}— Vorfall gelöst (z. B.incident.resolved.offline)
Jeder Webhook enthält außerdem die Header X-Maenda-Event (Name des Events) und X-Maenda-Signature (die HMAC-SHA256-Signatur).
Der Webhook versucht bei fehlgeschlagener Zustellung bis zu 3 Mal mit zunehmender Verzögerung (1s, 5s, 15s).
Schutz vor Fehlalarmen
Ein kurzer Aussetzer ist nicht zwangsläufig eine Störung. Deshalb erstellt der Monitor einen Offline-Vorfall erst nach mehreren aufeinanderfolgenden fehlgeschlagenen Checks (einstellbar). So werden Fehlalarme durch einen einmaligen Ausschlag vermieden, während eine echte Störung dennoch schnell gemeldet wird. Die einzelnen Checks werden immer erfasst, damit deine Uptime-Zahlen korrekt bleiben.
Stille-Erkennung (Pro & Enterprise)
Die Stille-Erkennung erkennt, wenn dein Stream technisch online ist, aber kein Audio sendet. Dies ist für Radio-Streams essenziell, bei denen Stille ein ernstes Problem darstellen kann.
Wie es funktioniert
Der Monitor analysiert 32KB Audiodaten von deinem Stream und berechnet:
- Byte-Varianz — wie abwechslungsreich die Audiodaten sind
- Shannon-Entropie — Informationsgehalt des Audiosignals
- dB-Pegel — geschätzter Lautstärkepegel (RMS und Spitze)
Stille wird erkannt, wenn die Byte-Varianz unter 50 liegt UND die Entropie unter 5,0 Bits.
Schwellenwerte Anpassen
- Gehe zu Stream Monitor > Einstellungen
- Passe den Stille-Schwellenwert an (Standard: -50 dB)
- Stelle die Stille-Dauer ein (Standard: 30 Sekunden) — wie lange Stille andauern muss, bevor ein Vorfall erstellt wird
Multi-Mountpoint-Überwachung (Enterprise)
Wenn dein Stream mehrere Mountpoints hat (z.B. /live, /mobile, /fallback), kannst du sie alle gleichzeitig überwachen.
Einrichtung
- Gehe zu Stream Monitor > Einstellungen
- Füge deine Mountpoints als Liste hinzu
- Jeder Mountpoint wird einzeln überprüft
- Vorfälle werden pro Mountpoint verfolgt
Wartungsfenster (Enterprise)
Plane Zeiträume, in denen Benachrichtigungen unterdrückt werden, z.B. während geplanter Wartung oder nächtlicher Tests.
Einrichtung
- Gehe zu Stream Monitor > Wartungsfenster
- Wähle den Tag (Montag bis Sonntag)
- Stelle die Start- und Endzeit ein
- Während der Wartungsfenster werden keine Benachrichtigungen gesendet, aber Prüfungen laufen normal weiter
Unterstützte Protokolle
Der Stream Monitor unterstützt die beiden am häufigsten verwendeten Streaming-Protokolle:
Shoutcast
- Vollständig unterstützt mit ICY-Metadaten
- Automatische Zuhörer-Erkennung über die Statistikseite
- AutoDJ-Erkennung
Icecast
- Vollständig unterstützt mit ICY-Metadaten
- Unterstützung für mehrere Mountpoints
- Metadaten-Parsing für aktuell-gespielt-Information
Beide Protokolle unterstützen:
- HTTPS/TLS-Verbindungen
- Automatische Redirect-Verfolgung
- Bitraten-Erkennung über ICY-Header
- Künstler- und Titelinformation
Vorfalltypen
Der Stream Monitor kann die folgenden Probleme erkennen:
| Typ | Beschreibung | Mindeststufe |
|---|---|---|
| Offline | Stream ist nicht erreichbar | Basic |
| Stille | Audio ist still (unter Schwellenwert) | Pro |
| Bitraten-Abfall | Bitrate ist niedriger als erwartet | Pro |
| Feststeckende Metadaten | Gleicher Titel wird zu lange angezeigt | Pro |
| AutoDJ-Übernahme | AutoDJ hat übernommen (Live-DJ ausgefallen) | Pro |
| Hohe Latenz | Antwortzeit ist ungewöhnlich hoch | Basic |
Uptime-Statistiken
Der Stream Monitor berechnet automatisch Uptime-Prozentsätze:
- 24 Stunden — Verfügbarkeit des letzten Tages
- 7 Tage — Verfügbarkeit der letzten Woche
- 30 Tage — Verfügbarkeit des letzten Monats
Diese Prozentsätze werden basierend auf der Anzahl erfolgreicher Prüfungen im Verhältnis zur Gesamtzahl der Prüfungen berechnet. Wartungsfenster werden von der Berechnung ausgeschlossen.
Häufig Gestellte Fragen
Wie schnell werde ich bei einem Ausfall benachrichtigt?
Das hängt von deiner Abonnementstufe ab:
- Basic: maximal 5 Minuten
- Pro: maximal 1 Minute
- Enterprise: maximal 30 Sekunden
Kann ich den Stream Monitor ohne Streaming-Paket nutzen?
Nein, der Stream Monitor ist ein Add-on, das an ein bestehendes Audio-Streaming-Paket bei Maenda Media gekoppelt ist.
Was passiert während eines Wartungsfensters?
Prüfungen werden weiterhin durchgeführt und aufgezeichnet, aber es werden keine Benachrichtigungen gesendet. Vorfälle werden dennoch für die Dokumentation erstellt.
Wie überprüfe ich die Webhook-Signatur?
Der Webhook enthält einen X-Maenda-Signature-Header im Format sha256=<hex>. Berechne den HMAC-SHA256 des Request-Bodys mit deinem geheimen Schlüssel und vergleiche ihn mit dem Wert im Header.
Kann ich historische Daten exportieren?
Ja, über die Stream-Statistiken-Seite kannst du Daten als CSV oder PDF exportieren. Dies umfasst Zuhörerzahlen, Bandbreite und Spitzen über den ausgewählten Zeitraum.
Erkennt der Monitor auch Videoprobleme?
Nein, der Stream Monitor ist speziell für Audio-Streams (Shoutcast/Icecast) konzipiert. Video-Streaming hat ein separates Statistik-Panel.