Stream Monitor: deinen Audiostream überwachen

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:

1. Gehe zu Stream Monitor > Einstellungen
2. Aktiviere Benachrichtigungen
3. Gib eine Benachrichtigungs-E-Mail-Adresse ein
4. 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:

1. Gehe zu Stream Monitor > Einstellungen
2. Gib deine Webhook-URL ein
3. Webhooks werden mit einer HMAC-SHA256-Signatur im X-Maenda-Signature-Header gesendet

Webhook-Payload-Beispiel:

{
  "event": "incident_created",
  "timestamp": "2025-02-25T12:00:00Z",
  "monitor": {
    "id": "mon_123",
    "serviceId": "svc_456",
    "streamUrl": "https://stream.example.nl:8000/live",
    "tier": "enterprise"
  },
  "incident": {
    "type": "offline",
    "severity": "critical",
    "description": "Stream ist nicht erreichbar"
  },
  "check": {
    "status": "offline",
    "responseTimeMs": 10000,
    "bitrate": null,
    "isSilent": false,
    "nowPlaying": null
  }
}

Webhook-Events:

• incident_created — neuer Vorfall erkannt
• incident_resolved — Vorfall gelöst
• check_failed — einzelne Prüfung fehlgeschlagen

Der Webhook versucht bei fehlgeschlagener Zustellung bis zu 3 Mal mit zunehmender Verzögerung (1s, 5s, 15s).

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

1. Gehe zu Stream Monitor > Einstellungen
2. Passe den Stille-Schwellenwert an (Standard: -50 dB)
3. 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

1. Gehe zu Stream Monitor > Einstellungen
2. Füge deine Mountpoints als Liste hinzu
3. Jeder Mountpoint wird einzeln überprüft
4. 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

1. Gehe zu Stream Monitor > Wartungsfenster
2. Wähle den Tag (Montag bis Sonntag)
3. Stelle die Start- und Endzeit ein
4. 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:

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.