Generic Log Adapter - Note sul rilascio

Problemi noti e soluzioni

1.0 Generic Log Adapter
  1.1 Ultimo record non elaborato quando Generic Log Adapter viene eseguito senza interruzione
  1.2 Problemi con il richiamo del file di configurazione di Generic Log Adapter
  1.3 Limitazione durante l'analisi dei file di log di WebSphere Application Server su UNIX
  1.4 Limitazione durante l'analisi dei log degli errori di WebSphere MQ su UNIX
  1.5 Problemi durante l'analisi dei file di log utilizzando runregex_showlog_example.bat/sh
  1.6 Dati non corretti restituiti da DB2 Diagnostic Log Rules Parser
  1.7 L'analisi di alcuni log genera informazioni di fuso orario non corrette
  1.8 Generazione di elementi di dati estesi non validi
  1.9 Script di Generic Log Adapter non leggibili su z/OS
  1.10 *Script di esempio errpt di Generic Log Adpater AIX runregex_errpt_example.sh non funziona su AIX
  1.11 Controllo continuo dei file di log con programmi di analisi statici non supportato
  1.12 Informazioni sulla registrazione log di Generic Log Adapter e limitazioni
  1.13 Nessuna convalida effettuata sui tipi di file di log
  1.14 Limitazioni nell'analisi dei file activity.log di WebSphere Application Server
  1.15 Limitazioni nell'analisi dei file di log generati con impostazioni internazionali diverse
  1.15 Riquadri dell'editor vuoti durante l'esecuzione dei file dell'adattatore del programma di analisi statico
  1.17 Problemi durante la decompressione con l'utilità Windows XP unzip

1.0 Generic Log Adapter

1.1 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.2 Problemi con il richiamo del file di configurazione di Generic Log Adapter

Il file di configurazione di Generic Log Adapter non viene richiamato correttamente quando si utilizza il file batch gla.bat.

Questo problema può essere risolto utilizzando un percorso assoluto per il file di configurazione, ad esempio, gla.bat c:\mypathname\static.adapter.

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

Durante l'analisi dell'attività binaria di WebSphere Application Server o dei log di servizio 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 Application Server.

Per risolvere questo problema, l'attività binaria o il log dei servizi dovranno essere spostati in una directory per la quale si dispone degli stessi privilegi dell'utente di Generic Log Adapter prima di analizzare il log.

1.4 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.5 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.6 Dati non corretti restituiti da DB2 Diagnostic Log Rules Parser

Quando si analizzano i file di log della diagnostica DB2 con la configurazione dell'adattatore basata su regole, i messaggi del file di log nell'output analizzato conterranno simboli di punteggiatura non previsti.

Attualmente, non esiste alcuna soluzione per questo problema.

1.7 L'analisi di alcuni log genera informazioni di fuso orario non corrette

L'analisi di alcuni log genera informazioni di fuso orario non corrette.

Solo i file di log con indicazioni di data/ora relative al fuso orario produrranno dati analizzati con valori creationTime aventi il fuso orario corretto. Se le indicazioni di data/ora nei file di log non specificano il fuso orario, Generic Log Adapter genererà valori creationTime con informazioni relative al fuso orario non corrette.

1.8 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.9 Script di Generic Log Adapter non leggibili su z/OS

La decompressione di runtime.zip e rules.zip su z/OS, a volte genera file di script illeggibili.

Per evitare questo problema, per decomprimere runtime.zip e rules.zip su un sistema z/OS, procedere come segue.

unzip -a runtime.zip
unzip -a rules.zip
unzip -o rules.zip *.adapter
*1.10 Script di esempio errpt di Generic Log Adpater AIX runregex_errpt_example.sh non funziona su AIX

Lo script di esempio errpt di Generic Log Adpater AIX runregex_errpt_example.sh non funziona su AIX.

Per risolvere il problema, modificare il file dell'adattatore di esempio errt AIX GenericLogAdapter\config\AIX\syslog\v4\regex_errpt_example.adapter con l'editor della configurazione di Generic Log Adapter ed apportare le seguenti modifiche:

  1. Modificare la proprietà converter del sensore un modo che abbia valore errpt -a >/tmp/errpt.out.
  2. Aggiungere una nuova proprietà al sensore con nome shell e valore sh.

