ics_awstats: Statistik Modul für TYPO3

AWSTATS ist eine Software zum Auswerten von Logdateien. Damit lassen sich grafisch aufbereitete Statistiken erstellen. Seit vielen Jahren existiert die Erweiterung cc_awstats für TYPO3, mit der sich das Tool in das Backend integrieren lässt. Diese Extension wurde jedoch seit 2005 nicht mehr weiter entwickelt.

Die Extension ics_awstats bietet zusätzliche Funktionen und wird regelmäßig aktualisiert. In diesem Artikel beschreiben wir die Installation und Konfiguration.

Installation

Über den Extension Manager wird die ics_awstats installiert. Für die automatische Aktualisierung der Statistiken sollte die Extension scheduler aktiviert werden, diese wird bei TYPO3 bereits mitgeliefert.

Konfiguration der Extension ics_awstats

: Einstellungen für ics_awstats

Für ics_awstats stehen Optionen zur Verfügung, die bei Bedarf aktiviert werden können. Die benötigten Perl-Module sind bei unseren Servern vorhanden und die voreingestellten Pfadangaben richtig.

Mit Disable AWStats cache clearing wird verhindert, dass die Statistiken versehentlich gelöscht werden.

Enable Plugin DecodeUTF8Keys sorgt dafür, dass Umlaute in den Suchbegriffen richtig dargestellt werden.

Mit der Option Enable Plugin GeoIP können den IP-Adressen automatisch die Länder zugeordnet werden.

Logdateien erzeugen

Für die Statistiken müssen zunächst die Seitenzugriffe in Logdateien protokolliert werden. Diese Logs werden dann von AWSTATS ausgewertet. In den Logdateien des Apache Webservers (sofern über die Domaineinstellungen im Kundenmenü aktiviert) werden alle Zugriffe protokolliert: Seitenzugriffe sowie alle Bilder und Symbole. Der Aufruf einer einzelnen Seite kann daher zu 20-30 Einträgen in der Logdatei führen.

Für die Statistik reicht es jedoch meist aus, die Seitenzugriffe zu erfassen. Ein Log, das nur die Seitenzugriffe enthält, kann TYPO3 mit diesen Einstellungen im TypoScript Setup erzeugen:

config.stat = 1
config.stat_apache = 1
config.stat_apache_pagenames = [request_uri]
config.stat_excludeBEuserHits = 1
config.stat_apache_logfile = logfile.log

Mit dem [request_uri] werden die aufgerufenen URLs in der Statistik angezeigt, dies ist besonders bei Verwendung von realurl hilfreich. Die URLs können in der Statistik direkt angeklickt werden, um zu sehen, um welche Seite es sich handelt.

stat_excludeBEuserHits sorgt dafür, dass die eigenen Zugriffe durch eingeloggte Backend-Benutzer nicht protokolliert werden und das Ergebnis verfälschen.

Die Datei wird im Verzeichnis fileadmin erzeugt, diese Einstellung kann bei Bedarf über den Eintrag [FE][logfile_dir] im Installtool geändert werden.

AWStats Einstellungen

Im Menüpunkt AWStats müssen jetzt noch die Einstellungen für die Logdatei bearbeitet werden. Hier wird die verwendete Domain (1) eingetragen, mehrere Domains können durch Komma getrennt werden. Die Browser-Aktualisierung (2) wird deaktiviert, da das Update per Cronjob (Planer) (3) erfolgt.

Der Reverse DNS Lookup (4) ermöglicht die Ermittlung der Hostnamen für IP-Adressen, allerdings wird dadurch das Erzeugen der Statistik deutlich verlangsamt. Bei einer stark frequentierten Webseite sollte diese Option deaktiviert sein.

Nach der Aktualisierung der Statistik (5) kann die Logdatei geleert oder archiviert werden. Wird die Datei nicht geleert, muss man dies von Zeit zu Zeit manuell durchführen, da die Logdatei sonst sehr groß werden kann und ggf. der Speicherplatz nicht mehr ausreicht.

Statistiken mit dem Planer aktualisieren

: Die Einstellungen des Schedulers für die Aktualisierung der Statistiken

Die Statistiken sollten automatisch aktualisiert werden. Bei manuellem Update kann es sonst vorkommen, dass die angefallene Datenmenge seit der letzten Aktualisierung so groß geworden ist, dass die Skriptlaufzeit nicht ausreicht.

Mit dem Planer (Scheduler) in TYPO3 kann das Update z.B. alle halbe Stunde gestartet werden. Im Planer wird dazu ein neuer Task der Klasse AWStats (1) angelegt. Als Typ wird wiederkehrend (2) eingestellt und ein Startdatum (3) eingetragen. Im Feld Häufigkeit (4) trägt man das Intervall der Updates ein.