Konfigurierbare Protokolltypen

Zusammenfassung Thread-Zeitplan-Protokolle

Wenn Sie die Option Zusammenfassung Thread-Zeitplan-Protokolle aktivieren, generiert Content Server Lightweight-Zeitplan-Protokolle. Diese Protokolle können Sie anschließend in Performance Analyzer laden und verwenden, um die Leistung von Content Server zu messen.

Die Option Zusammenfassung Thread-Zeitplan-Protokolle ist standardmäßig deaktiviert. Sie können die Optionen für Protokollierungsstufe, Speicherort und rollierende Protokolle konfigurieren. Siehe Konfigurierbare Protokolleinstellungen.


	OpenText Performance Analyzer ist ein optionales Administrator-Hilfsprogramm für OpenText Content Server. Performance Analyzer ist ein leistungsstarkes Tool, mit dem Content Server-Administratoren ausführliche Berichte zu Systemleistung, Nutzung und Verfügbarkeit von Content Server generieren können. Wenn Sie die Option Zusammenfassung Thread-Zeitplan-Protokolle auf der Seite Protokolleinstellungen konfigurieren aktivieren, hat dies die gleichen Auswirkungen wie die Einstellung `wantSummaryTimings=TRUE` im Abschnitt `[options]` in der Datei `opentext.ini`.

Thread-Protokolle

Wenn Thread-Protokolle aktiviert sind, generiert Content Server eine Thread-Protokolldatei für die einzelnen Threads und aktualisiert diese kontinuierlich, sodass die Daten, die an den Thread gesendet wurden, aufgezeichnet werden.

Standardmäßig sind die Thread-Protokolle deaktiviert. Sie können die Optionen für Protokollierungsstufe, Speicherort, rollierende Protokolle, Pufferung und Filterung nach Benutzer-ID konfigurieren, teils mit eigenen Optionen. Siehe Konfigurierbare Protokolleinstellungen.

Wenn Sie Thread-Protokolle mit der Ebene Debug oder höher aktivieren, wird eine JVMClassLoader.log-Datei im Ordner logs erstellt. Diese Protokolldatei enthält alle Java-Bibliotheken, die Content Server beim Starten lädt. Außerdem werden die Bibliotheken aufgelistet, die nicht geladen wurden, weil sie doppelt vorhanden sind.

SQL-Verbindungsprotokolle

Wenn SQL-Verbindungsprotokolle aktiviert sind, generiert Content Server eine SQL-Verbindungsprotokolldatei für die einzelnen Threads. SQL-Verbindungsprotokolle enthalten Informationen, wie z. B. SQL-Anweisungen, die für die Kommunikation zwischen Content Server und der Content Server-Datenbank erforderlich sind.

Standardmäßig sind die SQL-Verbindungsprotokolle deaktiviert. Sie können die Optionen für Protokollierungsstufe, rollierende Protokolle und Pufferung konfigurieren. Siehe Konfigurierbare Protokolleinstellungen.

Trace-Protokolle

Ein Trace-Protokoll wird immer dann erzeugt, wenn Content Server eine Fehlerbedingung erkennt, die einen Absturz verursacht. Das Protokoll enthält Informationen zu dem Modul und dem Skript, das den Absturz verursacht, und zeigt die Variablen und Werte an, die zu diesem Zeitpunkt vom oder an das Skript übergeben wurden.

Standardmäßig sind die Trace-Protokolle aktiviert. Sie können die Optionen für Speicherort und Aufbewahrung konfigurieren. Siehe Konfigurierbare Protokolleinstellungen.

Webserver-Client-Protokolle

Wenn Webserver-Client-Protokolle aktiviert sind, wird immer dann eine Datei generiert, wenn der Webbrowser eines Benutzers eine Anforderung an Content Server sendet. Der Name der Datei hängt vom Anforderungs-Handler ab.

Bei CGI lautet der Dateiname z. B. llclient<###>.out.
Für llisapi.dll lautete der Dateiname llisapi<###>.out.
Für das Content Server-Servlet lautet der Dateiname llservlet<###>.out.

Die Anzahl <###> wird von Content Server generiert.

Webserver-Client-Protokolle sind standardmäßig deaktiviert. Sie können die Optionen für Protokollierungsstufe, rollierende Protokolle und Pufferung konfigurieren. Siehe Konfigurierbare Protokolleinstellungen.

Zeitplan-Protokolle Webserver-Client

Wenn Zeitplan-Protokolle für Webserver-Clients aktiviert sind, generiert Content Server Protokollierung für jede aufgerufene Funktion. Dabei werden die SQL-Zeit, die Ausgabezeit, durchschnittliche Ausführungszeiten für die einzelnen Funktionen, der Benutzer, der die Funktion aufruft und die ursprüngliche IP-Adresse aufgezeichnet.

