Általános naplóillesztő - Kiadási megjegyzések

© 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.

Ismert problémák és elkerülésük

1.0 Az Általános naplóillesztő folyamatos futása esetén az utolsó rekord nincs feldolgozva
1.1 Korlátozás UNIX rendszeren a WebSphere Application Server naplók értelmezésére
1.2 Korlátozás UNIX rendszeren a WebSphere MQ hibanaplók értelmezésére
1.3 Probléma a naplófájlok runregex_showlog_example.bat/sh fájllal történő értelmezése során
1.5 Érvénytelen kiterjesztett adatelemek készülnek
1.7 Általános naplóillesztő - Naplózási információk és korlátozások
1.8 Egy naplófájltípus nincs ellenőrizve
1.9 Korlátozás a WebSphere Application Server activity.log fájlok értelmezésére
1.10 Más területi beállítással előállított naplófájlok értelmezésének korlátozásai
1.12 A nem egyedi hárombetűs időzóna-jellel ellátott naplófájlok értelmezése esetleg helytelen létrehozási időpontot ad meg az eseményekhez
1.13 A DB2 Express diagnosztikai naplójának értelmezett CBE eseményei nem felelnek meg a specifikációknak
1.14 Illesztőellenőrzés hiba naplófájl értelmezésekor
1.15 Formázóhiba naplófájl értelmezésekor
1.16 Beállítási problémák naplók értelmezésekor

A TPTP Általános naplóillesztő további readme információi a TPTP V4.2 kiadási jegyzeteiben állnak rendelkezésre.

1.0 Az Általános naplóillesztő folyamatos futása esetén az utolsó rekord nincs feldolgozva

Amikor az Általános naplóillesztő folyamatosan megfigyel egy naplófájlt, és nincs megadva befejezési minta, akkor az utolsó rekordot nem dolgozza fel. Az utolsó rekord csak az Általános naplóillesztő leállításakor lesz feldolgozva.

Az utolsó rekord megfigyelés közbeni feldolgozásához adja meg a rekordok befejezési mintáját az Általános naplóillesztő konfigurációs fájljában.

1.1 Korlátozás UNIX rendszeren a WebSphere Application Server naplók értelmezésére

Amikor a WebSphere(R) Application Server bináris tevékenység- vagy szerviznaplóit értelmezi UNIXTM platformokon az Általános naplóillesztő használatával, akkor a felhasználónak ugyanolyan, vagy erősebb jogosultsággal kell rendelkeznie, mint a WebSphere Application Server telepítőjének.

A korlátozás megkerüléséhez értelmezés előtt helyezze át a bináris tevékenység- vagy szerviznaplót egy olyan könyvtárba, amelyen ugyanolyan jogosultságok vannak, mint az Általános naplóillesztő felhasználójának.

1.2 Korlátozás UNIX rendszeren a WebSphere MQ hibanaplók értelmezésére

A WebSphere MQ hibanaplók Általános naplóillesztővel értelmezésekor UNIX környezetben a felhasználónak ugyanolyan jogosultságokkal kell rendelkeznie, mint a WebSphere MQ telepítőjének.

A korlátozás megkerüléséhez értelmezés előtt helyezze át az MQ hibanaplókat egy olyan könyvtárba, amelyen ugyanolyan jogosultságok vannak, mint az Általános naplóillesztő felhasználójának.

1.3 Probléma a naplófájlok runregex_showlog_example.bat/sh fájllal történő értelmezése során

Amikor a runregex_showlog_example.bat és a runregex_showlog_example.sh fájlokkal szeretne WebSphere Application Server tevékenységnaplókat értelmezni, a WebSphere Application showlog segédprogram nem található.

A probléma megkerüléséhez módosítsa a szabályszerkesztőben a regex_showlog_example.adapter fájlt, és frissítse az érzékelőátalakító tulajdonságot, hogy az a WebSphere Application Server megfelelő helyére mutasson.

1.5 Érvénytelen kiterjesztett adatelemek készülnek

