© Copyright International Business Machines Corporation 2000, 2006. Tutti i diritti riservati. Limitazioni previste per gli Utenti del Governo degli Stati Uniti - L'uso, la duplicazione o la divulgazione sono limitati dal GSA ADP Schedule Contract con la IBM Corp.
1.0 Analizzatore di log e di traccia
1.1 Visti
1.1.1 Problemi con le funzioni di filtro e di evidenziazione
nella vista Log
1.2 Importazione log
1.2.1 Problemi durante l'importazione di file di log remoti
1.2.2 Importazione file di log su Linux e AIX
1.2.3 Importazione del file trace.log di WebSphere Application Server
1.2.4 Impossibile importare alcuni file di log utilizzando IBM Agent Controller V5
1.2.5 Eccezione di memoria esaurita durante l'importazione di file di log e cataloghi di sintomi
di grandi dimensioni
1.2.6 I Common Base Events visualizzati per i log di DB2 Express Diagnostic non rispettano la specifica
1.2.7 L'analizzatore di log e traccia non effettua nessuna convalida sul tipo di file da importare
1.2.8 Limitazioni nell'importazione dei file di log generati con impostazioni internazionali diverse
1.2.9 L'importazione di WebSphere Application Server Activity Log con il programma di regole da AIX non riesce
1.2.10 Impossibile creare una correlazione basata sulla data/ora con Apache Derby version 10.1.2.1
1.2.11 Rallentamento delle prestazioni durante la creazione e la visualizzazione della correlazione per log di grandi dimensioni
1.3 Supporto al database
1.3.1 L'accesso simultaneo dei client mediante l'utilizzo dello stesso account del database non viene supportato
1.3.2 Conflitto del percorso risorse
1.3.3 Le preferenze del Supporto risorse di grandi dimensioni resta disabilitato nonostante la selezione valida
1.3.4 Miglioramento delle prestazioni del supporto log di grandi dimensioni
1.3.5 Riavviare DB2 dopo la creazione di database e tabelle
1.3.6 Eccezione SQL intermittente
1.3.7 La verifica della connessione restituisce un errore se non sono state applicate le preferenze
1.3.8 L'espressione XPath CommonBaseEvent non è supportata durante l'analisi di log di grandi dimensioni
1.3.9 Viene visualizzato solo un contextDataElement per i log di grandi dimensioni
1.4 Altro
1.4.1 Procedura guidata Nuova correlazione log non visualizzata correttamente sul driver Linux GTK
1.4.2 Modifiche ai livelli di registrazione del plugin dopo il primo avvio del workbench non rispettate
1.4.3 Arresto anomalo durante la creazione di un esempio su Red Hat Linux v8.0 con IBM JVM
1.4.4 È possibile creare solo database dei sintomi di formato TPTP dalla barra degli strumenti e dal menu a comparsa del pannello Selezione
1.4.5 L'analizzatore log IBM elabora solo i messaggi con dimensioni fino a 1024 byte
1.4.6 Symptom Editor genera le regole XPATH che non sono valide
durante l'utilizzo degli elementi complessi
1.4.7 Symptom Editor genera regole XPATH che non corrispondono
a nessun input di Common Base Events
2.0 Strumento di creazione profili
2.1 Viste Interazione Agente e Interazione processi non supportate dalla vista Diagramma di sequenza
2.2 I comandi delle viste Aggiornamento della Selezione profili non funzionano
per le interazioni traccia
2.3 La creazione profili su Windows utilizzando Sun JDK 1.4.x può terminare con una segnalazione errori Microsoft(R)
Ulteriori informazioni associate all'Analizzatore di log e di traccia TPTP sono disponibili nella sezione
TPTP V4.2 - Note sul rilascio.
Nella vista Log, le funzioni di filtro e di evidenziazione non funzionano su elementi complessi del Common Base Event (ad esempio, sourceComponentId). Verrà fornita una correzione nella prossima fix pack.
Quando si importa un file di log remoto (File > Importa... > File di log), nella vista Log non viene visualizzata alcuna voce del log dopo aver aggiornato le viste del Controllo creazione profili (Profilo > Aggiorna viste) oppure viene visualizzata la finestra Messaggio di registrazione log che indica che il client locale non ha avviato il controllo del programma di analisi log remoto dopo aver atteso 30 secondi.
Questo problema è causato dalla latenza della rete e può essere risolto aumentando l'intervallo di tempo in cui Agent Controller attende che client locale avvii il controllo del programma di analisi di log remoto. Per risolvere questo problema, procedere come segue:
<Application configuration="default" executable="RemoteLogParserLoader" extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%"> ... <Parameter position="prepend" value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/> ... </Application>dove xxxxx è l'intervallo di attesa massimo in millisecondi (ad esempio, maggiore di 30000).
L'importazione di alcuni file di log non funziona sulle piattaforme Linux(R) ed AIX(R).
Questo accade quando l'utente non dispone delle autorizzazioni adatte per accedere ai file di log. Per risolvere questo problema, copiare i file di log nella directory home dell'utente ed importarli da questo percorso.
1.2.3 Importazione del file trace.log di WebSphere Application ServerQuando viene importato il file trace.log di WebSphere(R) Application Server viene creata una correlazione interna.
L'utente non dovrebbe eliminare tali correlazioni in quanto contengono informazioni relative alla struttura interna dell'agente corrispondente.
1.2.4 Impossibile importare alcuni file di log utilizzando IBM Agent Controller V5Non è possibile importare file di log remoti diversi da activity.log utilizzando IBM(R) Agent Controller V5. Quando si importano file di log remoti, IBM Agent Controller sulla macchina remota deve avere lo stesso livello o un livello superiore all'analizzatore di log e di traccia IBM per Eclipse.
Per risolvere questo problema, installare IBM Agent Controller fornito con l'Analizzatore di log e di traccia IBM per Eclipse sulla macchina remota.
1.2.5 Eccezione di memoria esaurita durante l'importazione di file di log e cataloghi di sintomi di grandi diemensioniÈ possibile importare nello spazio di lavoro file di log e cataloghi di sintomi di dimensioni fino a 25MB ed aprirli con l'analizzatore di log e di traccia.
Il tempo necessario per aprire il file di log dipende dal numero di record di log in esso contenuti ed è possibile che si produca l'eccezione "Memoria non sufficiente". Per risolvere questo problema, utilizzare funzioni che supportano log di grandi dimensioni.
Se si riceve un eccezione di "memoria esaurita" durante l'importazione di cataloghi di sintomi di grandi dimensioni, aumentare le dimensioni di heap mediante l'aggiunta del seguente vmargs:
-vmargs -Xmx1000m
Se l'utilizzo della funzione di supporto di log di grandi dimensioni non risolve il problema dell'eccezione di "memoria esaurita" durante l'importazione di log di grandi dimensioni, l'aumento delle dimensioni di heap dovrebbe bastare.
Se si importa un log di diagnostica IBM DB2(R), i Common Base Event visualizzati nell'analizzatore di log e di traccia non rispettano tutte le specifiche di Common Base Event. Questo accade a causa di un difetto nell'utilità db2diag.exe utilizzata per convertire i log di diagnostica DB2 in Common Base Events. L'operazione di importazione non dovrebbe essere influenzata da questa condizione. Attualmente, non esiste alcuna soluzione per questo problema e bisogna attendere che db2diag.exe venga corretto.
L'analizzatore di log e traccia non effettua nessuna convalida sul tipo di file da importare. Quando si importano file di log, assicurarsi di aver scelto il tipo di log e versione corretti per il log importato. Se si verifica un problema durante l'importazione, non verrà visualizzato alcun record o record non corretto nella vista Log, ma verrà visualizzato un messaggio di errore. Per informazioni più dettagliate sull'errore, visualizzare i dettagli dalla relativa finestra di dialogo.
Quando si importano file di log che contengono indicazioni di data/ora con impostazioni internazionali diverse da quelle in cui viene eseguito l'analizzatore di log e traccia, il programma di analisi dei file di log basato su regole, a volte non analizza l'indicazione di data/ora ed altri record di log correttamente. Ad esempio, quando si importa un file di log degli accessi inglese di IBM HTTP Server in un programma di analisi di log e traccia in esecuzione su macchina Giapponese i valori di creationTime negli Common Base Event risultanti, avranno valore zero e il campo msg del Common Base Event sarà vuoto.
Per risolvere questo problema, durante l'importazione di file di log contenenti indicazioni di data/ora espresse in base ad impostazioni internazionali diverse da quelle utilizzate nel computer, specificare le impostazioni internazionali del file di log sulla scheda dei Dettagli nella procedura guidata Importazione log, se esiste un campo per le impostazioni internazionali.
L'importazione di un log binario di un'attività di WAS con il programma di analisi delle regole da un sistema AIX riporta il seguente errore visualizzato nella relativa finestra di dialogo:
IWAT0030E Si è verificato un errore durante l'esecuzione del programma di analisi log remoto "com.ibm.etools.logging.adapter.config.StaticParserExtension": IWAT0412E Si è verificato un errore durante l'analisi del file di log /home/tfoun/logs/activity.log. java.lang.Exception: IWAT0239E Il comando del Converter non è riuscito: java.lang.Exception: IWAT0238E Il processo del Converter è terminato con il valore di uscita 1
Il comando del converter per convertire il file di log in testo perché venga analizzato non riesce su AIX. Per risolvere tale problema, utilizzare il programma di analisi statico per importare il file di log binario dell'attività oppure convertirlo in testo, utilizzando il programma di utilità showlog di WAS, ed importare il file di testo risultante nell'Analizzatore di log e di traccia. Il programma di utilità showlog di WAS può essere trovato nella directory bin della directory di installazione di WAS. Ad esempio, utilizzare il seguente comando per convertire il file di log binario in un file di testo denominato activity.txt:
/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt
Quindi importare activity.txt nell'analizzatore di log e di traccia.
Sebbene non sia ufficialmente supportato da TPTP, un utente di TPTP ha provato ad utilizzare Derby 10.1.2.1 insieme ad un supporto log di grandi dimensioni, e si è verificato tale problema. Durante il tentativo di creazione di una correlazione basata sulla data/ora con un log di grandi dimensioni, si è verificata un'eccezione ArrayIndexOutOfBoundsException, che ha fatto si che la correlazione venisse continuamente eseguita senza interruzione. Questo è un problema noto di Derby, risolto in Derby version 10.2.0.0. Per ulteriori informazioni, consultare la descrizione del problema di Derby su http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html.
Da notare che questa eccezione si verifica sul lato server e non viene visualizzato sul workbench dell'utente. Viene visualizzato nella finestra dei comandi in cui viene eseguito il comando di avvio del server Derby.
Durante la creazione o visualizzazione di una correlazione per un log di grandi dimensioni, le prestazioni potrebbero rallentare con Apache Derby e DB2.
Per migliorare le prestazioni durante la creazione di una correlazione, importare i log con un filtro di importazione così che eventi inutili o non correlati non vengano inclusi nel database. L'utilizzo di un filtro "Mostra solo eventi correlati" può migliorare le prestazioni durante l'apertura della correlazione nella vista Interazioni di log.
Accessi contemporanei dei client ad un database potrebbe bloccare alcune tabelle. Per sbloccare le tabelle, riavviare il workbench e il server del database.
Se si utilizza lo stesso database e l'account del database per più spazi di lavoro, si potrebbero verificare dei conflitti di percorso della risorsa e la risorsa non resterà permanentemente nel database.
Per risolvere tale problema, utilizzare nomi progetto e di controllo diversi in ogni spazio di lavoro per evitare conflitti di percorso della risorsa.
In Linux/GTK, sulla pagina delle preferenze Supporto delle risorse di grandi dimensioni, i campi per le impostazioni del database resteranno disattivati persino quando viene selezionato un tipo di database valido.
Per risolvere tale problema, selezionare DB2 come tipo di database ed applicare le impostazioni. Chiudere e riaprire la finestra di dialogo delle preferenze; i campi saranno attivati.
Per migliorare le prestazioni del supporto log di grandi dimensioni, eseguire il seguente comando dopo aver importato i log di grandi dimensioni:
db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sqldove x_x_x è il numero della versione sulla directory del plug-in.
Dopo aver eseguito lo script di creazione del database e delle tabelle, CreateDatabaseAndTablesDB2-8.1.sql, è necessario riavviare DB2. Da una finestra dei comandi di DB2 eseguire db2stop, quindi db2start per poter applicare le modifiche ai parametri di configurazione eseguite dallo script.
Talvolta, si può verificare la seguente eccezione SQL:
com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031
Quando si verifica tale problema, riavviare il workbench e il database, se si sta utilizzando DB2 o CloudscapeTM in modalità di rete. I log importati quando si verifica tale eccezione non saranno validi; e dovranno essere importati nuovamente.
Nella pagina Supporto log di grandi dimensioni della sezione Creazione profilo e log della finestra di dialogo delle preferenze, se si fa clic su Verifica connessione prima di aver applicato le modifiche alle impostazioni, si potrebbe rilevare un errore di connessione. Per evitare tale problema, fare clic su Applica dopo aver effettuato qualsiasi modifica alle impostazioni e quindi fare clic su Verifica connessione.
La seguente espressione XPath non viene supportata da Analizzatore log IBM durante l'analisi di log di grandi dimensioni.
<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>
Se viene utilizzato DB2 per il supporto log di grandi dimensioni, viene visualizzato nella vista Log solo un contextDataElement per un evento, anche se vi sono più contextDataElements per tale evento.
Nella procedura guidata Nuova correlazione log, viene mostrato solo l'elenco Log disponibili ed è vuoto. Questo accade perché viene visualizzata solo la parte sinistra della pagina della procedura guidata.
Per risolvere questo problema, regolare la dimensione della pagina della procedura guidata in modo da visualizzare l'elenco Log selezionati e i pulsanti di azione. Un'altra soluzione consiste nel selezionare i file di log per correlazione nella vista Selezione log prima di fare clic sul pulsante Nuova correlazione log.
Se si modifica il livello di registrazione log di un plugin nel rispettivo file plugin.xml (mediante i punti di estensione com.ibm.etools.common.logging.commonLoggingOptions o com.ibm.etools.logging.util.loggingOptions) dopo il primo avvio del workbench, la modifica non viene rispettata negli avvii successivi del workbench. Il livello di registrazione specificato nel file plugin.xml del plugin viene memorizzato nella cache dal runtime Eclipse al primo avvio del workbench. Gli avvii successivi del workbench utilizzeranno il valore memorizzato nella cache come livello di registrazione del plugin nonostante le modifiche apportate al file plugin.xml.
Per risolvere questo problema, riavviare il workbench con l'argomento della riga comandi -clean. Questa opzione cancellerà i dati contenuti nelle cache utilizzate per archiviare la risoluzione di dipendenza degli insiemi e i dati di registro di estensioni e forzerà Eclipse a inizializzare nuovamente tali cache. Aggiungere l'opzione dopo eclipse.exe nella <directory di installazione del workbench>\eclipse\ac.bat (Windows(R)) o nella<directory di installazione>/eclipse/ac.sh (Linux). In alternativa, è possibile modificare il livello di registrazione del plugin nella pagina delle preferenze Registrazione log (Finestra > Preferenze > Registrazione log) e riavviare il workbench.
Quando si crea un esempio nell'analizzatore di log e traccia utilizzando la procedura guidata Creazione esempi (Nuovo > Esempio), si verifica un arresto anomalo del workbench. Questo accade quando la procedura guida Creazione esempi tenta di aprire il file readme.html come parte delle operazioni di creazione. Tale problema si verifica su Red Hat Linux v8.0 con JVM (IBM JavaTM Virtual Machine), ed è un problema di SWT (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).
Per risolvere questo problema, aggiungere -Xj9 come argomento JVM in ac.sh per eseguire l'avvio utilizzando IBM J9 JVM (ad esempio, ./eclipse -vmargs -Xj9 -Xmx500m). Per ulteriori informazioni sull'esecuzione di SWT su Red Hat Linux v8.0, consultare le Domande frequenti (FAQ) di SWT (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).
Nota: come indicato nella tabella delle piattaforme di riferimento Eclipse (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), sono supportati solo i seguenti sistemi Linux: versione 2.2.1 di GTK+ widget toolkit e librerie associate (GLib, Pango); il visualizzatore SWT HTML richiede Mozilla 1.4GTK2. Per Motif su altri sistemi Linux: Open Motif 2.1 (incluso); il visualizzatore SWT HTML richiede Mozilla 1.4GTK2.
A causa di una limitazione di TPTP, gli utenti non potranno creare entrambi i tipi di database dei sintomi utilizzando il pulsante della barra degli strumenti del pannello di selezione log o dal menu di scelta rapida. Una soluzione consiste nel selezionare File > Nuovo > Altro > Creazione profili e log dal menu del workbench e scegliere il tipo di database dei sintomi che si desidera creare.
Nelle regole di XPATH e nelle regole di correlazione di IBM, la stringa nella proprietà di Common Base Event msg non deve essere superiore a 1024 byte. Se la stringa è superiore a 1024 byte, non verranno elaborate dall'analizzatore log IBM.
Durante l'utilizzo di elementi complessi di Common Base Event (ad esempio, sourceComponentID), Symptom Editor genera delle regole di XPATH che non sono valide. Verrà fornita una correzione nella prossima fix pack.
Se alcuni ExtendedDataElement vengono selezionati durante la creazione di una nuova espressione XPATH,
il catalogo dei sintomi che ne risulta contiene
extendedDataElement
invece di extendedDataElements
.
Come risultato, Symptom Editor genera regole XPATH che non corrispondono
a nessun input di Common Base Events
La vista Interazioni Agente e Interazione processi non sono supportate dalla vista Diagramma di sequenza per i file di log.
Attualmente, non esiste alcuna soluzione per questo problema.
2.2 I comandi delle viste Aggiornamento della Selezione profili non funzionano per le interazioni tracciaI comandi delle viste Aggiornamento della Selezione profili non funzionano per le interazioni traccia. Tuttavia, le interazioni di traccia vengono aggiornate automaticamente a intervalli regolari.
Per risolvere questo problema, selezionare un altro nodo nella struttura ad albero della creazione profili e selezionare nuovamente il nodo precedente.
2.3 La creazione profili su Windows utilizzando Sun JDK 1.4.x può terminare con una segnalazione errori MicrosoftDifetto Bugzilla: 103058
La creazione profili o l'applicazione vengono interrotte con un messaggio simile a "java.exe ha riscontrato un problema e verrà chiuso. Siamo spiacenti per il disagio" Il messaggio contiene informazioni e scelte per inoltrare l'errore a Microsoft. Per un'immagine del messaggio, fare riferimento a bugzilla 103058.
Questo problema è stato osservato in diverse situazioni: Analisi dei tempi (con o senza "Mostra istanze"), Analisi di memoria e in combinazione con queste modalità. Per risolvere questo problema eseguire nuovamente la creazione profili o l'applicazione disattivando JIT, ad esempio indicando "-Djava.compiler=NONE" come argomento JVM. Il problema è stato rilevato con il build SUN JDK 1.4.2_08-b03 per Windows.