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:



Avvisi

Queste informazioni sono state sviluppate per i prodotti e i servizi offerti negli Stati Uniti.

È possibile che negli altri paesi l'IBM non offra i prodotti, i servizi o le funzioni illustrati in questo documento. Consultare il rappresentante locale IBM per informazioni sui prodotti e sui servizi attualmente disponibili nel proprio paese. Qualsiasi riferimento relativo a prodotti, programmi o servizi IBM non implica che solo quei prodotti, programmi o servizi IBM possano essere utilizzati. In sostituzione a quelli forniti dall'IBM, possono essere usati programmi, prodotti o servizi funzionalmente equivalenti che non comportino violazione dei diritti di proprietà intellettuale o di altri diritti dell'IBM. È comunque responsabilità dell'utente valutare e verificare la possibilità di utilizzare altri prodotti, programmi o servizi non IBM.

L'IBM può essere titolare di brevetti o domande di brevetto in corso relativi a quanto trattato nel presente documento. La fornitura di tale documento non implica la concessione di alcuna licenza su di essi. Chi desiderasse ricevere informazioni relative a licenze può rivolgersi per iscritto a:

IBM Director of Licensing
IBM Corporation
Schoenaicher Str.220
D-7030 Boeblingen
Deutschland

Per richieste di licenza relative a informazioni double-byte (DBCS) scrivere al seguente indirizzo:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

Il seguente paragrafo non è valido per il Regno Unito o per tutti i paesi le cui leggi nazionali siano in contrasto con le disposizioni in esso contenute: L'INTERNATIONAL BUSINESS MACHINES CORPORATION FORNISCE QUESTA PUBBLICAZIONE "NELLO STATO IN CUI SI TROVA", SENZA ALCUNA GARANZIA, ESPLICITA O IMPLICITA, IVI INCLUSE EVENTUALI GARANZIE DI COMMERCIABILITA' ED IDONEITA' AD UNO SCOPO PARTICOLARE. Alcuni stati non consentono la rinuncia a garanzie esplicite o implicite in determinate transazioni, quindi la presente dichiarazione potrebbe non essere a voi applicabile.

Questa pubblicazione potrebbe contenere imprecisioni tecniche o errori tipografici. Le informazioni incluse in questo documento vengono modificate su base periodica; tali modifiche verranno incorporate nelle nuove edizioni della pubblicazione. L'IBM si riserva il diritto di apportare miglioramenti e/o modifiche al prodotto o al programma descritto nel manuale in qualsiasi momento e senza preavviso.

Tutti i riferimenti a siti Web non dell'IBM sono forniti unicamente a scopo di consultazione. Il contenuto di questi siti non rientra nella documentazione relativa al prodotto IBM in questione. Pertanto, l'utente si assume eventuali rischi per l'accesso a questi siti Web.

L'IBM può utilizzare o divulgare le informazioni ricevute dagli utenti secondo le modalità ritenute appropriate, senza alcun obbligo nei loro confronti.

Coloro che detengono la licenza su questo programma e desiderano avere informazioni su di esso allo scopo di consentire: (i) uno scambio di informazioni tra programmi indipendenti ed altri (compreso questo) e (ii) l'uso reciproco di tali informazioni, dovrebbero rivolgersi a:

IBM Corporation
U59/600
3600 Steeles Ave East,
Markham, ON; L3R 9Z7
Canada

Queste informazioni possono essere rese disponibili secondo condizioni contrattuali appropriate, compreso, in alcuni casi, l'addebito di un canone.

Il programma su licenza descritto in questo documento e tutto il materiale su licenza ad esso relativo vengono forniti dall'IBM nei termini dell'IBM Customer Agreement, dell'IBM International Program License Agreement o di eventuali accordi equivalenti intercorsi tra le parti.

Tutti i dati relativi alle prestazioni contenuti in questa pubblicazione sono stati determinati in un ambiente controllato. Pertanto, i risultati ottenuti in ambienti operativi diversi possono variare in modo considerevole. Alcune misure potrebbero essere state fatte su sistemi di livello di sviluppo per cui non si garantisce che queste saranno uguali su tutti i sistemi disponibili. Inoltre, alcune valutazioni potrebbero essere state stimate tramite un'estrapolazione. I risultati possono quindi variare. Gli utenti di questa pubblicazione devono verififcare che i dati siano applicabili al loro specifico ambiente.

Le informazioni relative a prodotti non IBM sono state acquisite presso i fornitori di tali prodotti, gli annunci da loro pubblicati o altre fonti disponibili pubblicamente. L'IBM non ha verificato tali prodotti, quindi non può confermarne la qualità delle prestazioni, la compatibilità o altre dichiarazioni relative a prodotti non IBM. Eventuali quesiti sulle funzioni di prodotti non IBM dovrebbero essere indirizzati ai fornitori.

LICENZA SOGGETTA ALLE LEGGI SUL DIRITTO D'AUTORE:

Queste informazioni contengono programmi applicativi di esempio in lingua originale, che illustrano le tecniche di programmazione su diverse piattaforme operative. È possibile copiare, modificare e distribuire questi programmi, in una qualsiasi forma, per scopi di sviluppo, di utilizzo, di commercializzazione o distribuzione dei programmi applicativi conformi alle interfacce di programmi applicativi relativi alla piattaforma operativa, senza il pagamento di alcun diritto alla IBM. Questi esempi non sono stati testati approfonditamente tenendo conto di tutte le condizioni possibili. La IBM, quindi, non può garantire o assicurare l'affidabilità, la praticità o il funzionamento di questi programmi.

Ogni copia o parte di questi programmi di esempio o dei lavori derivati deve necessariamente includere le informazioni sul copyright, come di seguito riportato:

(C) (nome della società) (anno). Parti di questo codice derivano dai Programmi di esempio della IBM Sample Programs. (C) Copyright IBM Corp. 2006. Tutti i diritti riservati.

Se questa documentazione viene visualizzata in formato elettronico, le immagini o le illustrazioni a colori potrebbero non essere visualizzate.

Interfacce di programmazione

Le informazioni sull'interfaccia di programmazione consentono di creare del software applicativo tramite questo programma.

Le interfacce di programmazione di uso generale consentono di scrivere software applicativo che si avvalga dei servizi offerti dagli strumenti di questo programma.

Tuttavia, questa pubblicazione può anche contenere informazioni su diagnosi, modifiche e ottimizzazione di prestazioni. Queste informazioni vengono fornite per aiutare gli utenti a eseguire il debug del loro software applicativo.

Avvertenza: non utilizzare queste informazioni sulle diagnosi, le modifiche e la sintonizzazione come interfaccia di programmazione perché vanno soggette a cambiamenti.

Marchi

I seguenti termini sono marchi dell'IBM Corporation negli Stati Uniti e/o in altri paesi:

Java e tutti i marchi basati su Java sono marchi della Sun Microsystems, Inc. negli Stati Uniti e/o negli altri paesi.

Microsoft, Windows, Windows NT e i logo Windows sono marchi della Microsoft Corporation.

Intel, Intel Xeon e Pentium sono marchi della Intel Corporation o di società ad essa affiliate negli Stati Uniti e/o in altri paesi.

UNIX è un marchio registrato di The Open Group negli Stati Uniti e/o in altri paesi.

Linux è un marchio registrato di Linus Torvalds negli Stati Uniti e/o in altri paesi.

Nomi di altri prodotti, società e servizi possono essere marchi di altre società.


(C) Copyright IBM Corporation 2000, 2006. Tutti i diritti riservati.