icm/HTTP/logging_<xx> 
icm/HTTP/logging_<xx>
Dieser Parameter hat folgende Syntax:
icm/HTTP/logging_<xx> = PREFIX=<URL-Praefix>, LOGFILE=<Name des Logfiles> [, LOGFORMAT=<Format der Einträge>, MAXSIZE=<max. Größe des Logfiles>, SWITCHTF=<Optionen für neues Tracefile>, FILEWRAP=on]
Hierbei haben die einzelnen Angaben folgende Bedeutung.
PREFIX
URL-Präfix, für den dieser HTTP-Subhandler aufgerufen werden soll (z.B. "/"). (Siehe auch
HTTP Plugin.)LOGFILE
Name der Ausgabedatei im Dateisystem. Um den Dateien sprechende Namen geben zu können, stehen folgende Optionen bei die Angabe des Logfiles zur Verfügung:
|
%d |
Tag im Monat (1-31) |
|
%m |
Monat im Jahr (1-12) |
|
%y |
4-stelliges Jahr im Format YYYY |
|
%h |
Stunde (0-23) |
|
%t |
Minute (0-59) |
|
%s |
Sekunde (0-59) |
|
%% |
'%'-Zeichen |
Sie können also an den eigentlichen Dateinamen noch einen Zeitstempel anhängen, um die Verwaltung der Dateien zu vereinfachen.
Wenn Sie beim Setzen des Parameters
LOGFILE=access_log-%d-%m-%y_%h:%t:%s
Dies ergibt dann ein Logfile mit dem Namen:
access_log-15-12-2000_16:51:53LOGFORMAT
Das Standard Logfileformat ist das CLF (Common Logfile Format) mit der Form:
10.18.104.36 - - [15/Dec/2000:16:18:35 +0100] "GET /dummy HTTP/1.0" 200 86
Soll ein anderes Format geschrieben werden, kann dies durch den Formatstring konfiguriert werden:
Folgende Platzhalter existieren:
|
%b |
Länge der Response in Bytes |
|
%h |
Name des entfernten Rechners (des Clients, z. B. Browser) |
|
%H |
Name des lokalen Rechners |
|
%S |
lokaler Portname/Service |
|
%a |
IP-Adresse des entfernten Rechners |
|
%l |
Angabe des sog. Remote Logname. Dieser Name ist das Ergebnis einer IDENT-Anfrage an den Client. Dies funktioniert nur, wenn dort der IdentityCheck aktiviert ist. |
|
%u |
Benutzername einer 401-Authentication |
|
%t |
Zeitangabe im CLF-Format: [15/Dec/2000:16:18:35 +0100] |
|
%T |
Dauer einer Anfrage in Sekunden |
|
%L |
Dauer einer Anfrage in Millisekunden |
|
%r |
1. Zeile eines HTTP-Requests: z.B. GET /bc/ping HTTP/1.0 |
|
%f |
Name des angefragten Objektes ohne Formfelder |
|
%U |
gesamte URI eines Requests (mit Formfeldern) |
|
%s |
OK-code der Response |
|
%v |
Name des virtuellen Rechners (IP-Adresse oder Name des Servers, mit dem sich der Client verbunden hat) |
|
%V |
Vollqualifizierter Rechnername (FQHN) des Servers (Wert des Parameters icm/host_name_full bzw. FQHN vom Betriebssystem). |
|
%{name}i |
Name eines Request-Headerfeldes z.B. %{user-agent}i |
|
%{name}o |
Name eines Response-Headerfeldes, z.B. %{server}o |
|
%{cookie}c |
Ausgabe eines Requests-Cookies |
|
%{cookie}C |
Ausgabe eines Response-Cookies |
Das CLF-Format wird durch den folgenden String erzeugt:
%h %l %u %t "r" %s %b.MAXSIZE
MAXSIZE
ist die maximale Größe der Logdatei in Kilobyte.Wird diese Größe überschritten, wird die aktuelle Datei geschlossen und eine neue (mit anderem Namen) geöffnet.
Der neue Dateiname ist (durch die Angabe von Zeit/Datumsfeldern, s.o.) eindeutig oder er wird durch Anhängen von "_xx" eindeutig gemacht (wobei xx eine von 0 aufsteigende Zahlenfolge ist)
Wurde
SWITCHF
Eine neue Logdatei kann nicht nur erzeugt werden, wenn eine bestimmte Größe erreicht ist, sondern auch bei zeitlichen Änderungen:
|
hour |
in jeder neuen Stunde soll eine neue Logdatei geöffnet werden |
|
day |
an jedem neuen Tag soll eine neue Logdatei geöffnet werden |
|
month |
in jedem neuen Monat soll eine neue Logdatei geöffnet werden |
FILEWRAP
Wird
FILEWRAP=on gewählt, so wird immer, wenn eine neue Datei angefangen würde (aufgrund Überschreitung der Zeit- oder Größengrenze), die bestehende Logdatei zurückgesetzt und neu geschrieben. Es gibt also immer nur eine Logdatei mit den aktuellen Logging-Daten.
PREFIX=/, LOGFILE=dev_http_access_log, SWITCHTF=day, FILEWRAP=on