© 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.
Další informace souboru Readme přidružené ke Generickému adaptéru protokolů TPTP jsou dostupné v dokumentu TPTP V4.2 - Poznámky k vydání.
Když Generický adaptér protokolů nepřetržitě monitoruje soubor protokolu, nezpracuje poslední záznam, pokud není uveden žádný vzor. Poslední záznam bude zpracován pouze, pokud zavřete Generický adaptér protokolů.
Abyste se ujistili, že poslední záznam je zpracován během monitorování, poskytněte koncový vzor pro záznamy v konfiguračním souboru Generického adaptéru protokolů.
Při analýze protokolů binární aktivity nebo protokolů služeb WebSphere(R) Application Server na platformách systému UNIXTM s pomocí Generického adaptéru protokolů musí mít uživatel stejná nebo větší privilegia než instalátor serveru WebSphere Application Server.
Abyste si ulehčili práci s tímto omezením, přesuňte protokoly binární aktivity nebo protokoly služeb do adresáře se stejnými privilegii jako uživatel Generického adaptéru protokolů, pak můžete analyzovat protokoly.
Při analýze protokolů WebSphere MQ Error na platformách systému UNIX s pomocí Generického adaptéru protokolů musí mít uživatel stejná nebo větší privilegia než instalátor WebSphere MQ.
Abyste si ulehčili práci s tímto omezením, přesuňte chybové protokoly MQ do adresáře se stejnými privilegii jako uživatel Generického adaptéru protokolů, pak můžete analyzovat protokoly.
Při pokusu použít soubory runregex_showlog_example.bat a the runregex_showlog_example.sh pro analýzu protokolu aktivity serveru WebSphere Application Server nebyla nalezena utilita protokolu zobrazení WebSphere Application.
Abyste obešli tento problém, upravte file regex_showlog_example.adapter v editoru pravidel a aktualizujte vlastnost Konvertor senzoru, aby odkazovala na správné umístění adresáře WebSphere Application Server.
Generický adaptér protokolů generuje neplatný prvek události Common Base extendedDataElements pro záznam protokolu, pokud neexistuje žádné pravidlo, které by se shodovalo s hodnotou jména nebo typu. Prvek extendedDataElement by neměl být generován, pokud není název nebo typ analyzován ze záznamu protokolu, ale Generický adaptér protokolů generuje jeden pouze s polem pro hodnotu.
Abyste obešli tento problém, ujistěte se, že pravidla jsou poskytnutá pravidla, která způsobí, že se všechna tři pole - název, hodnota, typ - prvku extendedDataElement budou shodovat.
Když Generický adaptér protokolů pracuje v samostatném režimu mimo prostředí Eclipse, protokoluje zprávy a chyby do souboru nazývaného hgla.log v aktuálním pracovním adresáři. Pokud soubor hgla.log již existuje v aktuálním pracovním adresáři, vytvoří se nový soubor protokolu nazývaný hgla.nnnnnnnn.log, kde nnnnnnnn je jedinečné číslo. Když Generický adaptér protokolů pracuje jako součást operace import protokolu, chybové zprávy, které protokoluje, se zobrazují v dialogovém okně chyb v Analyzátoru protokolů a trasování.
Při práci v prostředí Eclipse v perspektivě Generického adaptéru protokolů zprávy a chyby protokolované Generickým adaptérem protokolů se zobrazí v pohledu Problémy.
Události protokolu Generického adaptéru protokolů s úrovní protokolování 5, 10, 20, 30, 50 a 60 závisejí na nastavení úrovně protokolování pro kontexty a komponenty v konfiguračním souboru adaptéru. Soubor hgla.log lze importovat do analyzátoru protokolu a trasování jako typ souboru XML události Common Base, abyste diagnostikovali problémy zjištěné Generickým adaptérem protokolů při analýze souboru protokolu.
Generický adaptér protokolů neprovedl žádné ověření platnosti, aby určil, zda analyzovaný typ souboru protokolu odpovídá konfiguračnímu souboru adaptéru. Například, pokud soubor protokolu uvedený v konfiguraci senzoru v souboru adaptéru není typu, pro který byla navržena pravidla substituce a konfigurace extraktoru v konfiguraci programu pro analýzu, mohou se vyskytnout neočekávané výsledky. Analyzování může být úspěšné bez chyby, ale výsledná data události Common Base Event budou nesprávná. Analýza může selhat s chybovou zprávou označující zjištěná nesprávná data.
Abyste obešli tento problém, ujistěte se, že soubor protokolu uvedený v konfiguraci komponenty senzoru je správného typu.
Při analýze binárních souborů protokolu aktivity serveru WebSphere Application Server na neanglických počítačích s pomocí runregex_showlog_example.bat/sh nebudou data záznamu protokolu mapována úspěšně do události Common Base. Místo toho se mohou objevit některá data záznamu protokolu v nesprávném poli události Common Base.
Při analyzování souborů protokolů, které obsahují časové označení v národním prostření jiném než je národní prostředí Generického adaptéru protokolů, s pomocí souboru adaptéru založeného na pravidlech konfigurovaného tak, aby používal atribut Formát času v pravidlu substituce pro creationTime, je pravděpodobné, že časové označení a jiná data záznamu protokolu nebyla správně analyzována. Například hodnota creationTime ve výsledné události Common Base může být nula a pole zprávy události Common Base může být prázdné.
Abyste obešli tento problém, ujistěte se, že hodnoty kódu jazyka ISO a atributy kódu země ISO instance kontextu v souboru adaptéru založeném na pravidlech odpovídají umístění časového označení v souboru protokolu určeného pro analýzu.
Při konvertování souborů protokolu, který používá třípísmenné symboly pro časovou zónu, na formát události Common Base s pomocí Generického adaptéru protokolů mohou následně vznikat nesprávné časy vytvoření pro události protokolu, pokud třípísmenné symboly pro časovou zónu nejsou jedinečné. Například třípísmenný symbol "IST" může být vyložen jako Israeli Standard Time, Indian Standard Time, Iran Standard Time nebo Irish Summer Time.
Pokud analyzujete protokol IBM(R) DB2(R) Express Diagnositic s adaptéry v % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, výsledná událost Common Base zapisovaná do výstupního souboru přeruší některé specifikace události 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 analyzování. Neexistuje žádné náhradní řešení, dokud neopravíte soubor db2diag.exe.
Analýza souboru protokolu souborem adaptéru vytvořeným pomocí předchozí verze Konfiguračního editoru adaptéru může způsobit následující chybové zprávy, které se zapíšou do souboru protokolu Generického adaptéru protokolů hgla.log:
IWAT0383E Chyba ověření platnosti adaptéru: cvc-complex-type.4: Atribut 'lineBreakSymbol' se musí objevit v prvku 'ex:Extractor'.
Starší verze Konfiguračního editoru adaptéru vytvořily soubory adaptéru bez požadovaných atributů extraktoru lineBreakSymbol. Tento atribut musí být přítomný v prvku Extractor, i když má prázdnou hodnotu. Generický adaptér protokolu nyní ověřuje platnost souboru adaptéru na schématu Generického adaptéru protokolů, pak jej použije a lineBreakSymbol je ve schématu požadovaný atribut.
Abyste obešli tento problém, otevřete soubor adaptéru v Konfiguračním editoru adaptéru, přidejte neprázdnou hodnotu do pole lineBreakSymbol prvku Extractor, uložte soubor adaptéru, potom odstraňte hodnotu, není-li povinná, a uložte soubor znova. Soubor adaptéru bude nyní obsahovat atribut lineBreakSymbol v prvku Extractor.
Analýza souboru protokolu souborem adaptéru vytvořeným pomocí předchozí verze Konfiguračního editoru adaptéru může způsobit následující chybové zprávy, které se zapíšou do souboru protokolu Generického adaptéru protokolů hgla.log:
IWAT0438E Program pro formátování události Common Base N76D20B0042411D98000E0362B33D6F0 nemůže vytvořit CommmonBaseEvent, protože požadovaná vlastnost sourceComponentId chybí.
Tato zpráva označuje, že komponenta programu pro formátování Generického adaptéru protokolů nevytvořil událost Common Base, protože sourceComponentId je povinná vlastnost události Common Base a chybí. Generický adaptér protokolů nyní ověřuje, že všechny požadované vlastnosti jsou přítomné v události Common Base, a pokud některé vlastnosti chybí, událost Common Base není vrácena. Soubor adaptéru nemusí mít pravidla analyzování pro vlastnosti označené ve zprávách, nebo pravidla analyzování nejsou správná.
Abyste obešli tento problém, přidejte pravidla analyzátoru do souboru adaptéru pro chybějící požadované vlastnosti událostí Common Base, nebo ověřte, že existující pravidla jsou správná.
Při analýze protokolů mohou být do konzoly zapsány následující chybové zprávy:
IWAT0310E Generický adaptér protokolů nemohl být spuštěn kvůli problémům s konfigurací. IWAT0317E Chyba při výstavbě komponenty AdapterLogSensor. IWAT0319E Pro třídu org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor nelze vytvořit instanci. Výjimka = org/eclipse/emf/ecore/EObjectAbyste obešli tento problém, proveďte následující aktualizace volby -classpath v souborech skriptů běhových komponent gla.bat a gla.sh: