Poznámky k vydání autonomního analyzátoru protokolů a trasování pro Eclipse

© Copyright International Business Machines Corporation 2000, 2006. Všechna práva vyhrazena. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Známé problémy a náhradní řešení

1.0 Analyzátor protokolů a trasování
1.1 Pohledy
1.1.1 Problémy s filtrováním a zvýrazněním funkcí v pohledu Protokol
1.2 Import protokolů
1.2.1 Problémy při importu vzdálených protokolových souborů
1.2.2 Import protokolových souborů na Linux a AIX
1.2.3 Import souboru trace.log serveru WebSphere Application Server
1.2.4 Některé soubory nelze importovat s pomocí IBM Agent Controller V5
1.2.5 Výjimka nedostatek paměti při importu velkých protokolových souborů a katalogy symptomů
1.2.6 Události Common Base zobrazené pro protokol DB2 Express Diagnostic nejsou pro specifikaci
1.2.7 Není provedeno žádné ověření platnosti Analyzátorem protokolů a trasování na typu importovaného protokolového souboru
1.2.8 Omezení při importu souborů protokolu generovaných na jiném umístění
1.2.9 Import protokolu aktivity serveru WebSphere Application Server programem pro analýzu pravidle z AIX selhal
1.2.10 Nelze vytvořit korelaci založenou na čase s Apache Derby verze 10.1.2.1
1.2.11 Nízký výkon při tvorbě a zobrazení korelaci pro velké protokoly
1.3 Podpora databáze
1.3.1 Přístup více klientů s pomocí stejného účtu databáze není podporován
1.3.2 Kolize cesty k prostředku
1.3.3 Předvolby podpory velkých prostředků zůstávají zablokované, i přes platný výběr
1.3.4 Vylepšení výkonu podpory velkých protokolů
1.3.5 Restart DB2 po vytvoření databáze a tabulek
1.3.6 Občasná výjimka SQL
1.3.7 Test připojení vrátí chybu, pokud jste nepoužili předvolby
1.3.8 Výraz CommonBaseEvent XPath není podporován při analýze velkých protokolů
1.3.9 Zobrazí se pouze jeden prvek contextDataElement pro velké protokoly
1.4 Jiné
1.4.1 Průvodce Novou korelací protokolů se nezobrazil správně v ovladači Linux GTK
1.4.2 Úpravy úrovně modulů plug-in po prvním spuštění pracovní plochy nejsou povoleny
1.4.3 Havárie při tvoření příkladu na Red Hat Linux v8.0 s IBM JVM
1.4.4 Pouze databáze symptomů formátu platformy TPTP lze vytvořit z panelu nástrojů Navigátoru protokolu a rozevírací nabídky
1.4.5 IBM Log Analyzer zpracuje pouze zprávy do 1024 bajtů
1.4.6 Editor symptomů generuje pravidla XPATH, která nejsou platná při používání komplexních prvků
1.4.7 Editor symptomů generuje pravidla XPATH, která se neshodují s libovolným vstupem událostí Common Base
2.0 Profilovací nástroj
2.1 Pohledy interakce procesu a agenta nejsou podporované z pohledu Sekvenčního diagramu
2.2 Příkaz Obnovit pohledy navigátoru profilování nepracuje pro Interakce trasování
2.3 Profilování ve Windows s pomocí Sun JDK 1.4.x může být ukončeno hlášením chyb Microsoft(R)

Další informace souboru Readme přidružené k Analyzátoru protokolů a trasování TPTP jsou dostupné v dokumentu TPTP V4.2 - Poznámky k vydání.

1.0 Analyzátor protokolů a trasování

1.1 Pohledy

1.1.1 Problémy s filtrováním a zvýrazněním funkcí v pohledu Protokol

V pohledu Protokol nefungují funkce filtrování a zvýraznění na komplexních prvcích události Common Base (například sourceComponentId). Oprava bude poskytnuta v dalším balíčku oprav.

1.2 Import protokolů

1.2.1 Problémy s importem vzdálených protokolových souborů

Při importu vzdálených protokolových souborů (Soubor > Import... > Protokolový soubor) se nezobrazily žádné záznamy v pohledu Protokol po obnovení pohledů Monitoru profilování (Profil > Obnovit pohledy), nebo se zobrazí dialog Zprávy protokolování, který tvrdí, že lokální klient nespustil monitorování programu pro analýzu vzdáleného protokolu po 30sekundovém čekání.

