Dieses Handbuch bezieht sich auf die Protokolldaten von Infomaniak Streaming Radio, die mithilfe des FTP-Protokolls exportiert werden können. Diese Protokolldaten (aus denen auch die Zuhörstatistiken nach der „Bereinigung“ oder „Aufbereitung“ gewonnen werden) werden dann automatisch per FTP übertragen, um anschließend verarbeitet zu werden.

Einleitung

• Die Protokolldateien Ihres Radiosenders werden als komprimierte Datei xyz.mp3-20140805.log.gz bereitgestellt (das Datum im Protokoll hat das Format YYYYMMDD).
• Jedes Protokoll beginnt um 04:00 Uhr Schweizer Zeit und endet um 03:59:59 Uhr am folgenden Tag.
• Das Logformat lautet ip user-identifier authuser [datum-uhrzeit] "anfrage" status bytes "referer" "useragent" listening-time:

  • 81.56.215.98 - - [09/Apr/2019:08:23:18 +0200] "GET /toto.mp3 HTTP/1.1" 200 1211297 "-" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.0.8) Gecko/2019032711 Ubuntu/8.10 (intrepid) Firefox/3.0.8" 69

  • Es kann vorkommen, dass eine Logzeile fehlerhaft formatiert ist, beispielsweise aufgrund eines zu langen Referers; dieses Verhalten von Icecast kann nicht geändert werden.
• Die Adressen im IP-Bereich 84.16.67.128/25 sollten ignoriert werden, da es sich um Streaming-Server handelt.
• Auf der Einstellungsseite im Manager können Sie die Protokolle der vergangenen Tage erneut anfordern.
• Sie können diese auch direkt zu ACPM oder Mediapulse exportieren.

Die Übertragung von Protokolldateien per FTP aktivieren

Gehen Sie dazu wie folgt vor:

1. Klicken Sie hier, um die Verwaltung Ihres Produkts im Infomaniak Manager aufzurufen (Benötigen Sie Hilfe?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts.
3. Klicken Sie auf den Namen des betreffenden Audio-Streams.
4. Klicken Sie im linken Menü auf Einstellungen.
5. Aktivieren Sie den Export der Protokolldateien per FTP mit dem Schalter.
6. Geben Sie einen Hostnamen ein: Adresse des FTP-Servers.
7. Geben Sie einen Benutzernamen ein: der Name des FTP-Kontos.
8. Geben Sie ein Passwort ein: das Passwort des FTP-Kontos.
9. Geben Sie das Verzeichnis auf dem Server ein, in dem die Protokolldateien gespeichert werden sollen.
10. Klicken Sie auf die Schaltfläche Speichern am unteren Rand der Seite:
    

Protokolldateien verarbeiten

Am besten verwendet man einen regulären Ausdruck wie den folgenden:

"/^(\S+)\s(.+)\s(\S+)?\s\[((\d\d)\/([a-zA-Z]{3,3})\/(\d\d\d\d)\:(\d\d)\:(\d\d)\:(\d\d)\s\+\d\d\d\d)\]\s"GET\s\/([\-a-z0-9]{1,40}(\.)?(mp3|aac|ogg){0,1})(.*)?"\s(\d{3,3})\s(\d+)\s"(.+)"\s"(.+)"\s(\d+)$/i";

Diese Syntax entspricht der PHP-Funktion preg_match und muss gegebenenfalls an andere Funktionen/Programmiersprachen angepasst werden.

Die Funktion preg_match gibt ein Array zurück, dessen aussagekräftige Positionen wie folgt sind: