© Copyright International Business Machines Corporation 2000, 2006. Wszelkie prawa zastrzeżone. Ograniczone prawa na rzecz rządu Stanów Zjednoczonych - używanie produktów, tworzenie ich duplikatów oraz ujawnianie informacji o nich podlega zastrzeżeniom zawartym w umowie GSA ADP Schedule zawartej z firmą IBM Corp.
Dodatkowe informacje związane z ogólnym adapterem dziennika TPTP dostępne są w uwagach do wydania produktu TPTP, wersja 4.2.
Gdy Ogólny adapter dziennika stale monitoruje plik dziennika, to jeśli nie zostanie określony wzorzec końca, ostatni rekord nie będzie przetwarzany. Ostatni rekord zostanie przetworzony tylko w momencie wyłączania ogólnego adaptera dziennika.
Aby zapewnić przetwarzanie ostatniego rekordu podczas monitorowania, należy podać wzorzec rekordów w pliku konfiguracyjnym ogólnego adaptera dziennika.
Podczas analizowania dzienników działań binarnych lub obsługi serwera WebSphere(R) Application Server na platformach UNIXTM za pomocą ogólnego adaptera dziennika, użytkownik musi mieć uprawnienia równe lub większe niż instalator serwera WebSphere Application Server.
Aby obejść to ograniczenie, dzienniki działań binarnych lub obsługi należy przenieść do katalogu z takimi samymi uprawnieniami, jakie ma użytkownik ogólnego adaptera dziennika.
Podczas analizowania dzienników błędów produktu WebSphere MQ na platformach UNIX za pomocą ogólnego adaptera dziennika użytkownik musi mieć uprawnienia równe lub większe niż instalator produktu WebSphere MQ.
Aby obejść to ograniczenie, dzienniki błędów MQ należy przenieść do katalogu z takimi samymi uprawnieniami, jakie ma użytkownik ogólnego adaptera dziennika.
Podczas próby użycia komend runregex_showlog_example.bat i runregex_showlog_example.sh do analizowania dziennika działań serwera WebSphere Application Server nie można znaleźć programu narzędziowego showlog serwera WebSphere Application.
Aby obejść ten problem, należy dokonać edycji pliku regex_showlog_example.adapter w edytorze reguł i zaktualizować właściwość Sensor Converter, aby wskazywała poprawny katalog serwera WebSphere Application Server.
Ogólny adapter dziennika wygeneruje niepoprawny składnik extendedDataElements modelu Common Base Event dla rekordu dziennika, jeśli brakuje reguły zgodnej z wartością nazwy lub typu. Składnik extendedDataElement nie powinien być generowany, jeśli w rekordzie dziennika brakuje pola nazwy lub typu, ale ogólny adapter dziennika wygeneruje go, jednak tylko z polem wartości.
Aby obejść ten problem, należy upewnić się, czy określone zostały reguły, które umożliwiają dopasowanie wszystkich trzech pól - nazwa, wartość, typ - składnika extendedDataElement.
Gdy ogólny adapter dziennika działa w trybie autonomicznym, poza środowiskiem Eclipse, komunikaty i błędy rejestruje w pliku hgla.log znajdującym się w bieżącym katalogu roboczym. Jeśli plik hgla.log już istnieje w bieżącym katalogu roboczym, nowy plik dziennika jest tworzony z wykorzystaniem nazwy hgla.nnnnnnnn.log, gdzie nnnnnnnn jest unikalną liczbą. Gdy Ogólny adapter dziennika jest uruchamiany jako cześć operacji importowania dziennika, komunikaty o błędach rejestrowane przez niego są wyświetlane w oknie dialogowym błędu w Analizatorze dzienników i śladów.
W przypadku uruchamiania w środowisku Eclipse w perspektywie ogólnego adaptera dziennika, komunikaty i błędy rejestrowane przez Ogólny adapter dziennika umieszczane są w widoku Problemy.
Ogólny adapter dziennika rejestruje zdarzenia mające poziom 5, 10, 20, 30, 50 i 60, w zależności od ustawienia właściwości loggingLevel dla kontekstów i komponentów w pliku konfiguracyjnym adaptera. Plik hgla.log można zaimportować do Analizatora dzienników i śladów jako plik typu XML modelu Common Base Event w celu zdiagnozowania problemów napotkanych przez ogólny adapter dziennika podczas analizowania pliku dziennika.
Ogólny adapter dziennika nie przeprowadza sprawdzania poprawności w celu określenia, czy typ analizowanego pliku dziennika jest zgodny z plikiem konfiguracyjnym adaptera. Na przykład jeśli plik dziennika określony w konfiguracji czujnika w pliku adaptera ma inny typ niż ten, dla którego zaprojektowana została konfiguracja ekstraktora oraz reguły podstawiania w konfiguracji analizatora, mogą wystąpić nieprzewidywalne rezultaty. Analizowanie może zostać przeprowadzone bez błędu, ale wynikowe dane modelu Common Base Event mogą być niepoprawne. Analizowanie może nie powieść i pojawią się komunikaty o błędach wskazujące napotkanie niepoprawnych danych.
Aby obejść ten problem, należy upewnić się, czy plik dziennika określony w konfiguracji komponentu czujnika ma poprawny typ.
Podczas analizowania binarnych plików dziennika działania serwera WebSphere Application Server na komputerach z ustawieniami narodowymi innymi niż język angielski za pomocą polecenia runregex_showlog_example.bat/sh dane rekordu dziennika nie zostaną pomyślnie odwzorowane na model Common Base Event. Zamiast tego niektóre dane rekordów dziennika mogą pojawić się w niepoprawnym polu modelu Common Base Event.
Analizowanie plików dziennika zawierających datowniki z ustawień narodowych innych niż ustawienia narodowe dla ogólnego adaptera dziennika, z wykorzystaniem pliku adaptera opartego na regułach, który jest skonfigurowany z atrybutem Time Format w regule podstawiania dla parametru creationTime, może spowodować, że datownik oraz pozostałe dane rekordu dziennika będą analizowane niepoprawnie. Na przykład wartości parametru creationTime w wynikowym modelu Common Base Events mogą wynosić zero, a pole msg modelu Common Base Event może być puste.
Aby obejść ten problem, należy się upewnić, czy wartości atrybutów kodu ISO języka i kod ISO kraju w parametrze Context Instance w pliku adaptera opartego o reguły odpowiadają ustawieniu narodowemu datownika w analizowanym pliku dziennika.
Podczas konwertowania plików dziennika, w których wykorzystywane są trzyliterowe symbole strefy czasowej, do formatu modelu Common Base Event za pomocą ogólnego adaptera dziennika, dla zdarzeń dziennika mogą powstać niepoprawne czasy wystąpień, jeśli trzyliterowy symbol strefy czasowej powtarza się. Na przykład trzyliterowy symbol "IST" może być interpretowany jako Israeli Standard Time (izraelski czas standardowy), Indian Standard Time (indyjski czas standardowy), Iran Standard Time (irański czas standardowy) lub Irish Summer Time (irlandzki czas letni).
Jeśli dziennik diagnostyczny produktu IBM(R) DB2(R) Express jest analizowany w folderze % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, wynikowy model Common Base Events zapisywany w pliku wyjściowym jest niezgodny z częścią specyfikacji modelu Common Base Event. Jest to spowodowane błędem w programie narzędziowym db2diag.exe, który jest wykorzystywany do konwertowania dzienników diagnostycznych DB2 do modelu Common Base Events. Nie powinno to wpływać na operację analizowania. Do czasu poprawienia programu narzędziowego db2diag.exe nie ma żadnego znanego obejścia tego problemu.
Analizowanie pliku dziennika za pomocą pliku adaptera utworzonego w poprzedniej wersji edytora Adapter Configuration Editor może spowodować zapisanie w pliku hgla.log ogólnego adaptera dziennika następującego komunikatu o błędzie:
IWAT0383E Adapter Validation Error: cvc-complex-type.4: Attribute 'lineBreakSymbol' must appear on element 'ex:Extractor'.
Starsze wersje edytora Adapter Configuration Editor tworzyły pliki adaptera bez wymaganego atrybutu Extractor lineBreakSymbol. Ten atrybut musi być obecny w składniku Extractor, nawet jeśli nie ma wartości. Ogólny adapter dziennika obecnie sprawdza poprawność pliku adaptera, zanim zostanie on użyty, zgodnie ze schematem ogólnego adaptera dziennika, a atrybut lineBreakSymbol jest wymaganym atrybutem w tym schemacie.
Aby obejść ten problem, w edytorze Adapter Configuration Editor należy otworzyć plik adaptera, w polu lineBreakSymbol składnika Extractor dodać niepustą wartość, zapisać plik adaptera, a następnie usunąć tą wartość, jeśli nie jest ona potrzebna i zapisać plik ponownie. Plik adaptera będzie teraz zawierał w składniku Extractor atrybut lineBreakSymbol.
Analizowanie pliku dziennika za pomocą pliku adaptera utworzonego w poprzedniej wersji edytora Adapter Configuration Editor może spowodować zapisanie w pliku hgla.log ogólnego adaptera dziennika następujących komunikatów o błędzie:
IWAT0438E Common Base Event formatter N76D20B0042411D98000E0362B33D6F0 cannot create a CommmonBaseEvent because required property sourceComponentId is missing.
Ten komunikat wskazuje, że komponent formatera ogólnego adaptera dziennika nie może utworzyć modelu Common Base Event, ponieważ brakuje wymaganej właściwości sourceComponentId modelu Common Base Event. Ogólny adapter dziennika sprawdza, czy istnieją wszystkie wymagane właściwości modelu Common Base Event, i jeśli jakiejkolwiek brakuje, model Common Base Event nie jest zwracany. Plik adaptera może nie mieć reguł analizowania dla właściwości wskazanych w komunikacie lub reguły analizowania są niepoprawne.
Aby obejść ten problem, do pliku adaptera należy dodać reguły analizowania dla brakujących wymaganych właściwości modelu Common Base Event lub sprawdzić, czy istniejące reguły są poprawne.
Podczas analizowania dzienników na konsoli mogą zostać wyświetlone następujące komunikaty o błędach:
IWAT0310E Generic Log Adapter could not be started due to configuration problems. IWAT0317E Error building component AdapterLogSensor. IWAT0319E Class org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor cannot be instantiated. Exception = org/eclipse/emf/ecore/EObjectAby obejść ten problem, w plikach skryptowych gla.bat i gla.sh środowiska wykonawczego należy wprowadzić następujące zmiany dla opcji -classpath:
Niniejsza publikacja została przygotowana z myślą o produktach i usługach oferowanych w Stanach Zjednoczonych.
IBM może nie oferować w innych krajach produktów, usług lub opcji omawianych w tej publikacji. Informacje o produktach i usługach dostępnych w danym kraju można uzyskać od lokalnego przedstawiciela IBM. Odwołanie do produktu, programu lub usługi IBM nie oznacza, że można użyć wyłącznie tego produktu, programu lub usługi. Zamiast nich można zastosować ich odpowiednik funkcjonalny pod warunkiem, że nie narusza to praw własności intelektualnej IBM. Jednakże cała odpowiedzialność za ocenę przydatności i sprawdzenie działania produktu, programu lub usługi pochodzących od producenta innego niż IBM spoczywa na użytkowniku.
IBM może posiadać patenty lub złożone wnioski patentowe na towary i usługi, o których mowa w niniejszej publikacji. Przedstawienie tej publikacji nie daje żadnych uprawnień licencyjnych do tychże patentów. Pisemne zapytania w sprawie licencji można przesyłać na adres:
IBM Director of Licensing
Zapytania w sprawie licencji na informacje dotyczące zestawów znaków dwubajtowych (DBCS) należy kierować do lokalnych działów własności intelektualnej IBM (IBM Intellectual Property Department) lub zgłaszać na piśmie pod adresem:
IBM World Trade Asia Corporation
Informacje zawarte w niniejszej publikacji mogą zawierać nieścisłości techniczne lub błędy drukarskie. Informacje te są okresowo aktualizowane, a zmiany te zostaną ujęte w kolejnych wydaniach tej publikacji. IBM zastrzega sobie prawo do wprowadzania ulepszeń i/lub zmian w produktach i/lub programach opisanych w tej publikacji w dowolnym czasie, bez wcześniejszego powiadomienia.
Wszelkie wzmianki w tej publikacji na temat stron internetowych innych podmiotów zostały wprowadzone wyłącznie dla wygody użytkowników i w żadnym wypadku nie stanowią zachęty do ich odwiedzania. Materiały dostępne na tych stronach nie są częścią materiałów opracowanych dla tego produktu IBM, a użytkownik korzysta z nich na własną odpowiedzialność.IBM ma prawo do korzystania i rozpowszechniania informacji przysłanych przez użytkownika w dowolny sposób, jaki uzna za właściwy, bez żadnych zobowiązań wobec ich autora.
Licencjobiorcy tego programu, którzy chcieliby uzyskać informacje na temat programu w celu: (i) wdrożenia wymiany informacji między niezależnie utworzonymi programami i innymi programami (łącznie z tym opisywanym) oraz (ii) wspólnego wykorzystywania wymienianych informacji, powinni skontaktować się z:
IBM CorporationInformacje takie mogą być udostępnione, o ile spełnione zostaną odpowiednie warunki, w tym, w niektórych przypadkach, uiszczenie odpowiedniej opłaty.
Licencjonowany program opisany w niniejszej publikacji oraz wszystkie inne licencjonowane materiały dostępne dla tego programu są dostarczane przez IBM na warunkach określonych w Umowie IBM z Klientem, Międzynarodowej Umowie Licencyjnej IBM na Program lub w innych podobnych umowach zawartych między IBM i użytkownikami.
Wszelkie dane dotyczące wydajności zostały zebrane w kontrolowanym środowisku. W związku z tym rezultaty uzyskane w innych środowiskach operacyjnych mogą się znacząco różnić. Niektóre pomiary mogły być dokonywane na systemach będących w fazie rozwoju i nie ma gwarancji, że pomiary te wykonane na ogólnie dostępnych systemach dadzą takie same wyniki. Niektóre z pomiarów mogły być estymowane przez ekstrapolację. Rzeczywiste wyniki mogą być inne. Użytkownicy powinni we własnym zakresie sprawdzić odpowiednie dane dla ich środowiska.
Informacje dotyczące produktów innych podmiotów uzyskano od dostawców tych produktów, z opublikowanych zapowiedzi lub innych powszechnie dostępnych źródeł. IBM nie testował tych produktów i nie może potwierdzić dokładności pomiarów wydajności, kompatybilności ani żadnych innych danych związanych z tymi produktami. Pytania dotyczące możliwości produktów innych podmiotów należy kierować do dostawców tych produktów.
LICENCJA W ZAKRESIE PRAW AUTORSKICH:Niniejsza publikacja zawiera przykładowe aplikacje w kodzie źródłowym, ilustrujące techniki programowania w różnych systemach operacyjnych. Użytkownik może kopiować, modyfikować i dystrybuować te programy przykładowe w dowolnej formie bez uiszczania opłat na rzecz IBM, w celu projektowania, używania, sprzedaży lub dystrybucji aplikacji zgodnych z aplikacyjnym interfejsem programowym dla tego systemu operacyjnego, dla którego napisane zostały programy przykładowe. Kody te nie zostały kompleksowo przetestowane we wszelkich możliwych warunkach. IBM nie może zatem gwarantować ani sugerować niezawodności, użyteczności i funkcjonalności tych programów.
Każda kopia programu przykładowego lub jakikolwiek jego fragment, jak też jakiekolwiek prace pochodne muszą zawierać następujące uwagi dotyczące praw autorskich:(C) (nazwa przedsiębiorstwa użytkownika, rok). Fragmenty tego kodu pochodzą z programów przykładowych IBM Corp. (C) Copyright IBM Corp. 2006. Wszelkie prawa zastrzeżone.
W przypadku przeglądania niniejszych informacji w formie elektronicznej, zdjęcia i kolorowe ilustracje mogą nie być wyświetlane.
Informacje dotyczące interfejsu programistycznego mają służyć jako pomoc przy tworzeniu aplikacji, korzystając z tego programu.
Ogólnie używane interfejsy programistyczne umożliwiają pisanie aplikacji, które korzystają z usług narzędzi tego programu.
Informacje te mogą również zawierać informacje na temat diagnostyki, modyfikacji i strojenia. Tego typu informacje są udostępniane jako pomoc przy debugowaniu aplikacji.
Ostrzeżenie: Informacji na temat diagnostyki, modyfikacji i strojenia nie należy wykorzystywać w interfejsie programistycznym, ponieważ mogą one ulec zmianie.
Java oraz wszystkie znaki towarowe dotyczące języka Java są znakami towarowymi Sun Microsystems, Inc. w Stanach Zjednoczonych i/lub w innych krajach.
Microsoft, Windows, Windows NT oraz logo Windows są znakami towarowymi Microsoft Corporation w Stanach Zjednoczonych i/lub w innych krajach.
Intel, Intel Xeon oraz Pentium są znakami towarowymi lub zastrzeżonymi znakami towarowymi Intel Corporation lub przedsiębiorstw podporządkowanych Intel Corporation w Stanach Zjednoczonych i/lub w innych krajach.
UNIX jest zastrzeżonym znakiem towarowym Open Group w Stanach Zjednoczonych i w innych krajach.
Linux jest zastrzeżonym znakiem towarowym Linusa Torvaldsa w Stanach Zjednoczonych i/lub w innych krajach.
Nazwy innych przedsiębiorstw, produktów lub usług mogą być znakami towarowymi lub znakami usług innych podmiotów.
(C) Copyright IBM Corporation 2000, 2006. Wszelkie prawa zastrzeżone.