Tento problém vznikl kvůli zpoždění sítě a lze jej opravit navýšením času, kdy Řadič agentů čeká, až lokální klient spustí monitorování programu pro analýzu vzdáleného protokolu. Abyste obešli tento problém, proveďte následující kroky:

  1. Pokuste se protokolový soubor importovat znova.
  2. Pokud příznaky trvají, přidejte následující záznam do vzdálené aplikace RemoteLogParserLoader v konfiguraci Řadiče agentů (t.j. <instalační adresář Řadiče agentů>/plugins/com.ibm.etools.logging.parsers/config/pluginconfig.xml):
      
    <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>
    
    kde xxxxx je maximální čekací doba v milisekundách (t.j. větší než 30000).
  3. Jakmile je aktualizace provedena, restartujte Řadiče agentů a pokuste se znova importovat protokolový soubor.

1.2.2 Import protokolových souborů na Linux a AIX

Některé importy protokolových souborů vůbec nefungují na platformách Linux(R) a AIX(R).

Toto se stává, když uživatel nemá odpovídající povolení pro přístup k protokolovým souborům. Abyste vyřešili tento problém, měli byste zkopírovat protokolové soubory do domovského adresáře uživatele a importovat je z tohoto adresáře.

1.2.3 Import souboru trace.log serveru WebSphere Application Server

Vnitřní korelace se vytvoří, je-li importován soubor trace.log serveru WebSphere(R) Application Server.

Uživatel by neměl mazat tyto korelace, protože obsahují informace související s vnitřní strukturou odpovídajícího agenta.

1.2.4 Některé soubory nelze importovat s pomocí IBM Agent Controller V5

Vzdálené protokolové soubory jiné než activity.log nelze importovat s pomocí produktu V5 IBM(R) Agent Controller. Při importu vzdálených protokolových souborů musí být IBM Agent Controller na vzdáleném počítači na stejné nebo vyšší úrovni než IBM Log and Trace Analyzer for Eclipse.

Abyste obešli toto omezení, instalujte IBM Agent Controller dodaný s produktem IBM Log and Trace Analyzer for Eclipse na vzdáleném počítači.

1.2.5 Výjimka nedostatek paměti při importu velkých protokolových souborů a katalogy symptomů

Protokolové soubory a katalogy příznaků do velikosti 25MB lze importovat do pracovního prostoru a otevřít v Analyzátoru protokolů a trasování.

Množství času, který je třeba pro otevření protokolového souboru, závisí na počtu záznamů protokolu v souboru a můžete získat výjimku "nedostatek paměti". Abyste obešli tento problém, použijte funkci pro podporu velkých protokolů.

Pokud získáte výjimku "nedostatek paměti" při importu velkých katalogů symptomů, zvyšte velikost zásobníkové paměti tak, že zvýšíte následující hodnotu vmargs:

-vmargs -Xmx1000m

Pokud používáte podporu velkých protokolů, tato funkce neopraví problém vzniklý na základě výjimky "nedostatek paměti" při importu velkých protokolů; mělo by pomoct navýšení velikost zásobníkové paměti.

1.2.6 Události Common Base zobrazené pro protokol DB2 Express Diagnostic nejsou pro specifikaci

Pokud importujete protokol IBM DB2(R) Express Diagnositic, výsledná událost Common Base zobrazená v Analyzátoru protokolů a trasování přeruší některé specifikace událostí Common Base. Tohle je kvůli chybě v utilitě db2diag.exe, která se používá pro konverzi protokolů DB2 Diagnostic do událostí Common Base. Toto by nemělo jinak ovlivnit operaci import. Neexistuje žádné náhradní řešení, dokud neopravíte soubor db2diag.exe.

1.2.7 Není provedeno žádné ověření platnosti Analyzátorem protokolů a trasování na typu importovaného protokolového souboru

Není provedeno žádné ověření platnosti Analyzátorem protokolů a trasování na typu importovaného protokolového souboru. Při importu protokolového souboru se ujistěte, že jste zvolili správný typ protokolu a verzi pro protokolový soubor, který je importován. Pokud se problém vyskytuje během importování, nezobrazí se žádné záznamy, ani nesprávné záznamy v pohledu Protokol, ale zobrazí se chybová zpráva. Podrobnější informace o chybě získáte v podrobnostech z dialogového okna chyby.

1.2.8 Omezení při importu souborů protokolu generovaných na jiném umístění

