© 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.
A TPTP Általános naplóillesztő további readme információi a TPTP V4.2 kiadási jegyzeteiben állnak rendelkezésre.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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, hogy 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.
Naplók értelmezésekor az alábbi hibaüzenetek íródhatnak a konzolra:
IWAT0310E Az Általános naplóillesztő beállítási problémák miatt nem indítható el. IWAT0317E Hiba az AdapterLogSensor összetevő összeépítésekor. IWAT0319E Az org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor osztály példányosítása sikertelen. Kivétel = org/eclipse/emf/ecore/EObjectA 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: