© Copyright International Business Machines Corporation 2000, 2006. Minden jog fenntartva. Az USA kormányzati felhasználóinak jogkorlátozása: A használatot, a másolást és a nyilvánosságra hozatalt az IBM Corporation vállalattal kötött GSA ADP Schedule Contract korlátozza.
1.0 Napló- és nyomkövetés-elemző
1.1 Nézetek
1.1.1 A Napló nézet szűrés- és kiemelés funkcióinak problémái
1.2 Naplók importálása
1.2.1 Távoli naplófájlok importálásának problémái
1.2.2 Naplófájlok importálása Linux és AIX rendszereken
1.2.3 A WebSphere Application Server trace.log importálása
1.2.4 Egyes naplófájlokat nem lehet az IBM ügynökvezérlő 5-ös változatával importálni
1.2.5 Memóriahiány kivétel nagy naplófájlok és tünetkatalógusok importálásakor
1.2.6 A DB2 Express diagnosztikai napló CBE eseményei nem felelnek meg a specifikációknak
1.2.7 A Napló- és nyomkövetés-elemző az importált naplófájltípust nem ellenőrzi
1.2.8 Más területi beállítással előállított naplófájlok importálásának korlátozásai
1.2.9 WebSphere Application Server tevékenységnapló szabályértelmezővel importálása meghiúsul AIX rendszeren
1.2.10 Időalapú viszonyítás nem hozható létre az Apache Derby 10.1.2.1-es változatával
1.2.11 Nagy naplók korrelációjának létrehozásakor és megjelenítésekor lassú teljesítmény
1.3 Adatbázistámogatás
1.3.1 Az ugyanazt az adatbázisfiókot használó ügyfelek egyidejű hozzáférése nem támogatott
1.3.2 Erőforrásútvonal ütközés
1.3.3 A nagy erőforrástámogatás beállításokok tiltottak maradnak az érvényes kijelölés ellenére
1.3.4 Nagy napló támogatásának javított teljesítménye
1.3.5 DB2 újraindítása adatbázis és tábla létrehozása után
1.3.6 Időszakos SQL kivétel
1.3.7 A tesztkapcsolat hibát ad vissza, ha nem alkalmazta a beállításokat
1.3.8 A CommonBaseEvent XPath kifejezés nem támogatott nagy naplók elemzésekor
1.3.9 Nagy naplóknál csak egy contextDataElement jelenik meg
1.4 Egyéb
1.4.1 Az Új napló korreláció varázsló helytelenül jelenik meg Linux GTK illesztőprogramokkal
1.4.2 A bedolgozók naplózási szintjének a munkaterület első indítása után végzett módosításai nem lépnek érvénybe
1.4.3 Összeomlás, amikor Red Hat Linux 8.0 rendszeren példát hoz létre az IBM JVM használatával
1.4.4 Csak TPTP formátumú tünetadatbázisokat lehet létrehozni a Naplónavigátor eszköztárában és előugró menüjével
1.4.5 Az IBM naplóelemző csak 1024 byte-ig dolgozza fel az üzeneteket
1.4.6 A tünetszerkesztő összetett elemek használatakor érvénytelen XPATH szabályokat állít elő
1.4.7 A tünetszerkesztő egyetlen bemeneti CBE elemhez sem illő XPATH szabályokat állít elő
2.0 Profilozóeszköz
2.1 A Szekvenciadiagram nézetből nem támogatott az Ügynök- és folyamatinterakció nézet
2.2 A Profilozónavigátor nézetfrissítés parancsa nem működik a nyomkövetésinterakciónál
2.3 A Windows rendszeren, a Sun JDK 1.4.x változatával végzett profilozás Microsoft(R) hibajelentéssel végződhet
A TPTP Napló- és nyomkövetés-elemző további readme információi a
TPTP
V4.2 kiadási jegyzeteiben állnak rendelkezésre.
A Napló nézetben a CBE esemény összetett elemein (amilyen például a sourceComponentId) nem működnek a szűrés- és kiemelés funkciók. A következő javítócsomagban erre is lesz javítás.
Távoli naplófájl importálásakor (Fájl > Importálás... > Naplófájl), a Profilozásmegfigyelés nézetek frissítése után (Profil > Nézetek frissítése) nem jelennek meg naplóbejegyzések, vagy egy Naplózási üzenet jelenik meg, mely szerint a helyi ügyfél 30 másodperc elteltével nem kezdte meg a távoli naplóértelmező megfigyelését.
Ez a probléma a hálózati várakozási időnek köszönhető, és javítható annak az időnek a növelésével, amennyit az Ügynökvezérlő várakozik a helyi ügyfélre, hogy az megkezdje a távoli naplóértelmező megfigyelését. A probléma megkerüléséhez próbálkozzon meg a következőkkel:
<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>ahol xxxxx a maximális várakozási idő ezredmásodpercben (30 000-nél nagyobb).
Egyes naplófájlimportálások egyáltalán nem működnek Linux(R) és AIX(R) környezetekben.
Ez akkor történhet, ha a felhasználónak nincs megfelelő jogosultsága a naplófájlok eléréséhez. A probléma megoldásához át kell másolni a naplófájlokat a felhasználó saját könyvtárába, és onnét kell őket importálni.
1.2.3 A WebSphere Application Server trace.log importálásaBelső korreláció jön létre a WebSphere(R) Application Server trace.log fájl importálásakor.
A felhasználó ne törölje ezeket a korrelációkat, mivel azok fontos információkat tartalmaznak a vonatkozó ügynök belső szerkezetéről.
1.2.4 Egyes naplófájlokat nem lehet az IBM ügynökvezérlő 5-ös változatával importálniA activity.log fájl kivételével a távoli naplófájlokat nem lehet 5-ös változatú IBM(R) ügynökvezérlővel importálni. Távoli naplófájlok importálásakor a távoli számítógépen levő IBM ügynökvezérlőnek ugyanolyan vagy magasabb szintűnek kell lennie, mint az IBM Eclipse Napló- és nyomkövetés-elemző.
A korlátozás megkerüléséhez telepítse a távoli számítógépre az IBM Eclipse Napló- és nyomkövetés-elemzővel együtt szállított IBM ügynökvezérlőt.
1.2.5 Memóriahiány kivétel nagy naplófájlok és tünetkatalógusok importálásakorLegfeljebb 25 MB-os naplófájlokat és tünetkatalógusokat lehet importálni a munkaterületre, illetve megnyitni a Napló- és nyomkövetés-elemzőben.
A naplófájl megnyitásához szükséges idő a fájlban levő naplóbejegyzések számától függ, és "memóriahiány" kivételbe ütközhet. A probléma megkerüléséhez használja a nagy napló támogatás szolgáltatást.
Ha "memóriahiány" kivételbe ütközik nagy tünetkatalógusok importálásakor, akkor az alábbi vmargs paraméterek hozzáadásával növelje meg a kupacméretet:
-vmargs -Xmx1000m
Ha a nagy napló támogatás szolgáltatás nem oldja meg a "memóriahiány" problémát, akkor a kupacméret növelése segít.
Ha egy IBM DB2(R) Express diagnosztikai naplót importál, a Napló- és nyomkövetés-elemzőben eredményül kapott CBE események megszegnek bizonyos CBE specifikációkat. Ez annak a db2diag.exe segédprogramnak a hibája, ami átalakítja a DB2 diagnosztikai naplókat CBE eseményekké. Ez egyébként nem nincs hatással az importálás műveletre. A db2diag.exe kijavításáig nincs ismert áthidaló megoldás.
A Napló- és nyomkövetés-elemző az importált naplófájltípust nem ellenőrzi. Naplófájl importálásakor győződjön meg róla, hogy az importált naplófájlhoz megfelelő naplótípus- és verziószám van kiválasztva. Ha probléma történik importálás közben, akkor a Napló nézetben nem, vagy hibásan jelennek meg rekordok, és hibaüzenet érkezik. A hiba részletesebb információit a hiba párbeszédpanelben találja.
Amikor olyan naplófájlokat importál, melyek időbélyegzői a Napló- és nyomkövetés-elemző működési területi beállításaitól eltérő beállítással szerepelnek, akkor a szabályalapú naplófájl-elemző időnként helytelenül értelmezi az időbélyegzőt és az egyéb naplórekord-adatokat. Például ha egy angol IBM HTTP kiszolgáló hozzáférési naplóját importálja egy japán gépre, akkor az eredményül kapott CBE események creationTime értékei helyén 0 fog szerepelni, a Common Base Event mező pedig üres lesz.
A probléma megkerüléséhez a gépétől eltérő területi beállításokkal készült időbélyegzővel rendelkező naplófájlok importálásakor adja meg a naplófájl területi beállításait a Napló importálása varázsló Részletek lapján, ha van területi beállítás mező.
Bináris WAS tevékenységnapló Szabályok értelmezővel importálása meghiúsul AIX rendszeren, és a következő hiba jelenik meg a hibakijelzőn:
IWAT0030E Hiba történt a távoli naplóértelmező "com.ibm.etools.logging.adapter.config.StaticParserExtension" futtatásakor: IWAT0412E Hiba történt a /home/tfoun/logs/activity.log naplófájl értelmezése közben. java.lang.Exception: IWAT0239E Az átalakítóparancs meghiúsult: java.lang.Exception: IWAT0238E Az átalakító folyamat 1 kilépési értékkel fejeződött be.
A bináris naplófájlt szöveggé, így értelmezhető átalakító parancs meghiúsul AIX rendszeren. A probléma megkerüléséhez használja a Statikus értelmezőt a bináris tevékenységnapló importálásához, vagy alakítsa át a bináris naplófájlt szöveggé a WAS showlog segédprogramjával, és az eredményül kapott szövegfájlt importálja a Napló- és nyomkövetés-elemzőbe. A WAS showlog segédprogram a WAS telepítési könyvtárának bin könyvtárában található. Például az alábbi paranccsal alakítsa át szövegessé az activity.txt nevű bináris naplófájlt:
/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt
Ezutén importálja az activity.txt fájlt a Napló- és nyomkövetés-elemzőbe.
Bár a TPTP hivatalosan nem támogatja, egy TPTP felhasználó megpróbálta a Derby 10.1.2.1 változatát nagy napló támogatással használni, és ebbe a hibába ütközött. Nagy napló időalapú korrelációjának létrehozása közben egy ArrayIndexOutOfBoundsException kivétel történt, minek következtében a korreláció tovább futott és nem állt le. Ez egy ismert Derby hiba, ami a Derby 10.2.0.0-ás változatában már javítva van. További információkért olvassa el a Derby hiba leírását a http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html helyen.
Megjegyzés: ez a kivétel kiszolgálóoldalon történik, a felhasználó munkaterületén nem látható. Azon a parancsablakon jelenik meg, ahol a Derby kiszolgálót indító parancs volt kiadva.
Nagy napló korrelációjának létrehozásakor vagy megjelenítésekor az Apache Derby és DB2 teljesítménye lassul.
A teljesítmény javításához korreláció létrehozásakor használjon importálási szűrőt a naplók importálásakor, így a szükségtelen vagy nem kapcsolódó események nem kerülnek be az adatbázisba. A "Csak viszonyított események megjelenítése" javíthatja a teljesítményt, amikor a Naplóinterakciók nézetben megnyitja a korrelációt.
Az adatbázis több ügyfél általi párhuzamos elérése zárolhat egyes táblákat. A táblák zárolásának feloldásához indítsa újra a munkaterületet és az adatbáziskiszolgálót.
Ha ugyanazt az adatbázist és adatbázisfiókot használja több munkaterületen, akkor erőforrásútvonal ütközések történhetnek, és az erőforrás esetleg nem lesz az adatbázisban tárolva.
A probléma megkerüléséhez használjon eltérő projekt- és megfigyelésneveket minden egyes munkaterületen, így elkerüli az erőforrásútvonal ütközéseket.
A Linux/GTK eszközkészlet Nagy erőforrás támogatása beállításoldalon az adatbázisbeállítások tiltottak maradnak, bár érvényes adatbázistípus van kiválasztva.
A probléma megkerüléséhez válasszon DB2 adatbázistípust, és alkalmazza a beállításokat. Zárja be, majd ismét nyissa meg a beállítások párbeszédablakot; a mezők engedélyezettek lesznek.
A Nagy naplók támogatása teljesítménynöveléséhez futtassa az alábbi parancsot nagy naplók importálása után:
db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sqlahol x_x_x a bedolgozókatalógus verziószáma.
Az adatbázisokat és táblákat létrehozó parancsfájl (CreateDatabaseAndTablesDB2-8.1.sql) futtatása után a DB2 újraindítására van szükség. Egy DB2 parancsablakból futtassa a db2stop, majd a db2start parancsot a parancsfájl által végzett beállításparaméter-módosítások alkalmazásához.
Időnként előfordulhat a következő SQL kivétel:
com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031
Ilyen probléma esetén indítsa újra a munkaterületet és az adatbázist, ha hálózati módban használja a DB2 vagy CloudscapeTM adatbázisokat. A kivétel történtekor importált naplók érvénytelenek lesznek, és újra kell őket importálni.
A Beállítások párbeszédablak Profilozás és naplózás részének Nagy naplók támogatása oldalán ha a Kapcsolat tesztelése gombra kattint a beállítások módosításának alkalmazása előtt, akkor kapcsolati hibába ütközhet. Ennek elkerüléséhez kattintson az Alkalmaz gombra a beállítások módosítása után, és csak ezt követően kattintson a Kapcsolat tesztelése gombra.
Az alábbi XPath kifejezést az IBM naplóelemző nem támogatja nagy naplók elemzésekor.
<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>
Ha DB2-t használ nagy naplók támogatásához, akkor a Napló nézetben csak egy contextDataElement jelenik meg az eseményeknél, még ha több contextDataElements is létezik ahhoz az eseményhez.
Az Új naplókorreláció varázslóban csak az Elérhető naplók lista jelenik meg, és a lista üres. Ennek oka az, hogy csak a varázslóoldal bal része jelenik meg.
A probléma megkerüléséhez méretezze át a varázslóoldalt, hogy megjelenjen a Kijelölt naplók lista, valamint a műveleti gombok. Egy másik megkerülés a korrelált naplófájlok kijelölése a Naplónavigátorban, mielőtt az Új naplókorreláció gombra kattintana.
Ha módosítja egy bedolgozó naplózási szintjét annak plugin.xml fájljában (a com.ibm.etools.common.logging.commonLoggingOptions vagy a com.ibm.etools.logging.util.loggingOptions kiterjesztési pontokkal) a munkaterület első indítása után, akkor a munkaterület ezt követő indításikor a módosítás nem lép érvénybe. A bedolgozó plugin.xml megadott naplózási szintet az Eclipse futási környezet a munkaterület első indításakor tárolja el. A munkaterület további indításai a bedolgozó naplózási szintjének a gyorsítótárban levő értéket használják, a plugin.xml fájlban végzett módosítások ellenére.
A probléma megkerüléséhez indítsa újra a munkaterületet a -clean parancssori paraméterrel. Ez a paraméter kitakarítja a kötegelt függőségek feloldására használt gyorsítótárakat, valamint az Eclipse kiterjesztések nyilvántartását, így a gyorsítótárak újrainicializálására kényszeríti az Eclipse alkalmazást. Adja hozzá a paramétert az eclipse.exe után a <munkaterület telepítési könyvtára>\eclipse\ac.bat (Windows(R)) vagy a <munkaterület telepítési könyvtára>/eclipse/ac.sh (Linux) helyen. Ennek alternatívájaként a Naplózási beállítások oldalon is megváltoztathatja a bedolgozó naplózási szintjét (Ablak > Beállítások > Naplózás), majd újraindíthatja a munkaterületet.
Amikor egy példát hoz létre a Napló- és nyomkövetés-elemzőben a Példa létrehozása varázslóval (Új > Példa), a munkaterület összeomlik. Ez akkor történik, amikor a Példalétrehozás varázsló a létrehozási lépések részeként megpróbálja megnyitni a readme.html fájlt. A probléma Red Hat Linux v8.0 rendszeren is előfordul, ha az IBM JavaTM virtuális gépet használja; ez egy SWT hiba (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).
A probléma megkerüléséhez adja hozzá a -Xj9 értéket JVM argumentumként az ac.sh fájlhoz az IBM J9 Java virtuális gép indításához. (például: ./eclipse -vmargs -Xj9 -Xmx500m). Az SWT Red Hat Linux v8.0 rendszeren futtatásának további információit a SWT FAQ oldalon találja (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).
Megjegyzés: Az Eclipse referenciakörnyezetek táblában leírtak szerint (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), csak a következő Linux rendszerek támogatottak: a GTK+ eszközkészlet 2.2.1 verziója, valamint a kapcsolódó függvénytárak (GLib, Pango); a SWT HTML megjelenítőjéhez Mozilla 1.4GTK2 szükséges. A Motif környezethez Linux rendszeren: Open Motif 2.1 (a csomag tartalmazza); a SWT HTML megjelenítőhöz Mozilla 1.4GTK2 szükséges.
Egy TPTP korlátozás miatt a felhasználók nem hozhatják létre mindkét tünetadatbázis-típust a naplónavigátor eszköztárában és az előugró menüből. Egy áthidaló megoldás a Fájl > Új > Egyéb > Profilozás és naplózás munkaterület menüpont kiválasztása, majd a létrehozni kívánt tünetadatbázis-típus kijelölése.
Az XPATH szabályokban és az IBM korrelációszabályokban a msg CBE tulajdonságban levő karaktersorozat nem lehet hosszabb 1024 byte-nál. Ha a karaktersorozat hosszabb, mint 1024 byte, akkor az IBM naplóelemző nem dolgozza fel.
Amikor a CBE összetett elemeit használja (amilyen például a sourceComponentID), akkor a Tünetszerkesztő érvénytelen XPath szabályokat állít elő. A következő javítócsomagban erre is lesz javítás.
Ha egy ExtendedDataElements ki van jelölve új XPATH kifejezés létrehozásakor,
akkor az eredményül kapott tünetkatalógus extendedDataElements
helyett extendedDataElements
értéket fog tartalmazni.
Ennek eredményeként a Tünetszerkesztő egyetlen bemeneti CBE eseménynek sem
megfelelő XPATH szabályokat állít elő.
Az Ügynök interakció nézet és a Folyamatinterakció nézet nem támogatott naplófájlokhoz a Szekvenciadiagram nézetből.
Jelenleg nincs áthidaló megoldás ehhez a problémához.
2.2 A Profilozónavigátor nézetfrissítés parancsa nem működik a nyomkövetésinterakciónálA Profilozónavigátor nézetfrissítés parancsa nem működik a nyomkövetésinterakciónál. Azonban a nyomkövetés-interakciók automatikusan, rendszeres időközönként frissülnek.
Egy áthidaló megoldás a Profilozás fa egy másik csomópontjának, majd az előző csomópont kiválasztása.
2.3 A Windows rendszeren, a Sun JDK 1.4.x változatával végzett profilozás Microsoft hibajelentéssel végződhetBugzilla hiba: 103058
A profilozás vagy az alkalmazás a következő üzenettel fejeződik be: "A(z) java.exe hibába ütközött, ezért leáll. A kellemetlenségekért elnézését kérjük." Az üzenet információkat tartalmaz, valamint lehetőséget, hogy hibajelentést küldjön a Microsoftnak. Az üzenetet megtekintheti a bugzilla 103058 webhelyén.
Ez a probléma számos módban megfigyelhető: Időelemzés("Példányok megjelenítésével" vagy anélkül), Memóriaelemzés, valmaint ezen módok kombinációjában. A probléma megkerüléséhez a JIT kikapcsolása után futtassa újra a profilozást vagy alkalmazást (azaz adja meg a "-Djava.compiler=NONE" JVM argumentumot). A probléma a Windows rendszerre íródott SUN JDK 1.4.2_08-b03 esetén fordul elő.