Webalizer

Allgemeines

Das Webalizer-Paket ermöglicht es, die Logdateien von Apache grafisch auszuwerten.

Es werden u.a. Statistiken über den durchschnittlichen Traffic erzeugt, aus welchem Land die Besucher des Webservers kommen oder wie viele Zugriffe zu einer bestimmten Stunde erfolgten.

Die Zuordnug zu den Ländern erfolgt mit der „GeoIP.dat“ Datenbank im sogenannten Legacy Format.

Die „GeoIP.dat“ Datenbank kann mit dem Paket „geoipupdate-legacy“, automatisch, mit einem Timer-Job aktuell gehalten werden.

Der Webzugriff

Der Webzugriff erfolgt für den jeweiligen Host(Domain) über den eingestellten ,,alias“

Bei der Einstellung WEBALIZER_VHOSTS_RUN_ALL

Hinweis
Entspricht die URL dem jeweiligen APACHE2_VHOST_x_SERVER_NAME.

Beispiel: ⇒ {http{s}://}APACHE2_VHOST_x_SERVER_NAME/WEBALIZER_VHOSTS_ALIAS

Bei der Einstellung WEBALIZER_HOST_N

Hinweis
Entspricht die URL dem jeweiligen WEBALIZER_HOST_x_HOST_NAME.

Beispiel: ⇒ {http{s}://}WEBALIZER_HOST_x_HOST_NAME/WEBALIZER_HOST_x_ALIAS

In der Konfiguration des Apache WebServers müssen keine Parameter Einstellungen vorgenommen werden.

Das Menü im Setup-Programm

Das Menü im Setup-Programm ist wie folgt aufgebaut:

„Webalizer“ ist als Modul im Apache2 Menu zu finden

x.

Apache2 Webserver

x.

Configuration

x.

Modules configuration

x.

Webalizer Administration

	1.	View documentation
	2.	Edit configuration
	3.	Advanced configuration file handling
	4.	Run Webalizer now
	5.	User handling for web access (Optional)

Die Konfigurationsdatei

START_WEBALIZER

Für die Aktivierung von WEBALIZER muss diese Variable auf den Wert 'yes' gestellt werden. Die Einstellung 'no' schaltet WEBALIZER ab.

Gültige Werte: yes, no

Standardeinstellung: START_WEBALIZER='no'

WEBALIZER_SCHEDULE_TIME

Hier wird angegeben, wann und wie oft Webalizer die Auswertungen aktualisieren soll.

(komplexe Definition): Legt fest, zu welchen Zeitpunkten dieser Job durch Systemd ausgeführt werden soll.

Ein Job wird von Systemd nur ausgeführt, wenn alle Kriterien zutreffen (logisches UND);

Wenn genauere Datums- und Uhrzeitangaben erforderlich sind, verwenden OnCalendar-Ereignisse das folgende Format:

    DayOfWeek Year-Month-Day Hour:Minute:Second

Beispiele:

Ein Sternchen kann verwendet werden, um einen beliebigen Wert anzugeben, und Kommas können verwendet werden, um mögliche Werte aufzulisten. Zwei durch '..' getrennte Werte zeigen einen zusammenhängenden Bereich an.

Im folgenden Beispiel wird der Dienst an den ersten vier Tagen jedes Monats um 12:00 Uhr ausgeführt, aber nur, wenn dieser Tag ein Montag oder Dienstag ist.

    Mon,Tue *-*-01..04 12:00:00

Um einen Dienst am ersten Samstag jedes Monats auszuführen, verwenden Sie:

    Sat *-*-1..7 18:00:00

Bei Verwendung des DayOfWeek-Teils muss mindestens ein Wochentag angegeben werden. Wenn Sie möchten, dass jeden Tag um 4 Uhr morgens etwas ausgeführt wird, verwenden Sie:

    *-*-* 04:00:00

Die folgenden speziellen Ausdrücke können als Abkürzungen für längere normalisierte Formen verwendet werden:

	minutely	⇒	*-*-* *:*:00
	hourly	⇒	*-*-* *:00:00
	daily	⇒	*-*-* 00:00:00
	monthly	⇒	*-*-01 00:00:00
	weekly	⇒	Mon *-*-* 00:00:00
	yearly	⇒	*-01-01 00:00:00
	quarterly	⇒	*-01,04,07,10-01 00:00:00
	semiannually	⇒	*-01,07-01 00:00:00

Weitere Informationen siehe Systemd-time

Standardeinstellung: WEBALIZER_SCHEDULE_TIME='*-*-* 23:25:00'

WEBALIZER_LANG_TYPE

Hier kann die Standard Sprache für den Webalizer eingestellt werden.

Gültige Werte: english, german, french

Standardeinstellung: WEBALIZER_LANG_TYPE='english'

WEBALIZER_ACCESS_AUTH_SEND_MAIL_FROM

Bei der Einstellung WEBALIZER_x_ACCESS_AUTH muss hier eine Mail Adresse angeben werden, die als Absender benutzt werden soll. Bleibt sie leer wird keine Mail versandt.

Gültige Werte: Mail Adresse

Standardeinstellung: WEBALIZER_ACCESS_AUTH_SEND_MAIL_FROM=''

WEBALIZER_QUIET

Die Quiet Option unterdrückt die Ausgabe von Meldungen ...
Nützlich, bei einem Timer-Job, um unötige E-Mails zu verhindern.
Hinweis: Warnungen und Fehler, die auf stderr ausgegeben werden, sind davon nicht betroffen.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_QUIET='no'

WEBALIZER_REALLY_QUIET

ReallyQuiet unterdrückt alle Meldungen, einschließlich Fehler und Warnungen. Bei 'yes', kann sie nicht auf der Kommandozeile überschrieben werden.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_REALLY_QUIET='no'

WEBALIZER_TIME_ME

Mit TimeMe kann die Anzeige von Zeitinformationen am Ende der Verarbeitung eingeschaltet werden.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_TIME_ME='no'

Apache VHOSTs Konfiguration

WEBALIZER_VHOSTS_RUN_ALL

Ist diese Variable auf 'yes' gesetzt, werden alle Logdateien ausgewertet, die in der Apache-VHost-Konfiguration konfiguriert sind.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_VHOSTS_RUN_ALL='yes'

WEBALIZER_VHOSTS_ALIAS

Hier wird der Alias angegeben, über den Webalizer angesprochen werden soll.

Die URL entspricht dem jeweiligen APACHE2_VHOST_x_SERVER_NAME.

Beispiel: ⇒ {http{s}://}APACHE2_VHOST_x_SERVER_NAME/httpd

Gültige Werte: Name

Standardeinstellung: WEBALIZER_VHOSTS_ALIAS='httpd'

WEBALIZER_VHOSTS_TITLE

Hier wird die Überschrift der Auswertungen angegeben.

Ist z.B. WEBALIZER_TITLE='Auswertungen von' gesetzt wird die Überschrift der Auswertung vom Virtual Host bzw. vom Mainhost, dessen Hostname eis.meinesubdomain.eisfair.net ist 'Auswertungen von eis.meinesubdomain.eisfair.net' lauten.

Standardeinstellung: WEBALIZER_VHOST_TITLE='Auswertung von'

WEBALIZER_VHOSTS_BGCOLOR

Hier wird die Hintergrundfarbe der Auswertung in hexadezimaler Schreibweise angegeben. Als Präfix muss eine Raute (#) angegeben werden.

Gültige Werte: Html Farbcode

Standardeinstellung: WEBALIZER_VHOSTS_BGCOLOR='#E8E8E8'

WEBALIZER_VHOSTS_COLOR_SCHEME

Hier kann ein Farb Schema angegeben werden.

Gültige Werte: default, aqua, fresh

Standardeinstellung: WEBALIZER_VHOSTS_COLOR_SCHEME='default'

WEBALIZER_VHOSTS_ACCESS_ALL

Hier ist der Zugriff für alle erlaubt, Weltweit.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_VHOSTS_ACCESS_ALL='no'

WEBALIZER_VHOSTS_ACCESS_AUTH

Hier ist der Zugriff mit Benutzernamen und Passwort erlaubt. Benutzer müssen dafür über den Menüpunkt „User handling for web access“ in der Webalizer-Administration ein Passwort erhalten.
Dieser Menüpunkt ist nur sichtbar, wenn WEBALIZER_VHOSTS_ACCESS_AUTH='yes' gesetzt ist.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_VHOSTS_ACCESS_AUTH='no'

WEBALIZER_VHOSTS_ACCESS_HOST

Hier ist der Zugriff von Hostname erlaubt. Es dürfen mehrere, durch ein Leerzeichen getrennt, angegeben werden.

Gültige Werte: Hostname, Domain

Standardeinstellung: WEBALIZER_VHOSTS_ACCESS_HOST=''

WEBALIZER_VHOSTS_ACCESS_IP

Hier ist der Zugriff von der IP Adresse erlaubt. Es dürfen mehrere, durch ein Leerzeichen getrennt, angegeben werden.

Beispiel: 10 192.168.6 192.168.6.1 192.168.6.0/24

Gültige Werte: IP Adresse

Standardeinstellung: WEBALIZER_VHOSTS_ACCESS_IP=''

WEBALIZER_VHOSTS_ACCESS_LOCAL

Hier ist der Zugriff nur local erlaubt.

Hinweis
Diese Einstellung lässt sich nicht mit anderen Methoden kombinieren.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_VHOSTS_ACCESS_LOCAL='yes'

Konfiguration für zusätzliche Logfiles

WEBALIZER_HOST_N

Bei diesem Parameter wird angegeben, wie viele Hosts konfiguriert werden sollen.

Gültige Werte: Zahl

Standardeinstellung: WEBALIZER_HOST_N='1'

WEBALIZER_HOST_x_NAME

Der Name wird nicht ausgewertet, es ist zur Eigenen Kontrolle.

Gültige Werte: alles

Standardeinstellung: WEBALIZER_HOSTS_x_NAME=''

WEBALIZER_HOST_x_ACTIVE

Über diesen Parameter wird eingestellt, ob der Datensatz aktiv sein soll.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_HOST_x_ACTIVEL='no'

WEBALIZER_HOST_x_ALIAS

Hier wird der Alias angegeben, über den Webalizer angesprochen werden soll.

Beispiel: ⇒ {http{s}://}WEBALIZER_HOST_x_HOST_NAME/httpd

Gültige Werte: Name

Standardeinstellung: WEBALIZER_HOST_x_ALIAS='httpd'

WEBALIZER_HOST_x_ACCESS_LOG

Hier wird die auszuwertende Logdatei angegeben.

Z.B. WEBALIZER_HOST_x_ACCESS_LOG='/var/log/ftpd.log'

WEBALIZER_HOST_x_HOST_NAME

Hier wird der Hostname angegeben, auf dem der Server, der die Logdateien produziert hat, läuft.

Gleichzeitig ist das auch die URL über den Webalizer erreicht werden kann.

Beispiel: ⇒ {http{s}://}www.meine.de/WEBALIZER_HOST_x_ALIAS

Gültige Werte: Hostname

Standardeinstellung: WEBALIZER_HOST_x_HOST_NAME=''

WEBALIZER_HOST_x_TITLE

Hier wird die Überschrift der Auswertungen angegeben.

Ist z.B. WEBALIZER_TITLE='Auswertungen von' gesetzt, wird die Überschrift der Auswertung vom Virtual Host bzw. vom Mainhost, dessen Hostname eis.meinesubdomain.eisfair.net ist 'Auswertungen von eis.meinesubdomain.eisfair.net' lauten.

Standardeinstellung: WEBALIZER_HOST_x_TITLE='Auswertung von'

WEBALIZER_HOST_x_BGCOLOR

Hier wird die Hintergrundfarbe der Auswertung in hexadezimaler Schreibweise angegeben. Als Präfix muss eine Raute (#) angegeben werden.

Gültige Werte: Html Farbcode

Standardeinstellung: WEBALIZER_HOST_x_BGCOLOR='#E8E8E8'

WEBALIZER_HOST_x_COLOR_SCHEME

Hier kann ein Farb Schema angegeben werden.

Gültige Werte: default, aqua, fresh

Standardeinstellung: WEBALIZER_HOST_x_COLOR_SCHEME='default'

WEBALIZER_HOST_x_TYPE

Webalizer kann mehrere Logdateiformate lesen. Das gängiste davon ist das „Common Logfile Format“ (CLF). Dies ist z.B. auch das Standard-Logfileformat von Apache.

Weitere Möglichkteien neben 'clf' sind 'squid', 'ftp' und 'w3c'.

Wobei das FTP-Format nicht von dem FTP-Dämon aus dem Pure-FTPd-Paket unterstützt wird. Hier muss in der Pure-FTPd-Konfiguration das Logdateiformat vom ftpd auf das Common Logfile Format umgestellt werden. In der Webalizer-Konfiguration ist dann natürlich unter WEBALIZER_HOST_x_TYPE 'clf' einzustellen.

Standardeinstellung: WEBALIZER_HOST_x_Type='clf'

WEBALIZER_HOST_x_ACCESS_ALL

Hier ist der Zugriff für alle erlaubt, Weltweit.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_HOST_x_ACCESS_ALL='no'

WEBALIZER_HOST_x_ACCESS_AUTH

Hier ist der Zugriff mit Benutzername und Passwort erlaubt. Benutzer müssen dafür über den Menüpunkt „User handling for web access“ in der Webalizer-Administration ein Passwort erhalten.
Dieser Menüpunkt ist nur sichtbar, falls WEBALIZER_VHOSTS_ACCESS_AUTH='yes' gesetzt ist.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_HOST_x_ACCESS_AUTH='no'

WEBALIZER_HOST_x_ACCESS_HOST

Hier ist der Zugriff von Hostname erlaubt. Es dürfen mehrere, durch ein Leerzeichen getrennt angegeben werden.

Gültige Werte: Hostname, Domain

Standardeinstellung: WEBALIZER_HOST_x_ACCESS_HOST=''

WEBALIZER_HOST_x_ACCESS_IP

Hier ist der Zugriff von der IP Adresse erlaubt. Es dürfen mehrere, durch ein Leerzeichen getrennt, angegeben werden.

Beispiel: 10 192.168.6 192.168.6.1 192.168.6.0/24

Gültige Werte: IP Adresse

Standardeinstellung: WEBALIZER_HOST_x_ACCESS_IP=''

WEBALIZER_HOST_x_ACCESS_LOCAL

Hier ist der Zugriff nur local erlaubt.

Hinweis
Diese Einstellung lässt sich nicht mit anderen Methoden kombinieren.

Gültige Werte: yes, no

Standardeinstellung: WEBALIZER_HOST_x_ACCESS_LOCAL='yes'