[AIX Solaris HP-UX Linux Windows][z/OS]

Angepasstes Protokolldateiformat

Bei der Verarbeitung einer Anforderung können Sie Regelsätze erstellen, um festzulegen, welche Daten in die Protokolle eingeschlossen werden sollen, und um die Anzeigereihenfolge, die Bedingungslogik für das Filtern der einzuschließenden Anforderungen sowie die Anzahl und die Namen der Protokolldateien zu bestimmen.

Objekte für angepasste Eigenschaften

Angepasste Eigenschaftsobjekte können auf Regelsatz-, Regel- und Aktionsebene verwendet werden. Regeln bestimmen die Bedingungen basierend auf den ausgeführten Protokollaktionen. Ein Ausdrucksfeld wird verwendet, um die zu protokollierenden Anforderungen und Antworten zu ermitteln. In diesem Ausdruck werden die Standardoperanden der HTTP-Sprache und der Operand response.code verwendet, um die Einträge nach HTTP-Antwortcode, wie z. B. 404 oder 503, zu filtern. Mit response.code = 200 werden beispielsweise alle Antworten nach dem Antwortcode 200 gefiltert. Der HTTP-Operand targetserver wird verwendet, um in einem Format von WebSphere Application Server anzuzeigen, an welchen Server die Anforderung gesendet wurde. Der HTTP-Operand für angepasste Protokolle service.time gibt den Zeitraum an zwischen dem Zeitpunkt, zu dem die Anforderung an den Anwendungsserver gesendet wird, und dem Zeitpunkt, zu dem eine Antwort vom Anwendungsserver empfangen wird. Der Operand response.time für angepasste HTTP-Protokolle gibt den Zeitraum zwischen dem Zeitpunkt, zu dem die Anforderung im ODR empfangen wird, und dem Zeitpunkt an, zu dem die Anforderungsantwort vom ODR gesendet wird. Weitere Informationen finden Sie im Abschnitt zu den Operanden für angepasste HTTP-Protokolle.

Die Regelpriorität bestimmt die Reihenfolge der Regelauswertung. Wenn eine Regelübereinstimmung gefunden wird, werden bestimmte Protokollaktionen ausgeführt. Die Protokollaktionen können das Feld continue enthalten. Wenn continue auf true gesetzt ist, können nachfolgende Protokollaktionen ausgeführt werden. Ist continue jedoch auf false gesetzt, werden nach Abschluss der Protokollaktion keine nachfolgenden Protokollaktionen ausgeführt. Verwenden Sie das Script manageODR.py, um einen Cluster von ODRs zu erstellen und die angepasste Protokollierung zu verwalten. Weitere Informationen finden Sie in der Beschreibung des Scripts manageODR.py.

Regelsatz

name
Geben Sie den Namen des Regelsatzes an. (String, erforderlich.)
type
Gibt den Typ des Regelsatzes an. (String, Protokoll-ID wie z. B. HTTP)
continueDefault
Legt den Standardwert für continue fest. (Boolean, erforderlich)
properties
Optional
rule
Erforderlich

Regel

name
Gibt den Namen der Regel an. (String, eindeutig innerhalb des Regelsatzes)
priority
Erforderlich, ganze Zahl (eindeutig innerhalb des Regelsatzes)
expression
Zeichenfolge, erforderlich.
action
Erforderlich.
properties
Optional

Aktion

name
Gibt den Namen der Aktion an. (String, eindeutig innerhalb der Regel).
priority
Optional, ganze Zahl (eindeutig innerhalb der Regel).
type
Zeichenfolge, erforderlich, Protokoll.
value
Erforderlich (String, enthält eine Folge von durch das Zeichen "@" begrenzten "logFormats". Beispiel:
value="custom01.log %a%z@custom02.log @(#) 10 1.7@(#)Z"
continue
Optional, boolescher Wert. Wenn nicht festgelegt, wird standardmäßig der Wert "continueDefault" (true, false) verwendet.
properties
Optional

customProperties

name
Gibt den Namen der angepassten Eigenschaft an (String)
value
Erforderlich (String).
continue
Optional, boolescher Wert. Wenn nicht festgelegt, wird standardmäßig der Wert continueDefault (true, false) verwendet.

Format der Protokollaktion

Das Attribut "value" (Wert) der Aktion enthält eine Reihe von Argumenten, die den Dateinamen und das Format des Protokolls angeben. Wenn Sie mehrere Protokolle im Attribut "value" erstellen möchten, begrenzen Sie die Argumente mit dem Zeichen "@". Das erste Argument für die Protokollaktion ist der Name der Protokolldatei relativ zum Protokollverzeichnis des ODR. Die folgenden Argumente sind Parameter, die angeben, welche Informationen in das Protokoll aufgenommen werden sollen. Die Daten werden in der Reihenfolge angezeigt, in der die Parameter angegeben werden.

Tabelle 1. Parameter des angepassten Protokolls
Parameter Beschreibung
%a Ferne IP-Adresse.
%A Lokale IP-Adresse.
%B Gesendet Bytes unter Ausschluss der HTTP-Header.
%b Gesendete Bytes einschließlich HTTP-Header. Im CLF-Format, d. h., wenn keine Bytes gesendet werden, wird "-" anstelle von null angezeigt.
%{FOOBAR}C Der Inhalt des Cookie in der Anforderung, die an den Server gesendet wird.
%{FOOBAR}i Der Inhalt der "Foobar:"-Header-Zeile(n) in der an den Server gesendeten Anforderung.
% I Empfangene Bytes einschließlich Anforderung und Header kann nicht null sein.
%{FOOBAR}e Der Inhalt des für die JVM des ODR-Prozesses angegebenen Arguments "debug" ("-D") FOOBAR.
%h Ferner Host.
%H Das Anforderungsprotokoll HTTP oder HTTPS.
%m Die Anforderungsmethode.
%{FOOBAR}o Der Inhalt der Foobar-Header-Zeile(n) in der Antwort.
%O Anzahl gesendeter Bytes, einschließlich Header; die Anzahl kann nicht null sein.
%p Der kanonisch Port des Servers, der die Anforderung bedient.
%q Die Abfragezeichenfolge mit dem Präfix ?, wenn eine Abfragezeichenfolge existiert. Andernfalls ist es eine leere Zeichenfolge.
%r Erste Zeile der Anforderung.
%R Antwortzeit in Millisekunden. Gesamtzeit in ODR und Anwendungsserver.
%s Status, HTTP-Antwortcode, d. h. 503, 404, 200.
%t Die Zeit im Zeitformat des allgemeinen Protokollformats, englisches Standardformat.
%{format}t Die Zeit in der durch das Format bestimmten Form. Dies sollte das Format "strftime(3)" sein. Möglicherweise lokalisiert.
%T Die Zeit in Millisekunden, die zum Bedienen der Anforderung benötigt wird.
%U Der angeforderte URL-Pfad ohne Abfragezeichenfolge.
%v Der kanonische ServerName des Servers, der die Anforderung bedient.
%z Ziel-IP-Adresse.
%Z Zielservername (Zelle/Knoten/Server).

Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwve_xdcustomlog
Dateiname:cwve_xdcustomlog.html