Poznámky k vydání Generického adaptéru protokolů

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

Známé problémy a náhradní řešení

1.0 Poslední záznam nebyl zpracován, když Generický adaptér protokolů běží nepřetržitě
1.1 Omezení při analýze protokolů WebSphere Application Server na systému UNIX
1.2 Omezení při analýze protokolů WebSphere MQ Error na systému UNIX
1.3 Problémy při analýze souborů protokolu s pomocí runregex_showlog_example.bat/sh
1.5 Generován neplatný rozšířený datový prvek
1.7 Omezení a zaprotokolované informace o Generickém adaptéru protokolů
1.8 Nebylo provedeno žádné ověření platnosti na typu souboru protokolu
1.9 Omezení při analýze souborů WebSphere Application Server activity.log
1.10 Omezení při analýze souborů protokolu generovaných na jiném umístění
1.12 Analýza souborů protokolu s nejedinečnými třípísmennými symboly časové zóny mohla navrátit nesprávné časy vytvoření pro události
1.13 Události Common Base analyzované pro protokol DB2 Express Diagnostic nejsou pro specifikaci
1.14 Chyba ověření platnosti adaptéru při analýze souboru protokolu
1.15 Chyby formátu při analýze souborů protokolu
1.16 Problémy s konfigurací při analýze protokolů

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

1.0 Poslední záznam nebyl zpracován, když Generický adaptér protokolů běží nepřetržitě

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

1.1 Omezení při analýze protokolů serveru WebSphere Application Server na systému UNIX

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.

1.2 Omezení při analýze protokolů serveru WebSphere MQ Error na systému UNIX

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.

1.3 Problémy při analýze souborů protokolu s pomocí runregex_showlog_example.bat/sh

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.

1.5 Generovány neplatné rozšířené datové prvky

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.

1.7 Zaprotokolované informace o Generickém adaptéru protokolů

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.

1.8 Nebylo provedeno žádné ověření platnosti na typu 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.

1.9 Omezení při analýze souboru serveru WebSphere Application Server activity.log

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.

1.10 Omezení při analýze souborů protokolu generovaných na jiném umístění

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.

1.12 Analýza souborů protokolu s nejedinečnými třípísmennými symboly časové zóny může vrátit nesprávný čas vytvoření událostí

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.

1.13 Události Common Base analyzované pro protokol DB2 Express Diagnostic nejsou pro specifikaci

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.

1.14 Chyba ověření platnosti adaptéru při analýze souboru protokolu

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.

1.15 Chyby programu pro formátování při analýze souborů protokolů

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

1.16 Problémy s konfigurací při analýze protokolů

Při analýze protokolů mohou být do konzole zapsány následující chybové zprávy:

Abyste 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:



Poznámky

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
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

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
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

Následující odstavec není určen pro Spojené království ani žádnou jinou zemi, kde takováto ustanovení nejsou v souladu s místními právními předpisy: SPOLEČNOST INTERNATIONAL BUSINESS MACHINES POSKYTUJE TUTO PUBLIKACI NA BÁZI "JAK JE" (AS IS) BEZ ZÁRUKY JAKÉHOKOLIV DRUHU, VYJÁDŘENÉ NEBO ODVOZENÉ, VČETNĚ, MIMO JINÉ, ODVOZENÉ ZÁRUKY NEPORUŠOVÁNÍ PRÁV TŘETÍCH STRAN, ZÁRUKY PRODEJNOSTI NEBO VHODNOSTI PRO URČITÝ ÚČEL. V některých státech nejsou prohlášení týkající se přímých či odvozených záruk v určitých případech dovolena, a proto se vás toto prohlášení nemusí týkat.

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 Corporation
U59/600
3600 Steeles Ave East,
Markham, ON; L3R 9Z7
Canada

Poskytnutí 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.

Rozhraní programování

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

Ochranné známky a servisní značky

Následující výrazy jsou ochranné známky IBM Corporation ve Spojených státech a případně v dalších jiných zemích:

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.