Die Zeitplan-Protokolle für Webserver-Clients sind standardmäßig deaktiviert. Sie können die Optionen für Protokollierungsstufe, rollierende Protokolle und Pufferung konfigurieren. Siehe Konfigurierbare Protokolleinstellungen.


	Tipp: Wenn Sie die Zeitplan-Protokolle für Webserver-Clients auf der Seite Protokolleinstellungen konfigurieren aktivieren, hat dies die gleichen Auswirkungen wie die Einstellung `Debug=11` im Abschnitt `[general]` der `opentext.ini`-Datei.

Konfigurierbare Protokolleinstellungen

Folgende Einstellungen sind für konfigurierbare Protokolltypen verfügbar:

Grad der Protokollierung

Die verfügbaren Protokollstufen variieren je nach Protokolltyp. Für Protokolle für Zusammenfassungszeiten sind nur die Stufen 0 - AUS und 2 - INFO verfügbar. Trace-Protokolle haben keine Protokollstufen; sie können nur aktiviert oder deaktiviert werden.

Der Grad der Protokollierung kann auf eine der folgenden Stufen eingestellt werden:

0 - AUS: Die Protokollierung für Content Server wird mit Ausnahme der Startprotokollierung deaktiviert. Dies ist die Standardeinstellung. Wenn Keine Protokollierung aktiviert ist, erzeugt Content Server minimale Startprotokolldateien und eine thread<#>.out-Datei für jeden gestarteten Thread.
1 - WARNEN: Stellt minimale Protokollierung für Content Server bereit.
2 - INFO: Stellt grundlegende Protokollierung für Content Server bereit.
3 - DEBUG: Stellt ausführliche Protokollierung für Content Server bereit.
4 - VERFOLGEN: Stellt die maximale verfügbare Protokollierung für Content Server bereit.


	Hinweis: Die Protokollierungsebenen 3 - Debug und 4 - Verfolgen generieren sehr große Protokolldateien und können sich negativ auf die Leistung von Content Server auswirken. In Produktionssystemen sollten Sie diese Ebenen nur nach Aufforderung durch den OpenText-Kundensupport aktivieren.

Ort

Der Speicherort der Datei, in die die Protokolle geschrieben werden. Standardmäßig werden Protokolle in den folgenden Unterordnern des Ordners <Content_Server_home>\logs\ gespeichert.

Zusammenfassung Thread-Zeitplan-Protokolle

Die Zusammenfassung Thread-Zeitplan-Protokolle werden standardmäßig im Verzeichnis ./logs/timing_logs/ gespeichert und haben einen ähnlichen Namen wie timing_<N>.csv.<M>, wobei Folgendes gilt:

<N> ist die Nummer des Threads, und
<M> ist eine Sequenznummer, die generiert wird, wenn rollierende Protokolle aktiviert sind.

Thread-Protokolle

./logs/thread_logs/

SQL-Verbindungsprotokolle

./logs/connect_logs/

Trace-Protokolle

./logs/trace_logs/

Webserver-Client-Protokolle

./logs/cgi_logs/

Zeitplan-Protokolle Webserver-Client

Die Zeitplan-Protokolle für Webserver-Clients werden standardmäßig im Verzeichnis ./logs/timing_logs/ gespeichert und haben einen ähnlichen Namen wie llclient_<M>.csv, wobei <M> eine Sequenznummer ist, die generiert wird, wenn rollierende Protokolle aktiviert sind.

Rollierende Protokolle

Sie können rollierende Protokolldateien aktivieren und die Anzahl der Protokolldateien angeben, die vor dem Überschreiben der ältesten Datei beibehalten werden sollen. Außerdem können Sie die Größe festlegen, die eine Protokolldatei erreichen darf, bevor Content Server eine neue Datei erstellt. Darüber hinaus können Sie die Kompression der abgeschlossenen Protokolldateien aktivieren. Standardmäßig sind rollierende Protokolldateien nicht aktiviert.


	Hinweis: Diese Einstellung ist nicht für Trace-Protokolldateien verfügbar.

Pufferung

Sie können Ohne Verzögerung schreiben oder Puffer im Arbeitsspeicher aktivieren. Mit Ohne Verzögerung schreiben wird sichergestellt, dass die Protokollausgabe in eine Datei geschrieben wird. Puffer in Arbeitsspeicher sorgt für schnellere Leistung, kann aber unter Umständen bedeuten, dass die Protokollausgabe nicht in eine Datei geschrieben wird. Wenn Sie Puffer in Arbeitsspeicher aktivieren, können Sie die Größe des Puffers festlegen, der aufgefüllt werden muss, bevorContent Server den Pufferinhalt in die Protokolldatei schreibt. Standardmäßig ist Ohne Verzögerung schreiben aktiviert.


	Hinweis: Diese Einstellung ist nicht für Trace-Protokolldateien verfügbar.