Az Általános naplóillesztő érvénytelen extendedDataElements Common Base Event elemet hoz létre egy naplóbejegyzéshez, ha nincs a teljes névre vagy típusértékre egyezést mutató szabály. Az extendedDataElement elemet nem szabad létrehozni, ha nincs értelmezett név vagy típus a naplóbejegyzésből, de az Általános naplóillesztő létrehoz egyet, csak az értékmezővel.

A probléma megkerüléséhez győződjön meg róla, hogy olyan szabályok állnak rendelkezésre, melyek az extendedDataElemen mindhárom mezőjével (név, érték, típus) egyeznek.

1.7 Általános naplóillesztő - Naplózási információk és korlátozások

Az Általános naplóillesztő önálló módban, Eclipse környezeten kívüli futásakor az aktuális munkakönyvtár hgla.log fájljába naplózza az üzeneteket és hibákat. Ha a hgla.log fájl már létezik az aktuális munkakönyvtárban, akkor egy hgla.nnnnnnnn.log nevű új fájl jön létre, ahol az nnnnnnnn egyedi szám. Amikor az Általános naplóillesztő egy naplóimportálás részeként fut, az általa naplózott hibaüzenetek a Napló- és nyomkövetés-elemző hibapanelén jelennek meg.

Amikor Eclipse környezeten belül, Általános naplóillesztő perspektívából történik a futtatás, az Általános naplóillesztő által naplózott üzenetek és hibák a Problémák nézetben vannak felsorolva.

Az Általános naplóillesztő az 5-ös, 10-es, 20-as, 30-as, 50-es és 60-as naplózási szintű eseményeket naplózza, az illesztő konfigurációs fájljának Környezetek és összetevők részében levő loggingLevel beállításától függően. A hgla.log fájlt CBE XML fájltípusként lehet importálni a Napló- és nyomkövetés-elemzőbe, hogy a naplófájl értelmezésekor tapasztalt problémákat diagnosztizálni lehessen.

1.8 Egy naplófájltípus nincs ellenőrizve

Az Általános naplóillesztő nem végzi el annak ellenőrzését, hogy az értelmezett naplófájl típusa megfelel-e az illesztőfájl beállításainak.  Például ha az illesztőfájl érzékelőbeállításaiban megadott naplófájl típusa nem az, amire a kifejtő beállítása és az értelmezőbeállítások csereszabályai tervezve vannak, akkor előre nem látható eredményekre számíthat.  Az értelmezés esetleg hiba nélkül lefut, de az eredményül kapott Common Base Event adatok helytelenek lehetnek.  Az értelmezés hibaüzenetekkel is meghiúsulhat, jelezve, hogy helytelen adatokba ütközött.

A probléma megkerüléséhez győződjön meg róla, hogy az érzékelő összetevő beállításaiban megadott naplófájl típusa helyes.

1.9 Korlátozás a WebSphere Application Server activity.log fájlok értelmezésére

Amikor bináris WebSphere Application Server tevékenységnaplókat értelmez nem angol számítógépeken a runregex_showlog_example.bat/sh használatával, akkor a naplóbejegyzés adatok CBE eseményre leképezése sikertelen lesz.  Egyes naplóbejegyzési adatok a CBE helytelen mezőjében jelennek meg.

1.10 Más területi beállítással előállított naplófájlok értelmezésének korlátozásai

Amikor olyan naplófájlokat importál, melyek időbélyegzői az Általános naplóillesztő működési területi beállításaitól eltérő beállítással szerepelnek, és a creationTime csereszabályaiban szereplő Időformátum attribútum használatára beállított szabályalapú illesztőfájlt használ, akkor az időbélyegző és egyéb naplóbejegyzések esetleg helytelenül lesznek értelmezve. Az eredményül kapott Common Base Event események creationTime értékei például lehetnek nulla értékűek, a CBE msg mező pedig üresen maradhat.

A probléma megkerüléséhez győződjön meg róla, hogy a szabályalapú illesztőfájl Környezetpéldány ISO nyelvi- és országkód attribútumai megfelelnek az értelmezendő naplófájl időbélyegzőinek területi beállításainak.

