Einstellungen des Diagnostic Trace Service

Verwenden Sie diese Seite, um die Einstellungen des Diagnosetraceservice zu konfigurieren.

Unterstützte Konfigurationen: Auf diese Seite können Sie nur zugreifen, wenn der Server für den Basisprotokoll- und -tracemodus konfiguriert ist. sptcfg

Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Fehlerbehebung > Protokolle und Trace > Servername > Diagnosetrace.

Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Sie können alternativ (empfohlen) den Server dahingehend konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten Systemen und Systemen mit IBM i. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokollierungsfunktionen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.

Traceausgabe

Gibt an, in welche Datei die Traceausgabe geschrieben werden soll. Die Traceausgabe kann direkt in eine Ausgabedatei geschrieben oder in einen Speicher gestellt und auf Anforderung über die Option "Speicherauszug" auf der Seite "Laufzeit" in eine Datei geschrieben werden.

Der Umfang der Traceausgabe pro Eintrag kann je nach Komponente unterschiedlich sein. Der Naming- und Sicherheitstrace erzeugt beispielsweise mehr Traceausgaben als der Web-Container-Trace. Berücksichtigen Sie beim Konfigurieren der Einstellungen für die Speicherreservierung und die Ausgabe den Typ der zu erfassenden Daten.

Ohne: Wenn diese Option ausgewählt ist, werden die Tracedaten weder protokolliert noch aufgezeichnet. Alle anderen Handler (einschließlich der von Anwendungen registrierten Handlern) haben weiterhin die Möglichkeit, diese Traces zu verarbeiten.

Speicherpuffer

Gibt an, dass die Traceausgabe in einen Ringpuffer im Speicher geschrieben werden soll. Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:

Maximale Puffergröße: Gibt die Anzahl der Einträge, die im Puffer zwischengespeichert werden können, an (in Tausend). Wenn dieser Wert überschritten wird, werden alte Werte von neuen Werten überschrieben.

Datei

Gibt an, dass die Traceausgabe in eine selbstverwaltete Protokolldatei geschrieben werden soll. Die sich selbst verwaltende Protokolldatei schreibt so lange Nachrichten in die Datei, bis die angegebene maximale Dateigröße erreicht ist. Wenn die Datei die angegebene Größe erreicht, wird die Protokollierung vorübergehend ausgesetzt, und die Protokolldatei wird geschlossen und umbenannt. Der neue Name basiert auf dem ursprünglichen Namen der Datei und beinhaltet zusätzlich eine Zeitmarke, die angibt, wann die Umbenennung erfolgt ist. Nach der Umbenennung wird eine neue, leere Protokolldatei mit dem ursprünglichen Namen erneut geöffnet, und die Protokollierung wird wieder aufgenommen. Die Fortführung der Datei führt nicht dazu, dass Nachrichten verloren gehen, allerdings besteht die Möglichkeit, dass eine einzelne Nachricht in zwei Dateien aufgeteilt wird.Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:

Maximale Dateigröße: Gibt die maximale Größe in MB an, die die Ausgabedatei erreichen darf. Dieses Attribut ist nur gültig, wenn das Attribut "Dateigröße" ausgewählt wurde. Wenn die Datei diese Größe erreicht, wird sie wie zuvor beschrieben fortgeführt.

Maximale Anzahl der Protokolldateien: Gibt die Maximalanzahl der fortgeführten Dateien an, die gespeichert werden können.

Dateiname: Gibt den Namen der Datei an, in die die Traceausgabe geschrieben wird.

Fehler vermeiden: Diese Datei kann nicht von Servern gemeinsam genutzt werden. Der Server erstellt eine Datei mit der Erweiterung .owner. Auf diese Weise ist es einfacher festzustellen, wenn zwei oder mehr Server versuchen, dieselbe Datei zu verwenden. gotcha

Format der Traceausgabe

Gibt das Format der Traceausgabe an.

Sie können eine der folgenden drei Stufen für die Traceausgabe angeben:

Basis (kompatibel): Es werden nur grundlegende Traceinformationen gespeichert. Wählen Sie diese Option aus, um den Speicherplatz für die Traceausgabe zu verringern.

Erweitert: Es werden spezifischere Traceinformationen gespeichert. Wählen Sie diese Option aus, wenn Sie detaillierte Traceinformationen für die Fehlerbestimmung und -behebung anzeigen möchten.

Traceformat der Protokollanalyse: Bewahrt die Traceinformationen in dem Format, in dem sie vom Tool Showlog erzeugt werden.

Register "Laufzeit"

Laufzeitänderungen an der Konfiguration ebenfalls speichern

Speichert Laufzeitänderungen, die auf der Registerkarte "Laufzeit" vorgenommen wurden, auch in der Tracekonfiguration. Aktivieren Sie dieses Kontrollkästchen, um Änderungen des Laufzeittrace auch in die Tracekonfiguration zu kopieren. Wenn Sie diese Änderungen in der Tracekonfiguration speichern, bleiben sie auch nach einem Neustart der Anwendung weiterhin wirksam.

Traceausgabe

Ohne: Wenn diese Option ausgewählt ist, werden die Tracedaten weder protokolliert noch aufgezeichnet. Alle anderen Handler (einschließlich der von Anwendungen registrierten Handlern) haben weiterhin die Möglichkeit, diese Traces zu verarbeiten.

Speicherpuffer

Gibt an, dass die Traceausgabe in einen Ringpuffer im Speicher geschrieben werden soll. Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:

Maximale Puffergröße: Gibt die Anzahl der Einträge, die im Puffer zwischengespeichert werden können, an (in Tausend). Wenn dieser Wert überschritten wird, werden alte Werte von neuen Werten überschrieben.

Name der Speicherauszugsdatei: Der Name der Datei, in die der Speicherpuffer bei Erstellung eines Speicherauszugs geschrieben wird. Diese Option ist nur über das Register "Laufzeit" verfügbar.

Datei

Maximale Dateigröße: Gibt die maximale Größe in MB an, die die Ausgabedatei erreichen darf. Dieses Attribut ist nur gültig, wenn das Attribut "Dateigröße" ausgewählt wurde. Wenn die Datei diese Größe erreicht, wird sie wie zuvor beschrieben fortgeführt.

Maximale Anzahl der Protokolldateien: Gibt die Maximalanzahl der fortgeführten Dateien an, die gespeichert werden können.

Dateiname: Gibt den Namen der Datei an, in die die Traceausgabe geschrieben wird.
Anzeigen: Zeigt die Datei an, die mit dem Parameter Dateiname angegeben wurde. Dies gilt nicht für Ihre Konfiguration.

Fehler vermeiden: Verwenden Sie nicht denselben Dateinamen für mehr als einen verwalteten Server. Der Server erstellt eine Datei mit der Erweiterung .owner, um feststellen zu können, welcher Server einen bestimmten Dateinamen für die Ausgabe verwenden kann. gotcha

Dateiname: utrb_traceservice.html