Applicazioni come Apache HTTP Server, IBM WebSphere Application Server, IBM DB2 Universal Database e IBM HTTP Server possono essere configurate per generare log in un formato adatto per essere analizzato con un programma di analisi dei log.
Segue un elenco di configurazioni di applicazioni che possono essere di aiuto a formattare i log in modo tale che possano essere analizzati con i programmi di analisi forniti con gli strumenti.
Nota: gli eventi log contenuti in questi file di log possono essere analizzati utilizzando un database di sintomi per interpretare eventi e condizioni di errore noti. Un database di sintomi può essere utilizzato per ottenere informazioni dettagliate sulla risoluzione degli errori e sul significato degli eventi. Per ulteriori informazioni sul database di sintomi e sulle relative istruzioni su come importarlo e utilizzarlo, consultare gli argomenti correlati alla fine di questo file.
Il file di configurazione di Apache ha il nome /www/apachedft/conf/httpd.conf sul server iSeries. Per abilitare i log degli errori e degli accessi, in questo file dovrebbero essere incluse le seguenti istruzioni:
# ErrorLog: l'ubicazione del file di log degli errori. Se non inizia # con /, si assume che sia ServerRoot. ErrorLog ./logs/error.log # LogLevel: controlla il numero di messaggi registrati in error.log. # Possibili valori includono: debug, info, notice, warn, error, crit, # alert, emerg. LogLevel warn # Le seguenti istruzioni definiscono alcuni soprannomi di formati # per l'uso con una istruzione CustomLog (svedi sotto). LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined LogFormat "%h %l %u %t \"%r\" %>s %b" common LogFormat "%{Referer}i -> %U" referer LogFormat "%{User-agent}i" agent # L'ubicazione del file log degli accessi (Common Logfile Format). # Se non inizia con /, si assume che sia ServerRoot. CustomLog ./logs/access.log common
Le due sezioni precedenti con il testo in neretto definiscono dove sono memorizzati rispettivamente il log degli errori e il log degli accessi in ambiente Apache. In questo caso, ad esempio, se ServerRoot è /www/apachedft, i log vengono memorizzati nella subdirectory /www/apachedft/logs/ e hanno come nome rispettivamente error.log.* e access.log.*. Il suffisso finale del nome del file dipende dalla data (ad esempio il primo error.log. del 31 dicembre 2003 avrà come nome qualcosa di simile a Q103123100).
Dopo aver modificato il file di configurazione di Apache, è necessario riavviare il server Apache per rendere attive le modifiche. Dalla riga comandi dell'OS400 immettere STRTCPSVR SERVER(*HTTP) INSTANCE(APACHEDFT)
Invece, per chiudere il server Apache, dalla riga comandi dell'OS400, immettere: ENDTCPSVR SERVER(*HTTP) INSTANCE(APACHEDFT)
#----------------------------------------------------------------------------------------------- # Proprietà del log delle attività # # AVVERTENZA Prima di modificare qualsiasi proprietà del Log delle attività, arrestare # tutti i server sul nodo fisico, incluso AdminServers # # com.ibm.ws.ras.AcvitityLogEnabled: proprietà usata per determinare se i server su # questo nodo devono registrare gli eventi Ras nel log delle attività. Valori # validi sono true e false; true è il valore predefinito. # Disattivando la registrazione si potrebbero causare problemi seri al servizio. # # com.ibm.ws.ras.ActivityLogSize : dimensioni del log delle attività in kilobytes. # Il valore predefinito è 1024, che genera un file di log di 1 megabyte. Per impostare # le dimensioni di questo log, vedere la guida alla determinazione dei problemi. #------------------------------------------------------------------------------------------------
com.ibm.ws.ras.ActivityLogEnabled=true
com.ibm.ws.ras.ActivityLogSize=1024
Note:
com.ibm.ws.http.HttpConnection=entry
Exit=enabled:
com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
Exit=enabled,
event=enabled
com.ibm.ws.http.HttpConnection=entry
Exit=enabled:
com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
Exit=enabled,
event=enabled
Nota: per impostazione predefinita, ${LOG_ROOT} è WAS_HOME\logs\ dove WAS_HOME corrisponde a:
Per V5.0:
com.ibm.ws.http.HttpConnection=entry Exit=enabled: com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry Exit=enabled, event=enabled
Per V6.0:
com.ibm.ws.http.HttpConnection=entry Exit=enabled: com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry Exit=enabled, event=enabled com.ibm.ws.http.HttpConnection=finer:com.ibm.ws.webcontainer.srp.ServletRequestProcessor=finer
Nota: per impostazione predefinita ${SERVER_LOG_ROOT} è WAS_HOME\logs\nome_server\ dove nome_server è il nome del nodo a cui verrà applicata la configurazione del log di traccia e WAS_HOME corrisponde a:
IBM WebSphere Application Server per z/OS può essere configurato per registrare gli eventi del log degli errori su un flusso di log o sul data set SYSOUT del processo MVS di WebSphere Application Server MVS. Seguire le istruzioni riportate sotto per copiare gli eventi del log degli errori in un file che può essere analizzato e importato nel Log Analyzer. Il Log Analyzer può analizzare e importare i file di log degli errori di WebSphere Application Server per z/OS sia V4.0 che V5.0.
Nota: i file di log degli errori di IBM WebSphere Application Server per z/OS non possono essere importati da data set MVS. Questi file si devono trovare nel file system di UNIX System Service.
Nota: le indicazioni orarie degli eventi del log degli errori sono riportate con l'ora GMT. È necessario configurare WebSphere Application Server per z/OS in modo da registrare le ore GMT negli eventi del log degli errori. Questa è la configurazione predefinita. Se il sistema è configurato per registrare l'ora locale negli eventi del log degli errori, le informazioni sul fuso orario mostrate nella proprietà creationTime degli eventi nella Vista log saranno errate.
ex 'BBO.SBBOEXEC(BBORBLOG)' 'BBO.BOSSXXXX NOFORMAT'
dove
oput 'myuserid.BBO.BOSSXXXX' '/waserror.log'
oput 'myuserid.WASERROR.LOG' '/waserror.log'
Nota: i file di log degli errori di IBM WebSphere Application Server per z/OS possono essere associati solo in base all'ora.
# L'ubicazione del file log degli accessi (Common Logfile Format). # Se non inizia con /, si assume che sia ServerRoot. CustomLog logs/access.log common
Note:
# ErrorLog: l'ubicazione del file di log degli errori. Se non inzia # con /, si assume che sia ServerRoot. ErrorLog logs/error.log # LogLevel: controlla il numero di messaggi registrati in error.log. # Possibili valori includono: debug, info, notice, warn, error, crit, alert, emerg. LogLevel warn
Note:
La configurazione predefinita di DB2 scrive tutti gli errori e i messaggi di avviso nel file di log db2diag.log. Il file si trova nei seguenti percorsi:
Per gli ambienti Windows supportati:
- Se la variabile di ambiente o la parola chiave DB2INSTPROF non è impostata, le informazioni verranno scritte in X:\sqllib_dir\DB2INSTANCE, dove x:\sqllib_dir è il percorso specificato nella variabile di registro o nella variabile di ambiente DB2PATH e DB2INSTANCE è il nome del proprietario dell'istanza.
- Se la variabile di ambiente o la parola chiave DB2INSTPROF è impostata, le informazioni verranno scritte in X:\DB2INSTPROF\DB2INSTANCE, dove DB2INSTPROF è il nome della directory di profilo dell'istanza e DB2INSTANCE è il nome del proprietario dell'istanza.
Per ambienti basati su UNIX: INSTHOME/sqllib/db2dump, dove INSTHOME è la directory home del proprietario dell'istanza.
La variabile DIAGPATH, specificata nella configurazione del gestore del database, fornisce il percorso completo per la prima directory di archiviazione dati di errore, FFDC (first failure data capture). Il valore predefinito per DIAGPATH è una stringa nulla. Per modificare il valore di DIAGPATH, utilizzare il seguente comando:
DB2 UPDATE DBM CFG USING DIAGPATH path
Seguire le seguenti istruzioni:
La quantità di informazioni da scrivere nel file log di diagnostica (db2diag.log) può essere configurata seguendo le seguenti istruzioni:
La console di gestione di WebSphere Application Server consente di configurare quante informazioni relative a JDBC devono essere registrate. Esistono due modi per registrare i messaggi di log JCC:
Seguire le seguenti istruzioni:
Seguire le seguenti istruzioni:
Per la connettività JDBC 2 dall'origine dati, utilizzare i metodi setLogWriter() e setTraceLevel() sull'oggetto com.ibm.db2.jcc.DB2SimpleDataSource. Questi metodi abilitano completamente il livello di traccia predefinito.
È possibile abilitare la traccia JDBC 1 con il gestore driver
java.sql.DriverManager.setLogWriter(), o in alternativa un traceFile
può essere incorporato in un URL del database JDBC 1.
Ad esempio:
String databaseURL =
"jdbc:db2://hal:50000/sample:traceFile=c:/temp/foobar.txt;traceLevel=" +
(com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DRDA_FLOWS |
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_CONNECTS) + ";";
Per entrambe le connettività JDBC 1 e JDBC 2, è possibile attivare e disattivare la traccia su una connessione utilizzando il metodo proprietario DB2Connection.setJCCLogWriter(java.io.PrintWriter logWriter, int traceLevel). È inoltre possibile utilizzare questo metodo per modificare il programma di scrittura del log o per regolare il livello di traccia su una connessione attiva. Se si utilizza il metodo javax.sql.DataSource.setLogWriter(java.io.PrintWriter logWriter), viene applicato il livello di traccia predefinito (abilitazione completa). È possibile disabilitare la traccia impostando il programma di scrittura su null.
Per ulteriori dettagli sulla creazione delle informazioni di traccia per il driver Universal JDBC, fare riferimento alla documentazioen del DB2.
Dopo aver completato tutte le attività sopra riportate, il file di log particolare può essere importato nel prodotto utilizzato (File > Importa...).
IBM WebSphere Application Server per iSeries consente di utilizzare più istanze server, ciascuna con una diversa configurazione. La subdirectory dove viene definita l'istanza dipende da entrambe le versioni di IBM WebSphere Application Server installate e dal nome dell'istanza server.
Ad esempio, se si desidera visualizzare le impostazioni di registrazione su una macchina iSeries con IBM WebSphere Application Server Express V5.0 per un'istanza server con nome predefinito, il file server.xml deve essere memorizzato nella seguente ubicazione:
/QIBM/UserData/WebASE/ASE5/default/config/cells/myhostname/nodes/mynodename/servers/server1/server.xml.
Questo file server.xml contiene le specifiche di registrazione.
<services xmi:type="loggingservice.ras:RASLoggingService" xmi:id="RASLoggingService_1" enable="true" messageFilterLevel="NONE" enableassociationId="true"> <serviceLog xmi:id="ServiceLog_1" name="${LOG_ROOT}/activity.log" </services>
Il log delle attività, (in base all'esempio precedente) è incluso nel file /QIBM/UserData/WebASE/ASE5/default/logs/activity.log.
<services xmi:type="traceservice:TraceService" xmi:id="TraceService_1" enable="true" traceOutputType="SPECIFIED_FILE" traceFormat="BASIC" memoryBufferSize="8"> </services>
In base all'esempio precedente, verrà creato un log di traccia nel file /QIBM/UserData/WebASE/ASE5/default/logs/server1/trace.log.
stopServer -instance default
3. Riavviare il server
startServer -instance default
Concetti correlati
Determinazione dei problemi nelle applicazioni distribuite
utilizzando l'Analizzatore di log e di traccia
Elaborazione autonomica dei database dei sintomi
Attività correlate
Importazione di un file di log
Importazione e utilizzo di un database dei sintomi AC
(C) Copyright IBM Corporation 2000, 2005. Tutti i diritti riservati.