Generic Log Adapter - Note sul rilascio

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

Problemi noti e soluzioni

1.0 Ultimo record non elaborato quando Generic Log Adapter viene eseguito senza interruzione
1.1 Limitazione durante l'analisi dei file di log di WebSphere Application Server su UNIX
1.2 Limitazione durante l'analisi dei log degli errori di WebSphere MQ su UNIX
1.3 Problemi durante l'analisi dei file di log utilizzando runregex_showlog_example.bat/sh
1.5 Generazione di elementi di dati estesi non validi
1.7 Informazioni sulla registrazione log di Generic Log Adapter e limitazioni
1.8 Nessuna convalida effettuata sui tipi di file di log
1.9 Limitazioni nell'analisi dei file activity.log di WebSphere Application Server
1.10 Limitazioni nell'analisi dei file di log generati con impostazioni internazionali diverse
1.12 L'analisi dei file di log con simboli a tre lettere non univoci per i fusi orari potrebbero restituire orari di creazione non corretti per gli eventi
1.13 I Common Base Events analizzati per i log di DB2 Express Diagnostic non rispettano la specifica
1.14 Errore di convalida dell'adattatore durante l'analisi del file di log
1.15 Errori del formatter durante l'analisi del file di log
1.16 Problemi di configurazione durante l'analisi dei log

Ulteriori informazioni associate a TPTP Generic Log Adapter sono disponibili nella sezione TPTP V4.2 - Note sul rilascio.

1.0 Ultimo record non elaborato quando Generic Log Adapter viene eseguito senza interruzione

Quando Generic Log Adapter controlla un file di log senza interruzione, non elaborerà l'ultimo record se non è specificato alcun modello finale. L'ultimo record verrà elaborato solo alla chiusura di Generic Log Adapter.

Per assicurarsi che l'ultimo record venga elaborato durante il controllo, indicare un modello finale per i record nel file di configurazione di Generic Log Adapter.

1.1 Limitazione durante l'analisi dei file di log di WebSphere Application Server su UNIX

Durante l'analisi dell'attività binaria di WebSphere(R) Application Server o dei log di servizio sulle piattaforme UNIXTM utilizzando Generic Log Adapter, l'utente dovrà disporre degli stessi privilegi, o di privilegi superiori, dell'utente che ha effettuato l'installazione di WebSphere Application Server.

Per risolvere questo problema, spostare i log binari delle attività o dei servizi in una directory per la quale si dispone degli stessi privilegi dell'utente di Generic Log Adapter prima di analizzare i log.

1.2 Limitazione durante l'analisi dei log degli errori di WebSphere MQ su UNIX

Durante l'analisi dei log degli errori di WebSphere MQ sulle piattaforme UNIX utilizzando Generic Log Adapter, l'utente dovrà disporre degli stessi privilegi, o di privilegi superiori, dell'utente che ha effettuato l'installazione di WebSphere MQ.

Per risolvere questo problema, spostare i log degli errori di MQ in una directory per la quale si dispone degli stessi privilegi dell'utente di Generic Log Adapter prima di analizzare i log.

1.3 Problemi durante l'analisi dei file di log utilizzando runregex_showlog_example.bat/sh

Quando si utilizza runregex_showlog_example.bat e runregex_showlog_example.sh per analizzare il log delle attività di WebSphere Application Server, non sarà possibile individuare l'utilità showlog di WebSphere Application Server.

Per risolvere il problema, modificare il file regex_showlog_example.adapter nell'editor delle regole ed aggiornare la proprietà Sensor Converter in modo che faccia riferimento alla directory appropriata di WebSphere Application Server.

1.5 Generazione di elementi di dati estesi non validi

Generic Log Adapter genererà un elemento Common Base Event extendedDataElements per un record di log se non viene rilevata alcuna regola che corrisponde al nome o al valore del tipo. L'extendedDataElement non dovrebbe essere generato se non viene analizzato alcun nome o tipo dal record di log, ma Generic Log Adapter ne genererà uno ugualmente, avente solo il campo del valore.

Per risolvere questo problema, assicurarsi che le regole fornite, relative ai tre campi, nome, valore e tipo, dell'extendedDataElement corrispondano.

1.7 Informazioni sulla registrazione log di Generic Log Adapter e limitazioni

Quando Generic Log Adapter viene eseguito in modalità autonoma, esternamente all'ambiente Eclipse, registra gli errori e i messaggi di log nel file hgla.log. Se il file hgla.log già esiste nella directory di lavoro corrente, viene creato un nuovo file di log denominato hgla.nnnnnnnn.log dove nnnnnnnn è un numero univoco. Quando Generic Log Adapter viene eseguito come parte di un'operazione di importazione di log, i messaggi di errore che registra, vengono visualizzati nella finestra di dialogo degli errori nell'analizzatore di log e di traccia.

Durante l'esecuzione all'interno di un ambiente Eclipse nella prospettiva Generic Log Adapter, i messaggi e gli errori registrati da Generic Log Adapter vengono elencati nella vista Problemi.

Generic Log Adapter registra gli eventi con i livelli di registrazione log 5, 10, 20, 30, 50 e 60, in base alle impostazioni di loggingLevel per i contesti e i componenti nel file di configurazione dell'adattatore. È possibile importare il file hgla.log nel programma di analisi di log e traccia, come un tipo file XML di Common Base Event, per diagnosticare i problemi riscontrati da Generic Log Adapter durante l'analisi del file di log.

1.8 Nessuna convalida effettuata sui tipi di file di log

