Vorheriges Thema: Wissenswertes über Logger-Konfigurationsdateien

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

Appender

Ein Appender enthält Parameter zur Protokollierung. Standardmäßig enthält die Protokollkonfigurationsdatei die folgenden Appender:

SDK

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

Standard: "eiam.cppsdk.log" für C++ SDK, "EIAM.C#SDK.log" für C# und "eiam.javasdk.log" für Java SDK.

Hinweis: Wenn Sie Ihre Anwendung auf einem Tomcat-Server unter Windows bereitstellen, überprüfen Sie, dass im Pfad Schrägstriche "/" und nicht umgekehrte Schrägstriche "\" verwendet werden. Wenn Sie umgekehrte Schrägstriche verwenden, wird die Protokolldatei nicht an dem Pfad erstellt, den Sie angegeben haben; stattdessen wird die Protokolldatei im Apache Tomcat-Ordner erstellt.

Netzwerk

Protokolliert die auf Netzwerkaufruf bezogenen Meldungen in einer Protokolldatei.

Default: "eiam.network.cpp.log" für C++ SDK, "EIAM.NETWORK.C#SDK.log" für C# SDK und "eiam.javasdk.log" für Java SDK.

Leistung

Protokolliert die auf Leistungsaufruf bezogene Meldungen in einer Protokolldatei.

Standard: "eiam.performance.cpp.log" für C++ SDK, "EIAM.PERFORMANCE.C#SDK.log" für C# SDK und "eiam.performance.java.log"

Konsole

Zeigt die Protokollmeldungen in der Konsole an.

SDK-Appender ist standardmäßig aktiviert. Um andere Appender zu aktivieren, entfernen Sie die Kommentare (<!-- und -->) aus dem jeweiligen Code.

Ein Appender besteht aus den folgenden konfigurierbaren Parametern:

Datei

Gibt den Protokolldateinamen des Appenders an.

anhängen

Gibt an, ob eine Reihe von Protokollmeldungen an die Protokolldatei angehängt wird. Wenn der Wert "true" (wahr) ist, werden die Protokollmeldungen an die letzte Protokollmeldung der Protokolldatei angehängt.

Hinweis: Dieser Parameter wird in der Datei "eiam.log4net.config" "appendToFile" genannt.

BufferedIO

Gibt an, ob die letzte Protokollmeldung zwischengespeichert wird. Wenn der Wert "true" (wahr) ist, werden die letzten Protokollmeldungen im Speicher behalten, bevor sie in die Protokolldatei geschrieben werden. Diese Option minimiert E/A-Vorgänge und ist nützlich, wenn die Protokollebene höher ist.

Wert: [True (Wahr)|False (Falsch)]

Standard: "False" (Falsch)

Hinweis: Der Standardwert für "BufferedIO" lautet "8 KB".

maxFileSize

Gibt die maximale Größe der Protokolldatei an. Wenn eine Protokolldatei die maximale Größe überschreitet, wird eine neue Protokolldatei "log.1" erstellt und der Inhalt der Protokolldatei wird in die Datei "log.1" übertragen. Die Protokolldatei enthält jetzt die letzten Protokollmeldungen. Wenn diese Datei die maximale Größe ebenfalls überschreitet, wird eine neue Protokolldatei "log.2" erstellt, der Inhalt von "log.1" wird auf "log.2" übertragen, und der Inhalt der Protokolldatei wird auf "log.1" übertragen.

Standard: 10 MB

Minimum: 10 KB

Maximum: 2 GB

Hinweis: Der minimale Wert für "maxFileSize" muss mit dem Wert von "BufferedIO" übereinstimmen oder über ihm liegen. Dieser Parameter wird in der Datei "eiam.log4net.config" "maximumFileSize" genannt.

maxBackupIndex

Gibt die Höchstanzahl an Sicherungsprotokolldateien an, die zur Aufbewahrung alter Protokolle dienen. Wenn die Anzahl an Protokolldateien den Wert für "maxSizeRollBackups" überschreitet, wird die Datei mit den ältesten Protokollmeldungen gelöscht.

Standard: 1

Minimum: 1

Maximum: 12

Hinweis: Dieser Parameter wird in der Datei "eiam.log4net.config" "maxSizeRollBackups" genannt.

rollingStyle

Gibt die Kriterien zum Erstellen von Protokolldateien an. Wenn dieser Parameter auf "Größe" festgelegt wird und eine Protokolldatei den Wert für "maximumFileSize" überschreitet, wird eine neue Protokolldatei erstellt und die Inhalte der aktuellen Protokolldatei werden gesichert.

Standard: Größe

ConversionPattern

Gibt das Format der Protokollmeldung an. Konfigurieren Sie die Formatmodifizierer und Umwandlungszeichen, um einen Wert für "ConversionPattern" anzugeben.

Hinweis: Weitere Informationen zu Konvertierungsmustern finden Sie im Abschnitt "log4j" unter www.apache.org.

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="1KB" />
<layout class="org.apache.log4j.PatternLayout">
<!-- The log message pattern -->
<param name="ConversionPattern" value="%5p %d{ISO8601} [%t] [%c] %m%n"/>
</layout>
</appender>