Při importování protokolových souborů, které obsahují časové označení v místním nastavení jiném, než v jakém pracuje Analyzátor protokolů a trasování, program pro analýzu protokolových souborů založených na pravidlech někdy neanalyzuje časové označení a jiný data záznamu protokolu správně. Například, když importujete anglický přístupový protokolový soubor serveru IBM HTTP Server do Analyzátoru protokolů a trasování běžícím na japonském počítači, hodnoty creationTime ve výsledných událostech Common Base budou mít hodnotu nula a pole zpráv událostí Common Base bude prázdné.

Abyste obešli tento problém, pokud importujete protokolové soubory obsahujících časové označení v místním nastavení jiném, než je místní nastavení počítače, uveďte místní nastavení protokolového souboru na kartě Podrobnosti v průvodci Import protokolu, pokud pole pro místní nastavení existuje.

1.2.9 Import protokolu aktivity serveru WebSphere Application Server programem pro analýzu pravidle z AIX selhal

Import binárních protokolů aktivity serveru WAS s programem pro analýzu pravidel ze systému AIX selhal s následující chybou zobrazenou v dialogovém okně chyby:

IWAT0030E Vyskytla se chyba během zpracování programu pro analýzu vzdáleného
protokolu "com.ibm.etools.logging.adapter.config.StaticParserExtension":
IWAT0412E Vyskytly se chyby při analýze protokolového souboru /home/tfoun/logs/activity.log.
java.lang.Exception: IWAT0239E Příkaz konvertoru selhal: java.lang.Exception:
IWAT0238E Proces konvertoru byl ukončen s výstupní hodnotou 1

Příkaz konvertoru pro konverzi binárního protokolového souboru na text, aby mohl být analyzován, selhal na platformě AIX. Abyste obešli tento problém, buď použijte statický program pro analýzu, abyste importovali protokolové soubory aktivity, nebo konvertujte protokolové soubory aktivity na text s pomocí utility pro zobrazení protokolu WAS a importujte výsledný textový soubor do Analyzátoru protokolů a trasování. Utilitu pro zobrazení protokolu WAS lze nalézt v adresáři bin v instalačním adresáři WAS. Například použijte následující příkaz pro konverzi binárního protokolového soubory na textový soubor nazývaný activity.txt:

/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt

Potom importujte soubor activity.txt do Analyzátoru protokolů a trasování.

1.2.10 Nelze vytvořit korelaci založenou na čase s Apache Derby verze 10.1.2.1

Přestože není oficiálně podporován platformou TPTP, uživatel TPTP se pokusil použít Derby 10.1.2.1 ve spojení s podporou velkých protokolů a vnikl tento problém. Při pokusu vytvořit korelaci založenou na čase s velkým protokolem se vyskytla výjimka ArrayIndexOutOfBoundsException, která způsobila, že korelace běží nepřetržitě bez zastavení. Jedná se o známou chybu Derby, kterou napravuje Derby verze 10.2.0.0. Další informace získáte v popisu chyby na http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html.

Všimněte si, že tato výjimka se vyskytuje ze strany serveru a není vidět v pracovním prostředí uživatele. Zobrazí se v příkazovém okně, kde je vydán příkaz pro spuštění serveru Derby.

1.2.11 Nízký výkon při tvorbě a zobrazení korelaci pro velké protokoly

Při tvoření nebo zobrazování korelace pro velký protokol mohl být výkon pomalejší v databázích Apache Derby a DB2.

Abyste zlepšili výkon při tvoření korelace, importujte protokoly s pomocí filtru, takže nebudou do databáze začleněny nepotřebné a nesouvisející události. S pomocí filtru "Zobrazit pouze korelované události" můžete zlepšit výkon, pokud otevřete korelaci v pohledu Interakce protokolů.

1.3 Podpora databáze

1.3.1 Přístup více klientů s pomocí stejného účtu databáze není podporován

Souběžný přístup klientů k databázi by mohl zamknout některé tabulky. Abyste odemkli tabulky, restartujte pracovní plochu a databázový server.

1.3.2 Kolize cesty k prostředku

Pokud používáte stejnou databázi a účet databáze pro víc pracovních oblastí, mohou vznikat kolize cesty k prostředkům a prostředek nebude předán do databáze.

Abyste obešli tento problém, použijte jiný projekt a jména monitoru v každém pracovním prostoru, abyste se vyhnuli kolizím cest k prostředkům.

1.3.3 Předvolby podpory velkých prostředků zůstávají zablokované i přes platný výběr

Na platformě Linux/GTK: na stránce předvoleb Podpora velkých prostředků zůstanou pole pro nastavení databáze zablokována, i když zvolíte platný typ databáze.

