Wenn ein Player den Stream nicht öffnen kann, kommen mehrere Ursachen infrage: Icecast läuft nicht, die Quelle fehlt, der Zugriff wird abgelehnt oder das Format passt nicht. Notieren Sie die betroffene URL und den Zeitpunkt. Prüfen Sie dann nacheinander Server, Quelle und Wiedergabe.
Symptom und erste Prüfung zuordnen
| Symptom | Erste Prüfungen |
|---|---|
| Prozess startet nicht | XML-Syntax, belegter Socket, Pfade und Bibliotheken |
| Statusseite funktioniert, Mount fehlt | Encoder-Ausgabe, Source-Zugangsdaten, Source-Limit |
| 401 oder 403 | Vorgesehenes Konto und Authentifizierungsregel des Mounts |
| 404 beim Streamabruf | Exakter Pfad, aktive Quelle, Alias-/Fallback-Ziel |
| Aussetzer bei allen Hörern | Quellenkontinuität und Zuführung |
| Abbruch eines einzelnen Hörers | Dessen Netzwerkpfad, Rückstand und Slow-Listener-Werte |
| Defekte Titelzeichen | Quellzeichensatz und Metadatenweg |
error.log enthält Serverentscheidungen und Fehler. access.log zeichnet Zugriffe und Verbindungen auf. Das optionale Playlistlog hält Metadaten fest und ist keine hörbare Aufnahme. Logs können Adressen, User-Agents und Abrufpfade enthalten. Begrenzen Sie den Zugriff und geben Sie nur bereinigte Auszüge weiter.
Ein kurzes Diagnosefenster öffnen
Das mit 2.5.0 gelieferte Beispiel verwendet Namen wie information und debug. Ältere Handbücher nutzen Zahlen. Für eine zeitlich begrenzte Diagnose können Sie im vorhandenen <logging>-Block setzen:
<loglevel>debug</loglevel>Wiederholen Sie einen konkreten Fehler, notieren Sie die Zeit und stellen Sie anschließend die vorgesehene geringere Stufe wieder her. Debug-Ausgaben wachsen schnell. Bewahren Sie relevante Startmeldungen auf, da sie gestartetes Programm und Konfigurationsprobleme benennen.
Logrotation einrichten
logsize und logarchive steuern die dokumentierte interne Rotation. Ein überschriebenes .old-Archiv und aufgehobene Archive mit Zeitstempel haben unterschiedliche Speicherfolgen. Benennt ein externes Rotationswerkzeug Dateien um, verwenden Sie den unterstützten Weg zum Wiederöffnen beziehungsweise Neuladen. Das Löschen einer offenen Datei gibt Speicher nicht zwangsläufig wie erwartet frei.
Sichern Sie die funktionierende Konfiguration vor der Diagnose. Prüfen Sie XML mit xmllint --noout --nonet und danach Start- oder Reloadmeldungen. Ändern Sie jeweils einen Wert und vergleichen Sie die Beobachtungen. Ein stilles Fehlerlog beweist kein gutes Audio. Abschließend folgen deshalb Quelle und echte Wiedergabe.