Referenz

Statistiken und Zähler richtig interpretieren

Unterscheiden Sie aktuelle Hörer und aufsummierte Verbindungen. Verarbeiten Sie XML oder JSON belastbar und prüfen Sie den tatsächlichen Stream.

Auf dieser Seite

Ein steigender Verbindungszähler bedeutet keine wachsende Hörerschaft. Icecast liefert aktuelle Messwerte und aufsummierte Zähler mit unterschiedlichen Lebensdauern. Benennen Sie Messwert, Geltungsbereich und Rücksetzbedingung, bevor Sie eine Anzeige auswerten.

Geltungsbereich und Lebensdauer zusammen lesen

FeldEinordnung
Globales listenersDerzeit aktive Hörerverbindungen
listener_connectionsHörer-Verbindungsaufbauten seit dem Start
clientsAktuelle Client-Verbindungen verschiedener Arten
connectionsAufsummierte eingehende TCP-Verbindungen
sourcesAktuell aktive Quellen
server_start_iso8601Startzeit des Servers
listeners im MountAktuelle Hörer dieses Streams
listener_peak im MountHöchste gleichzeitige Hörerzahl dieser Quellenlaufzeit
total_bytes_read / total_bytes_sentByte-Zähler im Quellenbereich
stream_start_iso8601Beginn der aktuellen Quellenverbindung
slow_listenersFür die Quelle ausgewiesener Zähler langsamer Hörer

Quellenbezogene Werte können bei Trennung oder Wiederverbindung zurückgesetzt werden. Ein Prozessneustart setzt serverbezogene Zähler zurück. Ein kleinerer Zähler nach einem Neustart ist als Rücksetzung und nicht als negativer Datenverkehr zu behandeln. Vergleichen Sie bit/s, kbit/s und Bytes nur nach Umrechnung.

Eine Datenschnittstelle wählen

sh · Codebeispiel
curl --fail --show-error --user admin http://127.0.0.1:8000/admin/stats
curl --fail --show-error http://127.0.0.1:8000/status-json.xsl

Der erste lokale Abruf liefert angemeldetes XML, der zweite die öffentliche JSON-Ansicht, sofern eingerichtet. Die öffentliche Ansicht enthält weniger als die Verwaltungsdaten. Felder können je nach Medienformat und Zustand fehlen. Ein Verbraucher muss fehlende Quellen sowie gegebenenfalls einzelne Source-Objekte oder Source-Sammlungen der gelieferten Darstellung verarbeiten.

Verwenden Sie die lesbare HTML-Statusseite nicht durch Scraping als API. Nutzen Sie dokumentiertes XML/JSON oder eine bewusst gepflegte XSLT-Transformation. Prüfen Sie den Antworttyp und parsen Sie sicher. Quellenseitig gelieferte Titel dürfen nicht ungefiltert in HTML gelangen.

Den Medienweg überwachen

Betrachten Sie Servererreichbarkeit, erwartete Quelle, wiederholte Quellenabbrüche und Hörerauslieferung getrennt. Ein erreichbarer JSON-Endpunkt kann mit einer fehlenden Quelle zusammenfallen. Vergleichen Sie in einem kontrollierten Test die Statistik mit einer echten Playerverbindung. Beenden Sie diese und beobachten Sie den passenden aktuellen Messwert. Eine einzelne Hörerzahl belegt keine kontinuierlich hörbare Wiedergabe.

Quellen