Eine gescheiterte Anfrage bedeutet nicht automatisch einen ausgefallenen Stream. Klären Sie zuerst, ob Source-Upload, Relay-Abruf, Höreranfrage, Stylesheet oder Verwaltungsaktion betroffen sind. Diese Wege verwenden unterschiedliche Zugangsdaten und Dateien.
Zuerst die Dateipfade auflösen
basedir, webroot, adminroot und logdir bezeichnen verschiedene Orte. Ein fehlendes Stylesheet unter adminroot kann die sichtbare Administration stören, obwohl die XML-Operation funktioniert. Eine lesbare Mediendatei im webroot kann öffentlich werden. Konfiguration, Benutzerdateien und Zertifikate gehören dorthin nicht.
KH-Aliase verwenden source und dest. Dieser Ausschnitt gehört in den vorhandenen <paths>-Block. Reguläres Icecast 2.5 verwendet hier dagegen destination:
<alias source="/listen" dest="/live.ogg"/>Prüfen Sie Dateirechte mit der Dienstidentität. Bei chroot sind Pfade innerhalb dieser Umgebung aufzulösen und benötigte Hilfsdateien bereitzustellen. Eine für den Shell-Benutzer vorhandene Datei kann für den Dienst unerreichbar sein.
Ausreichend protokollieren und danach reduzieren
Die klassischen numerischen KH-Fehlerstufen reichen von 0 bis 4. Mit höherer Stufe kommen Warnungen sowie Informations- und Debugdetails hinzu. Die mitgelieferte Konfiguration verwendet 3; 4 ergänzt Debugdetails. Dieses vollständige Beispiel eines Logging-Blocks benötigt einen schreibbaren logdir:
<logging>
<accesslog>access.log</accesslog>
<errorlog>error.log</errorlog>
<loglevel>3</loglevel>
<logsize>10000</logsize>
<logarchive>1</logarchive>
</logging>logsize wird in dieser klassischen Form in Kilobyte angegeben. Der festgelegte Parser akzeptiert außerdem verschachtelte Logdefinitionen wie name und size. Mischen Sie die Varianten nicht ohne Prüfung ihrer Vorrangregeln. skip-accesslog am Mount unterdrückt neben Datenmenge auch Diagnosebelege. Begrenzen und schützen Sie Logs: Höreradressen und sensible Abfrageparameter können darin stehen.
Einen Fehler durch die Schichten verfolgen
| Symptom | Erste unterscheidende Prüfung |
|---|---|
| Source abgelehnt | Mount-Zuordnung, Source-Zugang, bestehende Quelle und Hijack-Regel |
| Relay verbindet ständig neu | Antwort, Zugang, Format und Wiederholungsintervall der Quelle |
| Hörer abgelehnt | Ausgewählte Mount-Regel und Antwort der Hörerprüfung |
| Audio stockt | Quellstabilität, Rate, Queue/Burst und Playerdekodierung |
| Verwaltungsansicht fehlerhaft | Authentifiziertes XML gegenüber XSLT-Datei und Dateipfad |
Notieren Sie Zeitpunkt, URL, Status und passendes Source- oder Logereignis. Entfernen Sie Geheimnisse vor dem Teilen. Ändern Sie jeweils eine Variable und stellen Sie die normale Logstufe anschließend wieder her. Keines der beispielhaften Fehlerbilder wird als beobachtetes Laufzeitergebnis ausgegeben.