KH-Statistiken mischen momentane Zustände, aufsummierte Ereignisse und Raten. Ähnliche Namen bedeuten weder gleiche Einheiten noch gleiche Lebensdauer. Ordnen Sie ein Feld seinem globalen oder mountbezogenen Bereich zu, bevor Sie daraus Alarme ableiten.
Einen eingegrenzten Stand abrufen
Administrations-XML ist die dokumentierte Prüfschnittstelle. Dieses lesende Beispiel speichert einen privaten Stand. Dienst und Testkonto müssen bereits eingerichtet sein:
umask 077
curl --fail --silent --show-error --user admin 'https://stream.example.org/admin/stats?mount=%2Flive.ogg' --output kh-stats.xmlVeröffentlichen Sie die Datei nicht. Ein öffentliches Stylesheet kann eine andere Teilmenge zeigen als authentifiziertes XML. Übertragen Sie weder JSON-Endpunkt noch Schema von regulärem Icecast ungeprüft auf diesen KH-Stand.
Bedeutung und Bereich zusammenhalten
| Feld | Bedeutung im festgelegten Quellstand | Konsequenz für die Auswertung |
|---|---|---|
Globales listeners | Regelmäßig aktualisierte aktuelle Hörerzahl | Momentanwert; null kann gewollt sein |
Globales clients | Aktuelle Clients einschließlich weiterer Verbindungen | Nicht mit Audiohörern gleichsetzen |
connections | Wird beim Annehmen einer Verbindung erhöht | Aufsummierte Aktivität, keine Reichweite |
listener_connections | Hörer-Verbindungsereignisse; global und am Mount | Erneute Verbindungen zählen erneut |
source_client_connections | Verbindungsereignisse von Source-Clients | Keine Zahl gleichzeitiger Quellen |
source_relay_connections | Verbindungsereignisse von Relay-Quellen | Zusammen mit Wiederholungen auswerten |
outgoing_kbitrate | Ratenberechnung mit Umrechnung über 1024 | Implementierungseinheit festhalten |
stream_kbytes_sent | Aufsummierte übertragene Streamdaten | Neustartfeste Differenzen statt Momentanrate |
server_start | Startzeit des Servers | Neuen Beobachtungszeitraum erkennen |
Das alte Handbuch ist eine historische Orientierung und kein vollständiger Feldkatalog des späteren Codes. Fehlende, verborgene oder formatspezifische Felder bleiben im auswertenden Programm „nicht verfügbar“. Null würde eine Beobachtung erfinden.
Mehrere Beobachtungen zusammenführen
Erfassen Sie den Ausgangszustand, verbinden und trennen Sie einen Testhörer und vergleichen Sie XML sowie Logs. Prüfen Sie anschließend Source-Neuverbindung und Prozessneustart. Halten Sie zurückgesetzte Reihen fest. Differenzen sind nur zwischen vergleichbaren Ständen sinnvoll; rechnen Sie nicht über Neustarts oder administrative Rücksetzungen hinweg. Die Bedeutungen wurden an Aktualisierungsstellen im Code geprüft. Die beschriebene Beobachtungsfolge benötigt weiterhin eine laufende isolierte Instanz.