CM-API-Protokollierung konfigurieren

Sie können CM-API-Protokollierung konfigurieren.

Informationen zu diesem Vorgang

Die Protokollierung für die CM-API wird über die Datei logging.properties gesteuert, die der JRE zugeordnet ist, in der Ihre Anwendung ausgeführt wird. Die Datei logging.properties befindet sich im Verzeichnis jre\lib Ihres JDK, z. B. C:\Program Files\IBM\WebSphere\AST\eclipse\jre\lib, C:\jdk_5.0\jre\lib oder C:\Program Files\Java\jre1.5.0_06\lib).

Die Protokollieren ist standardmäßig inaktiviert. Sie sollten die Protokolling auf der Stufe INFO aktivieren.

Die folgende Beispieldatei logging.properties veranschaulicht, wie die Protokolleinstellungen für CM-API-basierte Anwendungen konfiguriert werden:
############################################################
#      Globale Eigenschaften
############################################################
#
# "handlers" gibt eine durch Kommas getrennte Liste von Protokoll-Handler-Klassen
# an. Diese Handler werden beim Start der VM installiert.
# Beachten Sie, dass diese Klassen im Klassenpfad des Systems angegeben sein müssen.
# Standardmäßig wird nur ein ConsoleHandler konfiguriert, der nur Nachrichten
# der Stufe "INFO" und höherer Stufen anzeigt.
handlers = java.util.logging.ConsoleHandler

# Um auch den FileHandler hinzuzufügen, müssen Sie stattdessen die folgende Zeile verwenden.
#handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

# Standardmäßig verwendete globale Protokollstufe.
# Gibt an, welche Arten von Ereignissen von allen Protokollfunktionen
# protokolliert werden. Diese globale Protokollstufe kann in jedem Tool
# durch eine toolspezfische Einstellung überschrieben werden.
# Beachten Sie, dass der ConsoleHandler ebenfalls eine eigene Einstellung
# für Protokollstufe hat, um die in der Konsole ausgegebenen Nachrichten zu begrenzen.
# Mit der nächsten Zeile wird die Protokollierung auf der Stufe "INFO" aktiviert
# (für alle Objekte von Protokollfunktionen).
.level=INFO

############################################################
# Handler-spezifische Eigenschaften.
# Beschreibt die spezifische Konfiguration für Handler.
############################################################

# CMLogger - Muss immer auf der Protokollstufe "INFO" aktiviert sein.
#
# Mit den folgenden Zeilen wird die Protokollierung für das CMLogger-Objekt auf der Stufe "INFO" aktiviert,
# die Protokollausgabedatei erhält den Namen "CMLogger[#].log" und wird in das Ausgangsverzeichnis des
# angemeldeten Benutzers gestellt. Die Protokollausgabe wird in 20 Dateien, von denen jede auf 20.000.000 Byte
# begrenzt ist, fortgeschrieben. An die aktuelle Protokollausgabedatei im Rotationssystem werden Protokolleinträge
# angehängt, die in einem einfachen Format verfasst sind.
#
com.ibm.rational.stp.common.internal.util.CMLogger.level = INFO
com.ibm.rational.stp.common.internal.util.LogHandler.pattern = %h/CMLogger%g.log
com.ibm.rational.stp.common.internal.util.LogHandler.limit = 20000000
com.ibm.rational.stp.common.internal.util.LogHandler.count = 20
com.ibm.rational.stp.common.internal.util.LogHandler.append = true
com.ibm.rational.stp.common.internal.util.LogHandler.formatter = java.util.logging.SimpleFormatter

# CMTracer - Aktivieren Sie die folgenden Einträge (durch Entfernen der Kommentarzeichen) nur bei Bedarf,
# da die Traceerstellung ressourcenintensiv sein kann.
#
# Mit den folgenden Zeilen wird die Traceerstellung für das CMTracer-Objekt auf der Stufe "FINER" aktiviert,
# die Traceausgabedatei erhält den Namen "CMTracer[#].log" und wird in das Ausgangsverzeichnis des
# angemeldeten Benutzers gestellt. Die Traceausgabe wird in 20 Dateien, von denen jede auf 20.000.000 Byte
# begrenzt ist, fortgeschrieben. An die aktuelle Traceausgabedatei im Rotationssystem werden Traceeinträge
# angehängt, die in einem einfachen Format verfasst sind.
#
#com.ibm.rational.stp.common.internal.util.CMTracer.level = FINER
#com.ibm.rational.stp.common.internal.util.TraceHandler.pattern = %h/CMTracer%g.log
#com.ibm.rational.stp.common.internal.util.TraceHandler.limit = 20000000
#com.ibm.rational.stp.common.internal.util.TraceHandler.count = 20
#com.ibm.rational.stp.common.internal.util.TraceHandler.append = true
#com.ibm.rational.stp.common.internal.util.TraceHandler.formatter = java.util.logging.SimpleFormatter

Diese Einstellungen bewirken, dass eine Protokolldatei mit dem Namen CMLogger[#].log erstellt wird. [#] steht für die Nummer der Datei im Rotationssystem. Die Dateien befinden sich im Ausgangsverzeichnis des angemeldeten Benutzers. Die Ausgabe wird jeweils von Datei zu Datei fortgeschrieben, sobald eine Datei voll ist.

Die Einträge in der Datei logging.properties aus dem vorherigen Beispiel geben an, dass die Protokoll- und Tracedatensätze an das Ende der gültigen Datei angehängt werden sollen und dass jeder Eintrag in einfachem Format gespeichert werden soll. Sie müssen die Anwendung stoppen und erneut starten, damit die Änderungen an der Datei erkannt werden.

Wenn eine Protokollausgabedatei voll ist, wird eine neue Datei erstellt, und die vorherige Datei wird umbenannt und enhält das Datum und die Zeitmarke der Dateirotation. Jede Datei enthält 20 MB Daten, und neue Einträge werden an die vorhandenen Einträge angehängt, auch nach Neustarts von Anwendungen. Wenn die Anzahl der Protokolldateien den Wert 20 erreicht, bewirkt die Rotation zu einer neuen Datei, dass die älteste Datei gelöscht wird.

Weitere Informationen zum Konfigurieren der Java-Protokollierung finden Sie in der Javadoc-Dokumentation zu java.util.logging.Logger und java.util.logging.FileHandler für Ihr JDK.

Wenn Sie eine Datei mit angepassten Protokolleigenschaften erstellen, müssen Sie die Position der Datei mithilfe des Arguments -D angeben. Beispiel:

java -Djava.util.logging.config.file=C:\myLogPropsFile.properties Ihr_Client-Java-Programm_das_CM-API_verwendet

Feedback