Aufbewahrung

Sie können Aufbewahrung aktivieren, um die maximale Anzahl der beizubehaltenden Protokolldateien sowie die maximale Anzahl der zu Dateien anzugeben, die gelöscht werden sollen, wenn die Gesamtzahl der Protokolldateien die Anzahl beizubehaltender Dateien überschreitet. Standardmäßig ist Aufbewahrung aktiviert, die Anzahl beizubehaltender Dateien ist auf 1000 gesetzt und die Anzahl zu löschender Dateien bei Überschreitung des Grenzwerts liegt bei 50.


	Hinweis: Diese Einstellungen ist nur für Trace-Protokolldateien verfügbar.

Die Einstellungen Optionen und Benutzerprotokollierung sind nur im Abschnitt Thread-Protokolle verfügbar:


	Hinweis: Die Einstellungen Anforderungs-Timing-Zusammenfassungen einschließen und Anforderungsparameter einschließen gelten sowohl für Thread-Protokolle als auch für SQL-Verbindungsprotokolle. Die Einstellung Such- und Systemobjekt-Protokollierung einschließen wirkt sich auf Thread-Protokolle, aber nicht auf SQL-Verbindungsprotokolle aus.

Optionen

Anforderungs-Timing-Zusammenfassungen einschließen

Timing-Zusammenfassungen enthalten Informationen über die Dauer der Content Server-Transaktionen. Sie können aktivieren oder deaktivieren, ob die Anforderungs-Timing-Zusammenfassungen in Thread-Protokollen eingeschlossen werden sollen. Standardmäßig sind Anforderungs-Timing-Zusammenfassungen aktiviert.


	Tipp: Wenn Sie Anforderungs-Timing-Zusammenfassungen einschließen aktivieren, hat dies die gleichen Auswirkungen wie die Einstellung `wantTimings=TRUE` im Abschnitt `[options]` der Datei `opentext.ini`.

Anforderungsparameter einschließen

Anforderungsparameter enthalten Informationen über die Parameter, z. B. deren aktuelle Werte, die vom Webbrowser an Content Server übergeben werden.


	Tipp: Wenn Sie Anforderungsparameter einschließen aktivieren, hat dies die gleichen Auswirkungen wie die Einstellung `wantVerbose=TRUE` im Abschnitt `[options]` der Datei `opentext.ini`.

Such- und Systemobjekt-Protokollierung einschließen

Aktivieren Sie diese Einstellung, um Such- und Systemobjekt-Protokollinformationen in das Thread-Protokoll einzuschließen.


	Tipp: Wenn Sie Such- und Systemobjekt-Protokollierung einschließen aktivieren, hat dies die gleichen Auswirkungen wie die Einstellung `wantDebugSearch=TRUE` im Abschnitt `[options]` der Datei `opentext.ini`.

SOAP-API-Parameter einschließen

Aktivieren Sie diese Einstellung, um Eingabeparameter von SOAP-Anfragen aus Softwareprogrammen einzuschließen, die mit Content Server integriert sind, inklusive externe Programme, benutzerdefinierte Anwendungen und OpenText Extended ECM-Lösungen.

SOAP-API-Antworten einschließen

SOAP-API-Antworten enthalten Informationen, die Content Server als Antwort auf SOAP-Anforderungen von Programmen zurückgegeben hat, die mit Content Server integriert sind.


	Achtung SOAP-API-Antworten können große Datenmengen sowie sensible oder vertrauliche Informationen enthalten.

Benutzerprotokollierung

Wenn Sie Stufe 3-Protokollierung (Debug) für Anforderungen von bestimmten Content Server-Benutzern aktivieren möchten, geben Sie mindestens eine Content Server-Benutzer-ID in diesem Feld ein. Wenn Sie mehr als eine Content Server-Benutzer-ID eingeben, trennen Sie die einzelnen IDs durch ein Komma. Diese Einstellung überschreibt die allgemeine Protokollierungsstufe, die für Thread-Protokollierung gilt, jedoch nur für die Benutzer, die im Feld Benutzerprotokollierung eingegeben wurden.


	Tipp: Wenn Sie Benutzerprotokollierung aktivieren, kann dies bei der Fehlerbehebung für bestimmte Probleme hilfreich sein. Wenn Sie diese Einstellung verwenden, können Sie detaillierte Protokollinformationen zu bestimmten Aktionen bestimmter Benutzer erhalten, ohne dass Sie die ausführliche Protokollierung für alle Content Server-Aktivitäten aktivieren müssen.