1.12 A nem egyedi hárombetűs időzóna-jellel ellátott naplófájlok értelmezése esetleg helytelen létrehozási időpontot ad meg az eseményekhez

Amikor az Általános naplóillesztővel alakít át CBE formátumba hárombetűs időzónajeleket használó naplófájlokat, akkor helytelen létrehozási időket kaphat, ha a hárombetűs időzónajel nem egyedi. Például az "IST" hárombetűs jel értelmezhető Izraeli, Indiai, Iráni vagy Ír szabványos időnek is.

1.13 A DB2 Express diagnosztikai naplójának értelmezett CBE eseményei nem felelnek meg a specifikációknak

Ha egy IBM(R) DB2(R) Express diagnosztikai naplót értelmez a % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool illesztőivel, akkor a kimeneti fájlba írt CBE események megszegnek egyes 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 értelmezés műveletre. A db2diag.exe kijavításáig nincs ismert áthidaló megoldás.

1.14 Illesztőellenőrzés hiba naplófájl értelmezésekor

Ha az Illesztőkonfiguráció szerkesztő egy korábbi változatával készített illesztőfájllal végzi egy naplófájl értelmezését, akkor a következő hibaüzenet kerülhet az Általános naplóillesztő naplófájljába (hgla.log):

IWAT0383E Illesztőellenőrzési hiba: cvc-complex-type.4: A
'lineBreakSymbol' attribútumnak meg kell kelennie az
'ex:Extractor' elemen.

Az Illesztőkonfiguráció szerkesztő korábbi változatai a kötelező lineBreakSymbol Extractor attribútum nélkül hozta létre az illesztőfájlokat. Ennek az attribútumnak jelen kell lennie az Extractor elemben, akár üres értékkel is. Az általános naplóillesztő már az Általános naplóillesztő sémával veti össze az illesztőfájlt használat előtt, és a lineBreakSymbol a séma kötelező attribútuma.

A probléma megkerüléséhez nyissa meg az illesztőfájlt az Illesztőkonfiguráció szerkesztőben, adjon hozzá egy nem üres értéket az Extractor elem lineBreakSymbol mezőjéhez, mentse el az illesztőfájlt, majd törölje az értéket, amennyiben az nem szükséges, és ismét mentse el a fájlt. Az illesztőfájl így már tartalmazza az Extractor elemben a lineBreakSymbol attribútumot.

1.15 Formázóhiba naplófájl értelmezésekor

Ha az Illesztőkonfiguráció szerkesztő egy korábbi változatával készített illesztőfájllal végzi egy naplófájl értelmezését, akkor a következő hibaüzenet kerülhet az Általános naplóillesztő naplófájljába (hgla.log):

IWAT0438E A N76D20B0042411D98000E0362B33D6F0 CBE formázó nem tud
CommmonBaseEvent eseményt létrehozni, mivel egy kötelező tulajdonság
(sourceComponentId) hiányzik. 

Ez az üzenet jelzi, higy az Általános naplóillesztő formázó összetevője nem tudott létrehozni egy Common Base Event eseményt, mivel a sourceComponentId a CBE kötelező tulajdonsága, ám hiányzik. Az Általános naplóillesztő ellenőrzi, hogy a Common Base Event eseményben szerepel minden szükséges tulajdonság, és ha hiányoznak tulajdonságok, akkor nem ad vissza CBE eseményt. Az illesztőfájlnak esetleg nincsenek meg az üzenetben jelzett tulajdonságok értelmezési szabályai, vagy az értelmezési szabályok helytelenek.

A probléma megkerüléséhez adja hozzá a hiányzó CBE tulajdonságok értelmező szabályait az illesztőfájlhoz, vagy ellenőrizze, hogy a meglévő szabályok helyesek.

1.16 Beállítási problémák naplók értelmezésekor

Naplók értelmezésekor az alábbi hibaüzenetek íródhatnak a konzolra:

A probléma megkerüléséhez végezze el az alábbi frissítéseket a gla.bat és gla.sh futási parancsfájlok -classpath beállításán:



Nyilatkozatok

