WebSphere Virtual Enterprise, Version 6.1.1
             Betriebssysteme: AIX, HP-UX, Linux, Solaris, Windows,


Übersicht über angepasste Protokolle

Angepasste Protokolle bieten die Flexibilität, zu entscheiden, welche Daten erfasst und in welcher Art und Weise sie angezeigt werden sollen, und bieten außerdem die Möglichkeit, mehrere bedingte Protokolle zu erstellen. Sie können Regelsätze erstellen, um die Daten anzugeben, die in die Protokolle aufgenommen werden sollen, die Reihenfolge, in der sie angezeigt werden sollen, und die bedingte Logik, mit der gefiltert wird, welche Anforderungen aufgenommen werden sollen, sowie die Nummern und Namen der Protokolldateien.

Objekte für angepasste Eigenschaften

Objekte für angepasste Eigenschaften (CustomProperty) sind auf der Ebene des Regelsatzes, der Regel oder der Aktion zulässig. Mit den Regeln werden die Bedingungen festgelegt, die Protokollaktionen auslösen. Ein Ausdrucksfeld wird verwendet, um die zu protokollierenden Anforderungen und Antworten zu ermitteln. Dieser Ausdruck verwendet die Standard-HTTP-Sprachoperanden sowie den Operanden response.code, um nach HTTP-Antwortcodes wie z. B. 404, 503 usw. zu filtern. Beispielsweise würde response.code = 200 alle Antworten des Antwortcodes 200 abrufen. 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 HTTP-Operand für angepasste Protokolle response.time gibt den Zeitraum an zwischen dem Zeitpunkt, zu dem die Anforderung im ODR empfangen wird, und dem Zeitpunkt, zu dem die Antwort des ODR gesendet wird. Weitere Informationen zu HTTP-Operanden für angepasste Protokolle finden Sie im Artikel HTTP-Operanden .

Regeln haben Prioritäten, um die Reihenfolge festzulegen, in der sie ausgewertet werden sollten. Es gibt Protokollaktionen, die bei Übereinstimmung mit Regeln ausgeführt werden. Die Protokollaktionen können das Feld continue enthalten. Wenn "continue=true" festgelegt wurde, können nachfolgende Protokollaktionen ausgeführt werden. Wenn jedoch "continue=false" festgelegt wurde, werden nach Ausführung dieser Protokollaktion keine weiteren Protokollaktionen ausgeführt. Sie können das Script manageODR.py verwenden, um einen ODR-Cluster zu erstellen und angepasste Protokolle zu verwalten. Weitere Informationen hierzu finden Sie im Artikel Script "manageODR.py" .

Regelsatz

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

Regel

name
Gibt den Namen der Regel an (Zeichenfolge, 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 (Zeichenfolge, eindeutig innerhalb der Regel).
priority
Optional, ganze Zahl (eindeutig innerhalb der Regel).
type
Zeichenfolge, erforderlich, Protokoll.
value
Erforderlich (Zeichenfolge, enthält eine Folge von durch das Zeichen "@" begrenzten "logFormats". Beispiel: value="custom01.log %a%z@custom02.log %A%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 (Zeichenfolge)
value
Erforderlich (Zeichenfolge).
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. Ein "?" wird vorangestellt, wenn die Abfragezeichenfolge nicht 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).



Zugehörige Verweise
Script "manageODR.py"
Konzeptartikel    

Nutzungsbedingungen | Feedback

Letzte Aktualisierung: 24.09.2009 16.37 Uhr EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/odoe_task/cxdcustomlog.html