Abyste obešli tento problém, vyberte databázi DB2 jako typ databáze a použijte nastavení. Zavřete a znova otevřete dialog předvoleb; pole budou zpřístupněna.

1.3.4 Vylepšení výkonu pro podporu velkých protokolů

Abyste vylepšili výkon pro podporu velkých protokolů, spusťte následující příkaz poté, co jste importovali velké protokoly:

db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x
/scripts/runStatsForAllHyadesTablesDB2-8.1.sql
kde x_x_x je číslo verze v adresáři modulů plug-in.

1.3.5 Restart DB2 po vytvoření databáze a tabulek

Po spuštění databáze a skriptu pro tvoření tabulek, CreateDatabaseAndTablesDB2-8.1.sql, musíte restartovat databázi DB2. Z příkazového okna DB2 spusťte db2stop a potom db2start, abyste aplikovali změny konfiguračních parametrů provedených skriptem.

1.3.6 Občasná výjimka SQL

Občas se může vyskytnout následující výjimka SQL:

com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031

Když se vyskytne tento problém, restartujte pracovní plochu a databázi, pokud používáte databázi DB2 nebo CloudscapeTM v síťovém režimu. Protokoly importované v době, kdy se vyskytla tato výjimka, nebudou platné a budete je muset importovat znova.

1.3.7 Test připojení vrátí chybu, pokud jste nepoužili předvolby

Na stránce Podpora velkých protokolů sekce Profilování a protokolování v dialogu Předvolby: pokud klepnete na Test připojení, než použijete změny nastavení, můžete způsobit chybu připojení. Abyste se tomuto vyhnuli, klepněte na tlačítko Použít po provedení změn nastavení, potom klepněte na Test připojení.

1.3.8 Výraz CommonBaseEvent XPath není podporován při analýze velkých protokolů

Následující výraz XPath není podporován produktem IBM Agent Controller při analýze velkých protokolů.

	<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>

1.3.9 Zobrazí se pouze jeden prvek contextDataElement pro velké protokoly

Je-li použita databáze DB2 pro podporu velkých protokolů, zobrazí se pouze jeden prvek contextDataElement pro událost v pohledu Protokol, i když existuje více prvků contextDataElements pro danou událost.

1.4 Jiné

1.4.1 Průvodce Novou korelací protokolů se nezobrazil správně v ovladači Linux GTK

V průvodci Nová korelace protokolu se zobrazí seznam pouze dostupných protokolů a seznam je prázdný. Toto se děje kvůli tomu, že se zobrazí pouze levá část stránky průvodce.

Abyste obešli tento problém, zkuste změnit velikost stránky průvodce, aby se seznam zvolených protokolů a tlačítka akcí zobrazily. Jiný způsob, jak obejít tento problém, je vybrat protokolové soubory pro korelaci v pohledu Navigátor protokolu, pak klepněte na tlačítko Nová korelace protokolu.

1.4.2 Úpravy úrovně modulů plug-in po prvním spuštění pracovní plochy nejsou povoleny

Pokud upravíte úroveň protokolování modulu plug-in v souboru plugin.xml (s pomocí bodů rozšíření com.ibm.etools.common.logging.commonLoggingOptions nebo com.ibm.etools.logging.util.loggingOptions) po prvním spuštění pracovní plochy, změna nebude použitá při následných spouštěních pracovní plochy. Úroveň protokolování uvedená v souboru plugin.xml modulu plug-in se ukládá do mezipaměti běhovou komponentou platformy Eclipse při prvním spuštění pracovní plochy. Následná spouštění pracovní plochy používají hodnoty uložené v mezipaměti na úrovni protokolování modulu plug-in navzdory úpravám v souboru plugin.xml.

Abyste obešli tento problém, restartujte pracovní plochu s pomocí argumentu příkazového řádku -clean. Tato volba vyčistí mezipaměť použitou pro uložení řešení pro závislosti balíků a vynutí si novou, aby platforma znova inicializovala mezipaměť. Přidejte volbu po souboru eclipse.exe v <instalační adresář modulu workbench>\eclipse\ac.bat (Windows(R)) nebo <instalační adresář modulu workbench>/eclipse/ac.sh (Linux). Nebo můžete upravit úroveň protokolování modulu plug-in na stránce předvoleb protokolování (Okno > Předvolby > Protokování) a restartovat pracovní plochu.

1.4.3 Havárie při tvoření příkladu na Red Hat Linux v8.0 s IBM JVM

