Uwagi do wydania dotyczące ogólnego adaptera dziennika

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

Znane problemy oraz sposoby ich obejścia

1.0 Gdy Ogólny adapter dziennika jest stale aktywny, ostatni rekord nie jest przetwarzany
1.1 Ograniczenie analizowania dzienników serwera WebSphere Application Server w systemie UNIX
1.2 Ograniczenie analizowania dzienników błędów produktu WebSphere MQ w systemie UNIX
1.3 Problemy podczas analizowania plików dziennika za pomocą komendy runregex_showlog_example.bat/sh
1.5 Niepoprawnie generowane rozszerzone składniki danych
1.7 Informacje i ograniczenia rejestrowania Ogólnego adaptera dziennika
1.8 Brak sprawdzania poprawności dla typu pliku dziennika
1.9 Ograniczenie analizowania plików activity.log serwera WebSphere Application Server
1.10 Ograniczenie analizowania plików dziennika wygenerowanych dla innych ustawień narodowych
1.12 Analizowanie plików dziennika z powtarzającymi się trzyliterowymi symbolami strefy czasowej może spowodować zwrócenie niepoprawnych czasów wystąpień zdarzeń
1.13 Modele Common Base Event analizowane dla dziennika diagnostycznego produktu DB2 Express nie są zgodne ze specyfikacją
1.14 Błąd sprawdzania poprawności adaptera podczas analizowania pliku dziennika
1.15 Błędy formatera podczas analizowania pliku dziennika
1.16 Problemy związane z konfigurowaniem podczas analizowania dzienników

Dodatkowe informacje związane z Ogólnym adapterem dziennika TPTP dostępne są w uwagach do wydania produktu TPTP, wersja 4.2.

1.0 Gdy Ogólny adapter dziennika jest stale aktywny, ostatni rekord nie jest przetwarzany

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.

1.1 Ograniczenie analizowania dzienników serwera WebSphere Application Server w systemie UNIX

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.

1.2 Ograniczenie analizowania dzienników błędów produktu WebSphere MQ w systemie UNIX

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.

1.3 Problemy podczas analizowania plików dziennika za pomocą komendy runregex_showlog_example.bat/sh

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.

1.5 Niepoprawnie generowane rozszerzone składniki danych

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.

1.7 Informacje rejestrowania Ogólnego adaptera dziennika

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.

1.8 Brak sprawdzania poprawności dla typu 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.

1.9 Ograniczenie analizowania plików activity.log serwera WebSphere Application Server

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.

1.10 Ograniczenie analizowania plików dziennika wygenerowanych dla innych ustawień narodowych

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.

1.12 Analizowanie plików dziennika z powtarzającymi się trzyliterowymi symbolami strefy czasowej może spowodować zwrócenie niepoprawnych czasów wystąpień zdarzeń

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

1.13 Modele Common Base Event analizowane dla dziennika diagnostycznego produktu DB2 Express nie są zgodne ze specyfikacją

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.

1.14 Błąd sprawdzania poprawności adaptera podczas analizowania pliku dziennika

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 Błąd podczas sprawdzania poprawności adaptera: cvc-complex-type.4: Atrybut 
'lineBreakSymbol' musi występować w elemencie '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.

1.15 Błędy formatera podczas analizowania pliku dziennika

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 Formater Common Base Event N76D20B0042411D98000E0362B33D6F0 nie może 
utworzyć zdarzenia CommmonBaseEvent z powodu braku wymaganej właściwości sourceComponentId.

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.

1.16 Problemy związane z konfigurowaniem podczas analizowania dzienników

Podczas analizowania dzienników na konsoli mogą zostać wyświetlone następujące komunikaty o błędach:

Aby obejść ten problem, w plikach skryptowych gla.bat i gla.sh środowiska wykonawczego należy wprowadzić następujące zmiany dla opcji -classpath: