Vorheriges Thema: Wissenswertes über Logger-Konfigurationsdateien

Nächstes Thema: Appender in "eiam.log4net.config"

Appender

Ein Appender enthält Parameter, die die Protokollierung der einzelnen Logger steuern. Standardmäßig enthalten die Logger-Konfigurationsdateien folgende Appender:

SDK

Loggt die SDK-Meldungen in einer Protokolldatei. Gibt den Pfad einschließlich des Dateinamens der Protokolldatei an.

Standard: eiam.cppsdk.log

Hinweis: Wenn Sie Ihre Anwendung über den Tomcat-Server unter Windows bereitstellen, ist darauf zu achten, dass Sie anstelle des Rückwärtsschrägstrichs (\) den Vorwärtsschrägstrich (/) für den Pfad verwenden. Wenn Sie den Rückwärtsschrägstrich verwenden, wird die Protokolldatei nicht unter dem von Ihnen angegebenen Pfad, sondern im Apache Tomcat-Ordner erstellt.

Network

Loggt Meldungen in Bezug auf den Netzwerkaufruf in einer Protokolldatei.

Standard:eiam.network.cpp.log

Performance

Loggt Meldungen in Bezug auf den Performance-Aufruf in einer Protokolldatei.

Standard: eiam.performance.cpp.log

Console

Zeigt die Protokollmeldungen auf der Konsole an.

Der SDK-Appender ist standardmäßig aktiviert. Um andere Appender zu aktivieren, müssen die Kommentar-Strings (<!-- und -->) vom jeweils zugehörigen Code entfernt werden.

Ein Appender besteht aus den folgenden konfigurierbaren Parametern.

file

Gibt den Protokolldateinamen des Appenders an.

append

Gibt an, ob eine Gruppe von Protokollmeldungen an die Protokolldatei angehängt werden. Wird als Wert "wahr" angezeigt, wird die Gruppe von Protokollmeldungen an die letzte Protokollmeldung in der Protokolldatei angehängt.

BufferedIO

Gibt an, ob die aktuellste Protokollmeldung gepuffert wird. Wird als Wert "wahr" angezeigt, werden die aktuellsten Protokollmeldungen im Speicher abgelegt, bevor sie in die Protokolldatei geschrieben werden. Dies reduziert I/O-Operationen auf ein Minimum und ist von Vorteil bei einer höheren Protokollebene.

Wert: [true|false] (wahr/falsch)

Standard: "false" (falsch)

Hinweis: Die Standardgröße von "BufferedIO" lautet "8 KB"..

maxFileSize

Gibt die maximale Größe der Protokolldatei an. Überschreitet eine Protokolldatei die maximale Größe, wird ein neuer Protokolldateiname "log.1" angelegt und der Inhalt der Protokolldatei in die Datei "log.1" übertragen. Die Protokolldatei enthält nun die aktuellsten Protokollmeldungen. Überschreitet diese Datei ebenfalls die maximale Größe, wird ein neuer Protokolldateiname "log.2" angelegt. Der Inhalt aus "log.1" wird in die Datei "log.2" übertragen, und der Inhalt der Protokolldatei wird in die Datei "log.1" übertragen.

Standard: 10MB

Minimum: 10KB

Maximum: 2GB

Hinweis: Die Mindestgröße von "maxFileSize" muss größer oder gleich der Größe von "BufferedIO" sein.

maxBackupIndex

Gibt die maximale Anzahl von Sicherungsprotokolldateien an, die zur Aufbewahrung alter Protokolle verwendet werden. Wenn die Anzahl von Protokolldateien den maximalen Backup-Indexwert überschreitet, wird die Datei mit den ältesten Protokollmeldungen gelöscht.

Standard: 1

Minimum: 1

Maximum: 12

ConversionPattern

Gibt die Formatierung einer Protokollmeldung an. Konfigurieren Sie die Format-Modifikatoren und Umwandlungszeichen, um das Umwandlungsformat zu definieren.

Hinweis: Weitere Informationen zu Umwandlungsformaten finden Sie auf der Website www.apache.org unter dem Thema "log4j".

Beispiel: SDK-Appender

<appender name="SDK" class="org.apache.log4j.RollingFileAppender">
<!-- The active sdk log file -->
<param name="file" value="eiam.cppsdk.log" />
<param name="append" value="true" />
<param name="BufferedIO" value="false"/>
<param name="maxFileSize" value="10000KB" />
<param name="maxBackupIndex" value="1" />
<layout class="org.apache.log4j.PatternLayout">
<!-- The log message pattern -->
<param name="ConversionPattern" value="%5p %d{ISO8601} [%t] [%c] %m%n"/>
</layout>
</appender>