Při tvoření příkladu v Analyzátor protokolů a trasování s pomocí Průvodce vytvářením příkladů (Nový > Příklad) dojde k havárii pracovní plochy. Toto se stává, když se Průvodce vytvářením příkladů pokusí otevřít soubor readme.html jako součást postupu tvoření. S tímto problémem se můžete setkat na Red Hat Linux v8.0 s IBM JavaTM Virtual Machine (JVM) a jedná se o chybu SWT (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).

Abyste obešli tento problém, zkuste přidat -Xj9 jako argument JVM do souboru ac.sh, aby se spustil s pomocí IBM J9 JVM. (například ./eclipse -vmargs -Xj9 -Xmx500m). Pro další informace o spouštění SWT na Red Hat Linux v8.0 zkontrolujte SWT FAQ (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).

Pozn.: Protože je spuštěný v  Tabulce odkazů na platformě Eclipse (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), jsou podporované pouze následující systémy Linux: verze 2.2.1 sady nástrojů GTK+ Widget a přidružené knihovny (GLib, Pango); prohlížeč SWT HTML vyžaduje produkt Mozilla 1.4GTK2. Pro Motif nebo jiné systémy Linux: Open Motif 2.1 (včetně); prohlížeč SWT HTML vyžaduje produkt Mozilla 1.4GTK2.

1.4.4 Pouze databáze symptomů formátu platformy TPTP lze vytvořit z panelu nástrojů Navigátoru protokolu a rozevírací nabídky

Kvůli omezení platformy TPTP nemohou uživatelů vytvořit oba typy databáze symptomů z tlačítka sady nástrojů navigátoru protokolu a kontextové nabídky. Tento problém obejdete, pokud vyberete Soubor > Nový > Jiné > Profilování a protokolování v nabídce pracovní plochy a vyberete typ databáze symptomů, který chcete vytvořit.

1.4.5 IBM Log Analyzer zpracuje pouze zprávy do 1024 bajtů

Pro pravidla XPATH a pravidla korelace IBM: řetězec vlastnosti msg události Common Base by neměl být větší než 1024 bajtů. Pokud je řetězec delší než 1024 bajtů, nebude Analyzátorem protokolů zpracován.

1.4.6 Editor symptomů generuje pravidla XPATH, která nejsou platná při používání komplexních prvků

Pokud používáte komplexní prvky události Common Base (například sourceComponentID), Editor symptomů generuje pravidla XPATH, která nejsou platná. Oprava bude poskytnuta v dalším balíčku oprav.

1.4.7 Editor symptomů generuje pravidla XPATH, která se neshodují s libovolným vstupem událostí Common Base

Je-li zvolen libovolný z prvků ExtendedDataElements při tvoření nového výrazu XPATH, výsledný katalog symptomů obsahuje extendedDataElement místo extendedDataElements. Následně editor symptomů generuje pravidla XPATH, která se neshodují s žádným vstupem událostí Common Base.

2.0 Profilovací nástroj

2.1 Pohledy interakce procesu a agenta nejsou podporované z pohledu Sekvenčního diagramu

Pohled Interakce agenta a Interakce procesu nejsou podporované pohledem Sekvenční diagram pro protokolové soubory.

Tomuto problému se momentálně nelze vyhnout.

2.2 Příkaz Obnovit pohledy navigátoru profilování nepracuje pro Interakce trasování

Příkaz Obnovit pohledy navigátoru profilování nepracuje pro Interakce trasování. Avšak interakce trasování se automaticky obnoví samy v pravidelných intervalech.

Náhradní řešení vybere jiný uzel ve stromě Profilování a opět vybere předchozí uzel.

2.3 Profilování ve Windows s pomocí Sun JDK 1.4.x může být ukončeno hlášením chyb Microsoft

Defekt produktu Bugzilla: 103058

Profilování nebo aplikace budou ukončeny se zprávou "java.exe se setkal s problémem a je nutné jej ukončit. Omlouváme se za nepříjemnosti." Zpráva obsahuje informace a výběry pro zadání hlášení chyb společnosti Microsoft. Podívejte se na defekt produktu Bugzilla 103058, kde je zpráva zachycená na obrazovce.

Tento problém se vyskytl v řadě režimů: Analýza času (s nebo bez "Zobrazit úrovně"), Analýza paměti a kombinace těchto režimů. Problém můžete obejít tak, že znova spustíte profilování nebo aplikaci s vypnutým JIT, t.j. poskytnete "-Djava.compiler=NONE" jako argument JVM. Problém byl zjištěn na SUN JDK 1.4.2_08-b03 sestaveném pro Windows.