Guida introduttiva a CA EEM › Registrazione in SDK CA EEM › Informazioni sui file di configurazione del registratore › Appender

Appender

un appender contiene parametri che controllano la registrazione di ciascun registratore. Per impostazione predefinita, i file di configurazione del registratore contengono i seguenti appender:

SDK

Registra i messaggi dell'SDK in un file di log Specifica il percorso includendo il nome file del file di log

Impostazione predefinita: eiam.cppsdk.log per C++ SDK, EIAM.C#SDK.log per C#, e eiam.javasdk.log per Java SDK.

Nota: se si esegue la distribuzione dell'applicazione su un server Tomcat in Windows, utilizzare la barra '/' nel percorso invece della barra rovesciata '\'. Se si utilizza la barra rovesciata, il file di log non viene creato nel percorso specificato ma nella cartella Apache Tomcat.

Rete

Registra i messaggi relativi alle chiamate di rete in un file di log.

Impostazione predefinita:eiam.network.cpp.log per C++ SDK, EIAM.NETWORK.C#SDK.log per C# SDK, e eiam.javasdk.log per Java SDK.

Prestazioni

Registra i messaggi relativi alle chiamate inerenti alle prestazioni in un file di log.

Impostazione predefinita: eiam.performance.cpp.log per C++ SDK, EIAM.PERFORMANCE.C#SDK.log per C# SDK, e eiam.performance.java.log

Console

Visualizza i messaggi di log sulla console.

L'appender dell'SDK è attivo per impostazione predefinita. Per attivare altri appender, rimuovere le stringhe di commento (<!-- e -->) dai rispettivi codici.

Un appender comprende i seguenti parametri configurabili:

file

Specifica il nome del file di log dell'appender.

aggiungi

Specifica se un insieme di messaggi di log deve essere aggiunto al file di log. Se il valore è true, il set di messaggi di log viene aggiunto all'ultimo messaggio nel file di log.

Nota: questo parametro è denominato appendToFile nel file eiam.log4net.config

BufferedIO

Specifica se l'ultimo messaggio di log viene memorizzato nel buffer. Se il valore è true, gli ultimi messaggi di log vengono archiviati nella memoria prima di essere scritti nel file di log. Questa opzione consente di ridurre le operazioni di I/O e risulta utile in caso di un livello di log elevato.

Valore: [true|false]

Impostazione predefinita: false

Nota: la dimensione predefinita per BufferedIO è 8 KB.

maxFileSize

Specifica la dimensione massima del file di log Se un file di log supera la dimensione massima, viene creato un nuovo file di log denominato log.1 e i contenuti del file di log vengono trasferiti nel file log.1. Il file di log contiene, quindi, gli ultimi messaggi di log. Se anche questo file supera la dimensione massima, viene creato un nuovo file di log denominato nomefile log.2 e i contenuti del file log.1 vengono trasferiti al file log.2, mentre quelli del file di log continuano ad essere trasferiti al file log.1.

Impostazione predefinita: 10 MB

Minimo: 10 KB

Massimo: 2 GB

Nota: la dimensione minima del parametro maxFileSize deve essere maggiore o uguale alla dimensione del parametro BufferedIO. Questo parametro è denominato maximumFileSize nel file eiam.log4net.config

maxBackupIndex

Specifica il numero massimo di file di log di backup da utilizzare per mantenere i log precedenti. Se il numero di file di log supera il valore di indice massimo di backup, il file viene eliminato con i messaggi di log meno recenti.

Impostazione predefinita: 1

Minimo: 1

Massimo: 12

Nota: questo parametro è denominato maxSizeRollBackups nel file eiam.log4net.config.

rollingStyle

Selezionare i criteri per la creazione dei file di log. Se questo parametro è impostato su Size (Dimensione), nel caso in cui un file di log superi il parametro MaximumFileSize, viene creato un nuovo file di log e il contenuto del file di log corrente viene incluso nel backup.

Impostazione predefinita:Size

ConversionPattern

Specifica la formattazione di un messaggio di log Configurare i modificatori di formato e i caratteri di conversione per definire il modello di conversione.

Nota: per ulteriori informazioni sui modelli di conversione, consultare l'argomento loog4j della pagina Web www.apache.org.

Esempio: appender SDK

<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>