© 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 konzole 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:
Tyto informace byly vyvinuty pro produkty a služby poskytované v USA.
IBM nemusí poskytovat produkty, služby nebo funkce probírané v této dokumentaci v jiných zemích. Informace o produktech a službách, které jsou ve vaší oblasti aktuálně dostupné, získáte od místního zástupce společnosti IBM. Odkazy na produkty, programy nebo služby společnosti IBM v této publikaci nejsou míněny jako vyjádření nutnosti použití pouze uvedených produktů, programů či služeb společnosti IBM. Místo produktu, programu nebo služby společnosti IBM lze použít libovolný funkčně ekvivalentní produkt, program nebo službu, která neporušuje intelektuální vlastnická práva společnosti IBM. Ověření funkčnosti produktu, programu nebo služby pocházející od jiného výrobce je však povinností uživatele.
K jednotlivým subjektům popisovaným v tomto dokumentu se mohou vztahovat patenty nebo nevyřízené patentové přihlášky společnosti IBM. Vlastnictví tohoto dokumentu uživateli neposkytuje žádná licenční práva k těmto patentům. Dotazy týkající se licencí můžete posílat písemně na adresu:
IBM Director of Licensing
S dotazy na informace o DBCS týkajícími se licencí se obraťte na oddělení IBM Intellectual Property Department v zemi a odešlete dotaz na adresu:
IBM World Trade Asia Corporation
Uvedené údaje mohou obsahovat technické nepřesnosti nebo typografické chyby. Údaje zde uvedené jsou pravidelně upravovány a tyto změny budou zahrnuty v nových vydáních této publikace. Společnost IBM může kdykoli bez upozornění provádět vylepšení nebo změny v produktech či programech popsaných v této publikaci.
Veškeré uvedené odkazy na stránky WWW, které nespravuje společnost IBM, jsou uváděny pouze pro referenci a v žádném případě neslouží jako záruka funkčnosti těchto stránek. Materiály uvedené na těchto stránkách WWW nejsou součástí materiálů pro tento produkt IBM a použití uvedených stránek je pouze na vlastní nebezpečí.Společnost IBM může použít nebo distribuovat jakékoli informace, které jí sdělíte, libovolným způsobem, který společnost považuje za odpovídající, bez vyžádání vašeho svolení.
Vlastníci licence k tomuto programu, kteří chtějí získat informace o možnostech (i) výměny informací s nezávisle vytvořenými programy a jinými programy (včetně tohoto) a (ii) oboustranného využití vyměňovaných informací, mohou kontaktovat informační středisko na adrese:
IBM CorporationPoskytnutí takových informací může být podmíněno dodržením určitých podmínek a požadavků zahrnujících v některých případech uhrazení stanoveného poplatku.
Licencovaný program popsaný v tomto dokumentu a veškerý licencovaný materiál k němu dostupný jsou společností IBM poskytovány na základě podmínek uvedených ve smlouvách IBM Customer Agreement, IBM International Program License Agreement nebo v jiné ekvivalentní smlouvě.
Jakékoli údaje o výkonnosti obsažené v této publikaci byly zjištěny v řízeném prostředí. Výsledky získané v jakémkoli jiném operačním prostředí se proto mohou výrazně lišit. Některá měření mohla být prováděna na vývojových verzích systémů a není zaručeno, že tato měření budou stejná i na běžně dostupných systémech. Některé údaje mohly být navíc zjištěny pomocí extrapolace. Skutečné výsledky mohou být jiné. Čtenáři tohoto dokumentu by měli zjistit použitelné údaje pro své specifické prostředí.
Informace týkající se produktů jiných výrobců pocházejí od dodavatelů těchto produktů, z jejich veřejných oznámení nebo z jiných veřejně dostupných zdrojů. Společnost IBM tyto produkty netestovala a nemůže potvrdit jejich správnou výkonnost, kompatibilitu ani žádné jiné výroky týkající se produktů jiných výrobců než IBM. Otázky týkající se kompatibility produktů jiných výrobců by měly být směrovány dodavatelům těchto produktů.
LICENČNÍ INFORMACE:Tyto informace obsahují ukázkové aplikační programy ve zdrojovém jazyce ilustrující programovací techniky na různých operačních platformách. Tyto ukázkové programy můžete bez závazků vůči společnosti IBM jakýmkoli způsobem kopírovat, měnit a distribuovat za účelem vývoje, používání, odbytu či distribuce aplikačních programů odpovídajících rozhraní API pro operační platformu, pro kterou byly ukázkové programy napsány. Tyto příklady nebyly plně testovány za všech podmínek. Společnost IBM proto nemůže zaručit spolehlivost, upotřebitelnost nebo funkčnost těchto programů.
Každá kopie nebo část těchto ukázkových programů nebo jakákoli práce z nich odvozená musí obsahovat následující coprightovou doložku:(C) (název vaší společnosti) (rok). Části těchto kódů jsou odvozené z ukázkových programů společnosti IBM Corp. (C) Copyright IBM Corp. 2006. Všechna práva vyhrazena.
Pokud si tyto informace prohlížíte v elektronické podobě, nemusí se zobrazit fotografie a barevné ilustrace.
Informace o rozhraní programování by vám měly pomoci vytvořit aplikační software s pomocí tohoto programu.
Obecná rozhraní programování s obecným využitím vám umožňují psát aplikační software, které obsahují služby těchto nástrojů programu.
Avšak tyto informace mohou také obsahovat informace o diagnóze, úpravě a ladění. Informace o diagnóze, úpravě a ladění jsou poskytovány proto, aby vám pomohly ladit aplikační software.
Varování: Nepoužívejte tyto informace o diagnóze, úpravě a ladění jako rozhraní programování, protože se změní.
Java a všechny ochranné známky založené na Javě jsou ochranné známky Sun Microsystems, Inc. ve Spojených státech a případně v dalších jiných zemích.
Logo Microsoft, Windows, Windows NT a Windows jsou ochranné známky Microsoft Corporation ve Spojených státech a případně v dalších jiných zemích.
Intel, Intel Xeon a Pentium jsou ochranné známky nebo registrované ochranné známky Intel Corporation nebo dceřinných podniků ve Spojených státech a případně v dalších jiných zemích.
UNIX je registrovaná ochranná známka společnosti The Open Group ve Spojených státech a případně v dalších jiných zemích.
Linux je registrovaná ochranná známka Linuse Torvaldse ve Spojených státech a případně v dalších jiných zemích.
Jména jiných společností, produktů nebo služeb mohou být ochrannými známkami jiných společností.
(C) Copyright IBM Corporation 2000, 2006. Všechna práva vyhrazena.