© Copyright International Business Machines Corporation 2000, 2007. 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.
Il Generic Log Adapter è raggruppato in Agent Controller. Generic Log Adapater consente di creare un adattatore per i formati log personalizzati. Quando Generic Log Adapter controlla continuamente un file di log, questo non elabora l'ultimo record se non esiste un modello di fine specificato. L'ultimo record sarà solo elaborato quando si sta chiudendo Generic Log Adapter.
Per verificare che l'ultimo record venga elaborato durante il controllo, fornire un modello di fine per i record nel file di configurazione dell'adattatore di log generico.
Quando si analizzano attività binarie o log di servizio di WebSphere® Application Server su piattaforme UNIX™ che utilizzano Generic Log Adapter, l'utente deve disporre di privilegi maggiori o uguali a quelli dell'installatore di WebSphere Application Server.
Per risolvere temporaneamente questa limitazione, spostare l'attività binaria o i log di servizio in una directory con gli stessi privilegi dell'utente di Generic Log Adapter prima di analizzare i log.
Durante l'analisi dei log di errore di WebSphere MQ Error sulle piattaforme UNIX utilizzando Generic Log Adapter, l'utente deve avere gli stessi o maggiori privilegi del programma di installazione di WebSphere MQ.
Per risolvere temporaneamente questa limitazione, spostare i log di errore MQ in una directory con gli stessi privilegi dell'utente di Generic Log Adapter prima di analizzare i log.
Quando Generic Log Adapter esegue in modalità autonoma, al di fuori di un ambiente Eclipse, questo registra i messaggi e gli errori in un file chiamato hgla.log nella directory di lavoro corrente. Se il file hgla.log già esiste nella directory di lavoro corrente, viene creato un nuovo file di log chiamato hgla.nnnnnnnn.log dove nnnnnnnn è un numero univoco. Quando Generic Log Adapter esegue come parte di un'operazione di importazione log, i messaggi di errore che registra sono visualizzati in una finestra di dialogo di errore nell'Analizzatore di log e traccia.
Quando si esegue in un ambiente Eclipse nella prospettiva Generic Log Adapter, i messaggi e gli errori registrati da Generic Log Adapter sono elencati nella vista Problemi.
Generic Log Adapter registra gli eventi con livelli di registrazione 5, 10, 20, 30, 50 e 60, in base all'impostazione di loggingLevel per i Contesti e i Componenti nel file di configurazione dell'adattatore. Il file hgla.log può essere importato nell'Analizzatore di log e di traccia, come tipo file XML dell'evento common base, per diagnosticare i problemi rilevati da Generic Log Adapter durante l'analisi del file di log.
Nessuna convalida viene eseguita da Generic Log Adapter per determinare se il tipo del file di log analizzato corrisponde alla configurazione del file dell'adattatore. Ad esempio, se il file di log specificato nella configurazione del sensore nel file dell'adattatore non è del tipo per cui erano state progettate le regole di configurazione e sostituzione dell'estrattore nel programma di analisi, potrebbero verificarsi risultati non previsti. L'analisi potrebbe verificarsi senza errore ma i dati dell'evento common base risultanti non saranno corretti. L'analisi potrebbe non riuscire con messaggi di errori che indicano la rilevazione di dati non corretti.
Per risolvere temporaneamente questo problema, verificare che il file di log specificati nella configurazione del componente del sensore siano del tipo corretto.
Durante l'analisi dei file di log che contengono data/ora in una locale diversa dalla locale in cui sta eseguendo Generic Log Adapter, utilizzando un file dell'adattatore basato sulle regole configurato per utilizzare l'attributo Formato ora nella regola di sostituzione per creationTime, la data/ora e gli altri dati di registrazione log potrebbero non essere analizzati correttamente. Ad esempio, i valori creationTime nell'evento common base potrebbero essere zero e il campo msg dell'evento common base potrebbe essere vuoto.
Per risolvere temporaneamente questo problema, verificare che i valori degli attributi del codice di lingua ISO e il codice paese ISO di Context Instance nel file dell'adattatore basato su regole corrispondano alla locale delle date/ora affinché vengano analizzati i file di log.
Quando si convertono i file di log che utilizzano simboli di fuso orario a tre lettere, in formato evento common base utilizzando Generic Log Adapter, potrebbero risultare ore di creazione non corrette per gli eventi di log se il simbolo del fuso orario a tre lettere non è unico. 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.
Se si analizza un log IBM® DB2® Express Diagnostic con gli adattatori in GLA_INSTALL\GenericLogAdapter\config\DB2\diag\tool, gli eventi common base risultanti scritti nel file di output rompono alcune specifiche dell'evento common base. Ciò è dovuto a causa di un errore nel programma di utilità db2diag.exe che viene utilizzato per convertire i log dei diagnostici DB2 nei Common Base Event. Questo non dovrebbe interessare l'operazione di analisi. Non esistono soluzioni temporanee note finché non viene corretto db2diag.exe.
L'analisi del file di log con un file di adattatore creato utilizzando una versione precedente di Adapter Configuration Editor potrebbe provocare la scrittura del seguente messaggio di errore sul file di log di Generic Log Adapter, hgla.log:
Errore di convalida dell'adattatore IWAT0383E: cvc-complex-type.4: Attributo 'lineBreakSymbol' deve essere visualizzato sull'adattatore 'ex:Extractor'.
Le versioni precedenti di Adapter Configuration Editor hanno creato file di adattatore senza l'attributo Extractor richiesto lineBreakSymbol. Questo attributo deve essere presente nell'elemento Extractor, anche se ha un valore vuoto. Generic Log Adapter ora convalida il file dell'adattatore nello schema Generic Log Adapter prima di utilizzarlo e lineBreakSymbol è un attributo richiesto nello schema.
Per risolvere in modo temporaneo questo problema, aprire il file dell'adattatore con Adapter Configuration Editor, aggiungere un valore non vuoto al campo lineBreakSymbol dell'elemento Extractor, salvare il file dell'adattatore, quindi eliminare quel valore se non è richiesto e salvare di nuovo il file. Il file dell'adattatore conterrà ora l'attributo lineBreakSymbol nell'elemento Extractor.
L'analisi del file di log con un file di adattatore creato utilizzando una versione precedente di Adapter Configuration Editor potrebbe provocare la scrittura del seguente messaggio di errore sul file di log di Generic Log Adapter, hgla.log:
IWAT0438E Il programma di formattazione dell'evento common base N76D20B0042411D98000E0362B33D6F0 non può creare CommonBaseEvent poiché manca la proprietà obbligatoria sourceComponentId.
Questo messaggi indica che il componente del programma di formattazione di Generic Log Adapter non può creare un evento common base poiché sourceComponentId è una proprietà obbligatoria dell'evento common base ed è mancante. Generic Log Adapter ora conferma che tutte le proprietà obbligatorie sono presenti nell'evento common base e se ci sono proprietà mancanti, l'evento common base non viene restituito. Il file dell'adattatore potrebbe non avere regole di analisi per le proprietà indicate nel messaggio o le regole di analisi non sono corrette.
Per risolvere in modo temporaneo questo problema, aggiungere le regole del programma di analisi al file dell'adattatore per le proprietà dell'evento common base richieste o verificare che le regole esistenti siano corrette.
Durante l'analisi dei log, potrebbe essere scritto il seguente messaggio sulla console:
IWAT0310E Impossibile avviare Generic Log Adapter a causa di problemi di configurazione.
IWAT0317E Errore nella creazione del componente AdapterLogSensor.
IWAT0319E Impossibile creare l'istanza della classe org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor. Eccezione = org/eclipse/emf/ecore/EObjectPer risolvere temporaneamente questo problema, eseguire gli aggiornamenti di seguito riportati all'opzione -classpath nei file di script di runtime gla.bat e gla.sh:
- Sostituire emf.common_2.2.0.qualifier.jar with emf.common_2.2.0.v200606051102.jar.
- Sostituire emf.ecore_2.2.0.qualifier.jar with emf.ecore_2.2.0.v200606051102.jar.