Nota: risolto nella Versione 6.0.0.1.

1.11 Controllo continuo dei file di log con programmi di analisi statici non supportato

È possibile controllare i file di log senza interruzione mediante le classi del programma di analisi Java statico. Per controllare senza interruzione questi file di log, se possibile utilizzare un programma di analisi basato su regole.

1.12 Informazioni sulla registrazione log di Generic Log Adapter e limitazioni

Quando Generic Log Adapter viene eseguito esternamente all'ambiente Eclipse, registra gli errori e i messaggi di log nel file hgla.log. Quando eseguito in modalità autonoma, hgla.log verrà creato nella directory di lavoro corrente.  Durante l'esecuzione come parte di un'operazione di importazione log in remoto mediante il programma di analisi di log e traccia, hgla.log verrà ubicato sul sistema remoto nella directory /tmp se in esecuzione su un sistema UNIX o Linux o in c:\Documents and Settings\userid\Local Settings\Temp se in esecuzione su un sistema Windows.  Generic Log Adapter registra gli eventi con i livelli di registrazione 10, 20, 30, 50 e 60.  È possibile importare il file hgla.log nel programma di analisi di log e traccia per diagnosticare i problemi riscontrati da Generic Log Adapter durante l'analisi del file di log.

Quando l'esecuzione viene avviata in un ambiente Eclipse, ad esempio come parte di un'operazione di importazione log locale utilizzando il programma di analisi di log e traccia, Generic Log Adapter non registra i messaggi nel file hgla.log né in nessun altro percorso.

1.13 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.14 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.15 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, quando si analizza un file di log degli accessi inglese di IBM HTTP Server in una macchina Giapponese utilizzando   config\IHS\access\v1.3.19.3\runregex_example.bat/sh, 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, modificare il file runregex_example.bat/sh aggiungendo i seguenti parametri JVM al comando Java:

-Duser.language=2-char-language-code -Duser.region=2-char-country-code

dove i codici di lingua e di paese si riferiscono alle impostazioni internazionali in cui vengono espresse le indicazioni data/ora. Per l'esempio indicato, i parametri JVM sarebbero:

-Duser.language=en -Duser.region=US
1.16 Riquadri dell'editor vuoti durante l'esecuzione dei file dell'adattatore del programma di analisi statico

Quando viene eseguito un file dell'adattatore del programma di analisi statico nell'editor della configurazione di Generic Log Adapter, i riquadri relativi ai risultati del programma di estrazione e del programma di formattazione, risultano vuoti. Questo accade perché l'adattatore del programma di analisi statico non contiene i componenti di estrazione e formattazione. Tuttavia, se il file dell'adattatore del programma di analisi statico è configurato correttamente, il riquadro relativo ai risultati del sensore dovrebbe contenere dati. L'output del sensore del programma di analisi statico sono Common Base Event che rappresentano i record del log analizzato. Il riquadro relativo ai risultati del sensore conterrà i Common Base Event nel formato della stringa. Se dopo aver fatto clic sul pulsante Riesegui adattatore, il riquadro appare ancora vuoto, scegliere Mostra log sulla barra degli strumenti nella parte superiore del riquadro dei risultati del programma di estrazione, in modo da visualizzare l'output del sensore.

1.17 Problemi durante la decompressione con l'utilità Windows XP unzip

Durante l'installazione di Generic Log Adapter su Windows XP, si verificano dei problemi durante la decompressione del file rules.zip di Generic Log Adapter con l'utilità unzip nativa di Windows XP.  Alcune directory e file non vengono decompresse.  Di conseguenza, alcuni tipi di file di log non possono essere analizzati utilizzando Generic Log Adapter. Per risolvere questo problema, durante l'installazione su Windows XP, utilizzare un'altra utilità di decompressione, ad esempio WinZip o UnZip.

Visualizza il file Readme principale