Ezek az információk az Egyesült Államokban forgalmazott termékekre és szolgáltatásokra vonatkoznak.

Elképzelhető, hogy a dokumentumban tárgyalt termékeket, szolgáltatásokat vagy lehetőségeket az IBM más országokban nem forgalmazza. Az adott országokban rendelkezésre álló termékekről és szolgáltatásokról az IBM helyi képviseletei szolgálnak felvilágosítással. Az IBM termékeire, programjaira vagy szolgáltatásaira vonatkozó utalások sem állítani, sem sugallni nem kívánják, hogy az adott helyzetben csak az adott termék, program vagy szolgáltatás alkalmazható. Minden olyan működésében azonos termék, program vagy szolgáltatás alkalmazható, amely nem sérti az IBM szellemi tulajdonjogát. Az ilyen termékek, programok és szolgáltatások működésének megítélése és ellenőrzése azonban a felhasználó felelőssége.

A dokumentum tartalmával kapcsolatban az IBM bejegyzett vagy bejegyzés alatt álló szabadalmakkal rendelkezhet. Jelen dokumentum nem ad semmiféle jogos licencet e szabadalmakhoz. A licenckérelmeket írásban a következő címre küldheti:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

Ha duplabyte-os (DBCS) információkkal kapcsolatban van szüksége licencre, akkor lépjen kapcsolatban az országában az IBM szellemi tulajdon osztállyal, vagy írjon a következő címre:

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

A következő bekezdés nem vonatkozik az Egyesült Királyságra, valamint azokra az országokra sem, amelyeknek jogi szabályozása ellentétes a bekezdés tartalmával: AZ INTERNATIONAL BUSINESS MACHINES CORPORATION A KIADVÁNYT "JELENLEGI FORMÁJÁBAN", BÁRMIFÉLE KIFEJEZETT VAGY VÉLELMEZETT GARANCIA NÉLKÜL ADJA KÖZRE, IDEÉRTVE, DE NEM KIZÁRÓLAG A JOGSÉRTÉS KIZÁRÁSÁRA, A KERESKEDELMI ÉRTÉKESÍTHETŐSÉGRE ÉS BIZONYOS CÉLRA VALÓ ALKALMASSÁGRA VONATKOZÓ VÉLELMEZETT GARANCIÁT. Bizonyos államok nem engedélyezik egyes tranzakciók kifejezett vagy vélelmezett garanciáinak kizárását, így elképzelhető, hogy az előző bekezdés Önre nem vonatkozik.

Jelen dokumentum tartalmazhat technikai, illetve szerkesztési hibákat. A kiadványban leírt információk bizonyos időnként módosításra kerülnek; a módosításokat a kiadvány új kiadásai tartalmazzák. Az IBM mindennemű értesítés nélkül továbbfejlesztheti és módosíthatja a kiadványban tárgyalt termékeket és/vagy programokat.

A kiadványban a nem az IBM által üzemeltetett webhelyek megjelenése csak kényelmi célokat szolgál, és semmilyen módon nem jelenti ezen webhelyek előnyben részesítését másokhoz képest. Az ilyen webhelyeken található anyagok nem képezik az adott termék dokumentációjának részét, így ezek felhasználása csak saját felelősségre történhet.

Az IBM bármilyen módon felhasználhatja vagy terjesztheti a kapott információkat, anélkül, hogy bármi kötelezettsége lenne Ön felé.

A programlicenc azon birtokosai, akik (i) a függetlenül létrehozott programok vagy más programok (beleértve ezt a programot is) közti információcsere, illetve (ii) a kicserélt információk kölcsönös használata céljából szeretnének információkhoz jutni, a következő címre írjanak:

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

Az ilyen információk bizonyos feltételek és kikötések mellett állnak rendelkezésre, ideértve azokat az eseteket is, amikor ez díjfizetéssel jár.

A dokumentumban tárgyalt licencprogramok és a hozzájuk tartozó licenc anyagok biztosítása IBM Vásárlói megállapodás, IBM Nemzetközi programlicenc szerződés vagy a felek azonos tartalmú megállapodása alapján történik.