Generic Log Adapter non effettua alcuna convalida per determinare se il tipo di file di log analizzato corrisponde alla configurazione file dell'adattatore. Ad esempio, se il file di log specificato nella configurazione del sensore nel file dell'adattatore non è del tipo sul quale si basano le regole di sostituzione e configurazione dell'estrattore nel programma di analisi, possono verificarsi risultati non prevedibili.  L'analisi potrebbe essere effettuata senza errori, ma i dati Common Base Event risultanti non saranno corretti. L'analisi potrebbe avere esito negativo con messaggi di errore che indicano la presenza di dati incorretti.

Per risolvere questo problema, assicurarsi che il file di log specificato nella configurazione del componente sensore, sia del tipo corretto.

1.9 Limitazioni nell'analisi dei file activity.log di WebSphere Application Server

Durante l'analisi dei file di log delle attività binari di WebSphere Application Server in una macchina non inglese utilizzando runregex_showlog_example.bat/sh, i dati di record del log non verranno associati correttamente a un Common Base Event.  Invece, è possibile che alcuni record di log possano essere visualizzati in un campo non corretto del Common Base Event.

1.10 Limitazioni nell'analisi dei file di log generati con impostazioni internazionali diverse

Durante l'analisi dei file di log che contengono indicazioni di data/ora con impostazioni internazionali diverse da quelle con cui viene eseguito Generic Log Adapter, se si utilizza un file dell'adattatore basato su regole configurato affinché usi l'attributo Time Format nella regola di sostituzione per creationTime, l'indicazione data/ora e altri dati record del log non verranno analizzati correttamente. Ad esempio, i valori di creationTime nei Common Base Events risultanti potrebbe essere zero e il campo msg di Common Base Event potrebbe essere vuoto.

Per risolvere tale problema, assicurarsi che i valori degli attributi codice lingua ISO e codice paese ISO dell'istanza di contesto nel file dell'adattatore basato sulle regole corrispondono alle impostazioni internazionali di Ora/data nel file di log da analizzare.

1.12 L'analisi dei file di log con simboli a tre lettere non univoci per i fusi orari potrebbero restituire orari di creazione non corretti per gli eventi

Quando si convertono i file di log che utilizzano simboli di fuso orario con tre lettere, in formato Common Base Event utilizzando Generic Log Adapter, potrebbero essere creati orari di creazione non corretti per gli eventi del log se il simbolo di fuso orario a tre lettere non è univoco. Ad esempio, il simbolo a tre lettere "IST" potrebbe essere interpretato come Israeli Standard Time, Indian Standard Time, Iran Standard Time o Irish Summer Time.

1.13 I Common Base Events analizzati per i log di DB2 Express Diagnostic non rispettano la specifica

Se si analizza un log di IBM(R) DB2(R) Express Diagnositic con gli adattatori in % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, i Common Base Event scritti nel file di output interrompono alcune delle 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 analisi non dovrebbe essere influenzata da questa condizione. Attualmente, non esiste alcuna soluzione per questo problema e bisogna attendere che db2diag.exe venga corretto.

1.14 Errore di convalida dell'adattatore durante l'analisi del file di log

L'analisi di un file di log con un file adattatore creato utilizzando una versione precedente dell'editor di configurazione dell'adattatore potrebbe causare la scrittura del seguente messaggio di errore nel file di log del Generic Log Adapter, hgla.log:

IWAT0383E Errore di convalida dell'adattatore: cvc-complex-type.4: l'attributo 
'lineBreakSymbol' deve apparire sull'elemento 'ex:Extractor'.

Le precedenti versioni dell'editor di configurazione dell'adattatore creavano i file adattatori senza l'attributo Extractor lineBreakSymbol. Tale attributo deve essere presente nell'elemento del programma di estrazione, anche se è un valore vuoto. Generic Log Adapter ora, convalida il file adattatore nello schema del Generic Log Adapter prima di utilizzarlo e lineBreakSymbol è un attributo richiesto nello schema.

Per risolvere questo problema, aprire il file adattatore nell'editor di configurazione dell'adattatore, aggiungere un valore non-vuoto nel campo lineBreakSymbol dell'elemento del programma di estrazione, salvare il file adattatore, quindi eliminare tale valore se non è richiesto e salvare il file nuovamente. Il file adattatore, ora, conterrà l'attributo lineBreakSymbol nell'elemento Extractor.

1.15 Errori del formatter durante l'analisi del file di log

L'analisi di un file di log con un file adattatore creato utilizzando una versione precedente dell'editor di configurazione dell'adattatore potrebbe causare la scrittura di messaggi di errore; come i seguenti, nel file di log del Generic Log Adapter, hgla.log:

IWAT0438E Il programma di formattazione Common Base Event N76D20B0042411D98000E0362B33D6F0
non può creare un CommmonBaseEvent in quanto la proprietà obbligatoria sourceComponentId è mancante.

Questo messaggio indica che il componente del programma di formattazione di Generic Log Adapter non è in grado di creare un Common Base Event perché sourceComponentId è una proprietà obbligatoria di Common e risulta mancante. Generic Log Adapter ora convalida la presenza di tutte le proprietà richieste nel Common Base Event e se mancano delle proprietà, il Common Base Event non viene restituito. Il file adattatore potrebbe non avere regole di analisi per le proprietà indicate nei messaggi o le regole di analisi non sono corrette.

Per risolvere questo problema, aggiungere regole del programma di analisi al file adattatore per le proprietà di Common Base Event richieste oppure verificare che le regole esistenti siano corrette.

1.16 Problemi di configurazione durante l'analisi dei log

Durante l'analisi dei log, potrebbero essere scritti sulla console i seguenti messaggi di errore:

Per risolvere tale problema, eseguire i seguenti aggiornamenti all'opzione -classpath nei file script di runtime gla.bat gla.sh: