Configurazione della registrazione di CM API

È possibile configurare la registrazione di CM (Change Management) API.

Informazioni su questa attività

La registrazione di CM API è controllata tramite il file logging.properties che è associato al JRE su cui viene eseguita l'applicazione. Il file logging.properties si trova nella jre\lib di JDK; ad esempio, C:\Program Files\IBM\WebSphere\AST\eclipse\jre\lib, C:\jdk_5.0\jre\lib o C:\Program Files\Java\jre1.5.0_06\lib).

La registrazione è disabilitata per impostazione predefinita. La registrazione dovrebbe essere abilitata al livello INFO.

Il seguente file di esempio logging.properties illustra come configurare le impostazioni di log per le applicazioni basate su CM API:
############################################################
#      Proprietà globali
############################################################
#
# "handlers" specifica un elenco separato da virgole di classi di gestori 
# di log.  Questi gestori saranno installati durante l'avvio della VM.
# Si noti che è necessario che queste classi si trovino sullo stesso percorso classe di sistema.
# Per impostazione predefinita viene configurata solo una ConsoleHandler, che
# visualizzerà solo messaggi a livelli di INFO o superiori.
handlers = java.util.logging.ConsoleHandler

# Per aggiungere anche FileHandler, invece, utilizzare la seguente riga.
#handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

# Livello di registrazione globale predefinito.
# Specifica i tipi di eventi registrati su
# tutti i logger.  Per qualsiasi funzione data, questo livello globale
# può essere sovrascritto da un livello specifico di funzione
# Si noti che ConsoleHandler dispone inoltre di un'impostazione
# di livello separato per limitare i messaggi stampati alla console.
# La riga successiva consente la registrazione (di tutti gli oggetti logger) a livello di INFO
.level=INFO

############################################################
# Proprietà specifiche del gestore.
# Descrive informazioni di configurazione specifiche per i gestori.
############################################################

# CMLogger - Deve essere sempre abilitato a livello di INFO. 
#
# Le seguenti righe indicano che la registrazione dell'oggetto CMLogger avviene a livello di INFO
# e che il file di output di log sarà denominato CMLogger[#].log e ubicato nella directory HOME
# dell'utente che ha effettuato l'accesso; il file di output di log sarà fatto ruotare su 20 file, ognuno dei quali
# è limitato a 20000000 byte.  Le voci di log saranno accodate al file di output del log corrente
# nella rotazione e saranno scritte utilizzando un formato semplice.
#
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 - Abilitare (Eliminare il simbolo di commento) le voci che seguono solo all'utilizzo temporaneo perché la traccia
# può utilizzare molte risorse.  
#
# Le seguenti righe indicano che la traccia dell'oggetto CMTracer avviene a livello di FINER,
# e che il file di output di traccia sarà denominato CMTracer[#].log e ubicato nella directory HOME
# dell'utente che ha effettuato l'accesso; il file di output di traccia sarà fatto ruotare su 20 file, ognuno dei quali
# è limitato a 20000000 byte.  Le voci di traccia saranno accodate al file di output di traccia corrente
# nella rotazione e saranno scritte utilizzando un formato semplice.
#
#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

Queste impostazioni risultano in un file di log denominato CMLogger[#].log, dove [#] indica il numero di rotazione del file. Ogni file è ubicato nella directory HOME dell'utente che ha effettuato l'accesso; l'output passa da un file all'altro mano a mano che ciascuno raggiunge la dimensione massima.

L'utilizzo delle voci logging.properties nell'esempio precedente indica che i record di log sono accodati all'estremità del file applicabile e che ciascuna voce viene memorizzata in formato semplice. È necessario arrestare e riavviare l'applicazione perché vengano riconosciute le modifiche al file.

Quando un file di output di log ha raggiunto la dimensione massima, viene creato un nuovo file e quello precedente viene rinominato per contenere l'indicazione di data e ora in cui è stata eseguita la rotazione. Ogni file contiene 20 MB di dati e le voci nuove vengono accodate a quelle esistenti, compresi i riavvii delle applicazioni. Quando il conteggio dei file di log raggiunge il valore 20, la rotazione a un nuovo file determina l'eliminazione del file meno recente.

Per ulteriori informazioni su come configurare la registrazione Java, consultare la documentazione Javadoc associata a JDK per java.util.logging.Logger e java.util.logging.FileHandler.

Se si crea un file delle proprietà di log personalizzato, è necessario specificarne l'ubicazione utilizzando l'argomento -D. Ad esempio:

java -Djava.util.logging.config.file=C:\myLogPropsFile.properties your_client_java_program_that_uses_CM-API

Feedback