A dokumentumban található teljesítményadatok ellenőrzött környezetben kerültek meghatározásra. Ennek következtében a más működési körülmények között kapott adatok jelentősen különbözhetnek a dokumentumban megadottaktól. Egyes mérések fejlesztői szintű rendszereken kerültek végrehajtásra, így nincs garancia arra, hogy ezek a mérések azonosak az általánosan hozzáférhető rendszerek esetében is. Továbbá bizonyos mérések következtetés útján kerültek becslésre. A tényleges értékek eltérhetnek. A dokumentum felhasználóinak ellenőrizni kell az adatok alkalmazhatóságát az adott környezetben.

A nem IBM termékekre vonatkozó információk a termékek szállítóitól, illetve azok publikált dokumentációiból, valamint egyéb nyilvánosan hozzáférhető forrásokból származnak. Az IBM nem tesztelte ezeket a termékeket, így a más gyártótól származó termékek esetében nem tudja megerősíteni a teljesítményre és kompatibilitásra vonatkozó, valamint az egyéb állítások pontosságát. A nem IBM termékek képességeivel kapcsolatos kérdéseivel forduljon az adott termék szállítóihoz.

COPYRIGHT LICENC:

A jelen információk olyan forrásnyelven írodott mintaalkalmazásokat tartalmaznak, melyek különböző működtetési környezetben illusztrálják a programozási technikákat. Ezeket a példaprogramokat bármilyen formában másolhatja, módosíthatja és terjesztheti az IBM felé való fizetési kötelezettség nélkül, fejlesztési, használati, marketing vagy terjesztési céllal, ha ezzel megfelel azon működtetési környezet alkalmazás programozási felületének, melyre a példaprogramok íródtak. Ezek a példák nincsenek minden helyzetre alaposan tesztelve. Az IBM ennélfogva nem garantálja vagy sugallja a programok megbízhatóságát, javíthatóságát vagy működőképességét.

A példaprogramok minden egyes másolatának vagy részmásolatának tartalmaznia kell az alábbi copyright nyilatkozatot:

(C) (cég neve) (év) A kód bizonyos részei az IBM vállalat példaprogramjaiból származnak. (C) Copyright IBM Corp. 2006. Minden jog fenntartva.

Ezen információk elektronikus példányának megjelenítésekor a fényképek és szníes illusztrációk esetleg nem jelennek meg.

Programozási felület

A programozási felületek információi segítik, hogy alkalmazásszoftvert hozzon létre ezzel a programmal.

Az általános felhasználású programozási felületek lehetővé teszik olyan alkalmazásszoftver megírását, melyek ezen program eszközeiből merítik a szolgáltatásokat.

Azonban ezek az információk tartalmazhatnak diagnosztikai, módosítási és hangolási információkat is. A diagnosztikai, módosítási és hangolási információk célja az alkalmazásszoftver hibakeresésének segítése.

Figyelmeztetés: Ezeket a diagnosztikai, módosítási és hangolási információkat ne használja programozási felületként, mivel bármikor megváltozhatnak.

Védjegyek és szolgáltatás védjegyek

Az alábbi kifejezések az IBM Corporation védjegyei az Egyesült Államokban és/vagy más országokban:

A Java, valamint minden Java alapú védjegy és logó a Sun Microsystems, Inc. védjegye az Egyesült Államokban és/vagy más országokban.

A Microsoft, a Windows, a Windows NT és a Windows logó a Microsoft Corporation védjegye az Egyesült Államokban és/vagy más országokban.

Az Intel, az Intel Xeon és a Pentium az Intel Corporation vagy leányvállalatainak védjegye vagy bejegyzett védjegye az Egyesült Államokban és/vagy más országokban.

A UNIX a The Open Group bejegyzett védjegye az Egyesült Államokban és más országokban.

A Linux Linus Torvalds bejegyzett védjegye az Egyesült Államokban és/vagy más országokban.

Más cégek, termékek és szolgáltatások nevei mások védjegyei vagy szolgáltatás védjegyei lehetnek.


(C) Copyright IBM Corporation 2000, 2006. Minden jog fenntartva.