Apache HTTP Server/Protokollierung

Konfiguration

Zu den wichtigsten Einstellungen bezüglich des Logging des Apache HTTP Server gehören die folgenden.

Parameter	Beschreibung
CustomLog	Ort und Typ der Logdatei. Beispielsweise erzeugt der folgende Eintrag die Logdatei "access_log" im "Common Log Format / CLF" (das beim Parameter "LogFormat" beschrieben wurde), was für die meisten Anwendungen ausreicht. CustomLog "/var/log/httpd/access_log" common Ein Eintrag in dieser Logdatei sieht dann folgendermassen aus. 127.0.0.1 - - [22/Mar/2009:00:42:01 +0100] "GET / HTTP/1.1" 200 1456 Um mehr anzuzeigen, kann anstelle von "common" das ebenfalls beim Parameter "LogFormat" beschriebene Format "combined" verwendet werden. Es ist auch möglich, für eine Datei mehr als ein Format gleichzeitig anzugeben, beispielsweise wenn die Referer oder Webbrowsertypen einzeln ausgewertet werden sollen.
ErrorLog	Ort des Protokolls von Zugriffsfehlern (z. B. "/var/log/httpd/error.log").
HostnameLookups	Der Wert "Off" schaltet die Auflösung von IP-Adressen in Rechner- und Domainnamen aus, da dies im Betrieb nur Ressourcen frisst. Zwar vermerkt die Logdatei damit bei den Zugriffen nur die IP-Adresse, jedoch kann auch jedes bessere Logdateianalyseprogramm die Namensauflösung übernehmen.
LogFormat	Format der Logdateien. Mögliche Optionen sind die folgenden. Option Beschreibung %h (hots) Der zugreifende Rechner. %l Benutzername, soweit dieser übermittelt wird. %u (user) Benutzername, soweit dieser übermittelt wird. %r (request) Anfrage des Webbrowsers an den Webserver. %>s (status) Status der letzten Anfrage innerhalb der Sitzung. %b (bytes) Anzahl der gesendeten Bytes. %{Referer}i Herkunft des Zugriffs. %{User-Agent}i Art des zugreifenden Webbrowsers. Der letzte Eintrag in der Zeile gibt den Typ der Logdatei an ("common" oder "combined"), in der die Protokolldaten landen. Der Ort der Logdatei wird über den Parameter "LogCustom" konfiguriert. Mögliche Formate der Logdateien sind beispielsweise die folgenden: LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined LogFormat "%h %l %u %t \"%r\" %>s %b" common
LogLevel	Menge der zu protokollierenden Daten. Mögliche Einstellungen sind: "warn" ist üblicherweise völlig ausreichend. "debug" liefert sehr viele Informationen.

Auswertung der Datei "access_log"

Um festzustellen, welche Seiten abgefragt wurden, wird die GET-Zeichenkette aus der Datei "/var/log/apache2/access_log" herausgelöst.

Eine externe Logauswertung erfolgt mit folgendem Skript: Der Aufruf von "cat" liest zunächst die Logdatei vollständig ein und übergibt sie der for-Schleife als Parameterliste - die Bash muss den gesamten Dateiinhalt also erst mal zwischenspeichern. Anschliessend wird für jeden Logeintrag "cut" als externes Programm aufgerufen.

#!/bin/bash
IFS=$'\n'
for l in $(cat access_log)
  do
  IFS=" "
  echo "${l}  " | cut -d" " -f7
  done

Eine interne Logauswertung erfolgt mit folgendem, wesentlich schnellerem Skript. Es öffnet die Logdatei über den Dateideskriptor 3 und liest in der while-Schleife jeweils eine zeile in die Variable "Anfrage" - die Bash braucht also stets nur einen Logeintrag zwischenzuspeichern. Anschliessend werden vom Zeilenanfang bis einschliesslich "GET " und vom Ende alle Zeichen bis einschliesslich " HTTP/" entfernt.

#!/bin/bash
exec 3<access_log
while read -u 3 Anfrage
  do
  Anfrage="${Anfrage##*GET }"
  echo "${Anfrage%% HTTP/*}"
  done