Argomento precedente: Informazioni sui file di configurazione del registratore

Argomento successivo: Appender in eiam.log4net.config

Appender

Un appender include parametri che controllano la registrazione di ogni registratore. Per impostazione predefinita, i file di configurazione del registratore includono gli appender seguenti:

SDK

Consente di registrare i messaggi SDK in un file di registro. Specifica il percorso che include il nome del file di registro.

Impostazione predefinita: eiam.cppsdk.log

Nota: se si sta distribuendo l'applicazione server Tomcat su Windows, assicurarsi di utilizzare nel percorso la barra '/' anziché la barra '\'. Se si utilizza quest'ultima, il file di registro non viene creato nel percorso specificato ma nella cartella Apache Tomcat.

Rete

Consente di registrare i messaggi relativi alla chiamata di rete in un file di registro.

Impostazione predefinita:eiam.network.cpp.log

Prestazioni

Consente di registrare i messaggi relativi alla chiamata di rete in un file di registro.

Impostazione predefinita:eiam.network.cpp.log

Console

I messaggi di registro vengono visualizzati sulla console.

Per impostazione predefinita, l'appender SDK è disabilitato. Per abilitare gli altri appender, rimuovere le stringhe di commento (<!-- and -->) dal rispettivo codice.

Un appender è costituito dai seguenti parametri configurabili:

file

Specifica il nome file di registro dell'appender.

append

Specifica se viene aggiunto al file di registro un set di messaggi di registro. Se il valore è true, questo set viene aggiunto all'ultimo messaggio di registro nel file di registro.

BufferedIO

Specifica se è stato eseguito il buffer sul messaggio di registro più recente. Se il valore è true, i pochi messaggi di registro più recenti vengono conservati in memoria prima che vengano scritti sul file di registro. Ciò riduce al minimo l'operazione IO e risulta vantaggioso se il livello di registro è più elevato.

Valore: [true|false]

Valore predefinito: false

Nota: il valore predefinito per BufferedIO è 8.

MaxFileSize

Specifica la dimensione massima del file di registro. Se un file di registro supera le dimensioni massime, viene creato un nuovo nome del file di registro, log.1, nel quale vengono trasferiti i contenuti del file di registro. Adesso il file di registro contiene i messaggi di registro più recenti. Se questo file supera le dimensioni massime, viene creato un nuovo nome del file di registro, log.2. I contenuti di log.1 verranno trasferiti al file log.2 e quelli del file di registro al file log.1.

Predefinito: 10 MB

Dimensione minima: 10KB

Dimensione massima: 2GB

Nota: la dimensione minima del maxFileSize deve essere superiore o uguale alla dimensione di BufferedIO.

maxBackupIndex

Specifica il numero massimo dei file di registro di backup utilizzati per mantenere i registri datati. Se il numero di file di registro supera il valore massimo di indice di backup, il file contenente i messaggi di registro più datati viene eliminato.

Impostazione predefinita: 1

Minimo: 1

Massimo: 12

ConversionPattern

Specifica la formattazione di un messaggio di registro. Per definire il modello di conversione, configurare il modificatore di formato e i caratteri di conversione.

Nota: per ulteriori informazioni sui modelli di conversione, fare riferimento all'argomento log4j in www.apache.org.

Esempio: appender SDK

<appender name="SDK" class="org.apache.log4j.RollingFileAppender">
<!-- File di registro sdk attivo -->
<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">
<!-- Modello file di registro -->
<param name="ConversionPattern" value="%5p %d{ISO8601} [%t] [%c] %m%n"/>
</layout>
</appender>