© Copyright International Business Machines Corporation 2000, 2006. All rights reserved.
© Copyright IBM Deutschland GmbH 2000, 2006. Alle Rechte vorbehalten.
Weitere Readme-Informationen zu TPTP Generic Log Adapter finden Sie in den Release Notes for TPTP V4.2.
Wenn Generic Log Adapter eine Protokolldatei ununterbrochen überwacht, wird der letzte Datensatz nicht verarbeitet, sofern kein Endmuster angegeben ist. Der letzte Datensatz wird erst beim Beenden von Generic Log Adapter verarbeitet.
Um sicherzustellen, dass der letzte Datensatz während der Überwachung verarbeitet wird, stellen Sie ein Endmuster für die Datensätze in der Konfigurationsdatei von Generic Log Adapter bereit.
Bei der Syntaxanalyse von binären Aktivitäts- oder Serviceprotokollen von WebSphere(R) Application Server auf UNIXTM-Plattformen unter Verwendung von Generic Log Adapter muss der Benutzer über die gleichen oder höhere Zugriffsrechte verfügen wie die Person, die WebSphere Application Server installiert.
Um diese Einschränkung zu umgehen, verschieben Sie vor der Ausführung der Syntaxanalyse der Protokolle das binäre Aktivitäts- bzw. Serviceprotokoll in ein Verzeichnis, das über die gleichen Zugriffsrechte verfügt wie der Benutzer von Generic Log Adapter.
Bei der Syntaxanalyse von WebSphere MQ-Fehlerprotokollen auf UNIX-Plattformen unter Verwendung von Generic Log Adapter muss der Benutzer über die gleichen oder höhere Zugriffsrechte verfügen wie die Person, die WebSphere MQ installiert.
Um diese Einschränkung zu umgehen, verschieben Sie vor der Ausführung der Syntaxanalyse der Protokolle die MQ-Fehlerprotokolle in ein Verzeichnis, das über die gleichen Zugriffsrechte verfügt wie der Benutzer von Generic Log Adapter.
Bei dem Versuch, die Dateien 'runregex_showlog_example.bat' und 'runregex_showlog_example.sh' für die Syntaxanalyse eines WebSphere Application Server-Aktivitätsprotokolls zu verwenden, kann das Dienstprogramm zur Protokollanzeige von WebSphere Application nicht gefunden werden.
Um dieses Problem zu umgehen, bearbeiten Sie die Datei 'regex_showlog_example.adapter' im Regeleditor, und aktualisieren das Merkmal 'Sensor Converter', so dass dieses auf die korrekte Verzeichnisposition von WebSphere Application Server zeigt.
Generic Log Adapter generiert ein ungültiges CBE-Element (CBE = Common Base Event, allgemeines Basisereignis) 'extendedDataElements' für einen Protokollsatz, wenn keine übereinstimmende Regel für den Namens- oder Typwert vorhanden ist. Das Element 'extendedDataElement' sollte nicht generiert werden, wenn kein Name oder Typ vom Protokollsatz syntaktisch analysiert wird, aber Generic Log Adapter generiert ein Element mit nur dem Wertfeld.
Um dieses Problem zu umgehen, stellen Sie sicher, dass Regeln bereitgestellt werden, mit deren Hilfe alle drei Felder - Name, Wert, Typ - von 'extendedDataElement' abgeglichen werden.
Wird Generic Log Adapter außerhalb einer Eclipse-Umgebung im Standalone-Modus ausgeführt, werden Nachrichten und Fehler in einer Datei mit dem Namen hgla.log im aktuellen Arbeitsverzeichnis protokolliert. Sollte das aktuelle Arbeitsverzeichnis bereits eine Datei mit dem Namen hgla.log enthalten, wird eine neue Protokolldatei mit der Namenskonvention hgla.nnnnnnnn.log erstellt, wobei nnnnnnnn stellvertretend für eine eindeutige Zahl steht. Wird Generic Log Adapter als Teil einer Protokollimportoperation ausgeführt, werden die von ihm protokollierten Fehlernachrichten in einem Fehlerdialog in Log and Trace Analyzer angezeigt.
Bei einer Ausführung innerhalb einer Eclipse-Umgebung in der Perspektive von Generic Log Adapter werden die von Generic Log Adapter protokollierten Nachrichten und Fehler in der Problemsicht aufgelistet.
Generic Log Adapter protokolliert Ereignisse mit den Protokollstufen 10, 20, 30, 50 und 60, wobei die Protokollstufe von der jeweiligen Einstellung für 'loggingLevel' für Kontexte und Komponenten in der Adapterkonfigurationsdatei abhängig ist. Die Datei hgla.log kann als CBE-XML-Dateityp in Log and Trace Analyzer importiert werden, um Fehler zu ermitteln, die in Generic Log Adapter bei der Syntaxanalyse der Protokolldatei auftreten.
Generic Log Adapter führt keine Überprüfung durch, um zu ermitteln, ob der Typ der syntaktisch analysierten Protokolldatei mit der Adapterdateikonfiguration übereinstimmt. Wenn beispielsweise die für die Sensorkonfiguration in der Adapterdatei angegebene Protokolldatei nicht der Typ ist, für den die Konfigurations- und Substitutionsregeln des Extrahierungsprogramms in der Parserkonfiguration entworfen wurden, können unvorhersehbare Ereignisse auftreten. Die Syntaxanalyse wird zwar unter Umständen fehlerfrei fortgesetzt, die resultierenden CBE-Daten sind jedoch nicht korrekt. Die Syntaxanalyse kann fehlschlagen, und Fehlernachrichten geben an, dass nicht korrekte Daten gefunden wurden.
Um dieses Problem zu umgehen, stellen Sie sicher, dass die in der Konfiguration der Sensorkomponente angegebene Protokolldatei den korrekten Typ aufweist.
Bei der Syntaxanalyse von binären Aktivitätenprotokolldateien von WebSphere Application Server auf nicht englischsprachigen Maschinen unter Verwendung von runregex_showlog_example.bat/sh werden die Protokollsatzdaten nicht erfolgreich einem CBE zugeordnet. Stattdessen können einige Protokollsatzdaten in einem nicht korrekten CBE-Feld erscheinen.
Wenn bei der Syntaxanalyse von Protokolldateien mit Zeitmarken in einer anderen Ländereinstellung als diejenige, in der Generic Log Adapter ausgeführt wird, eine regelbasierte Adapterdatei verwendet wird, die für die Verwendung des Attributs 'Time Format' in der Substitutionsregel für 'creationTime' konfiguriert wurde, werden die Zeitmarke und andere Protokollsatzdaten unter Umständen nicht korrekt syntaktisch analysiert. Als Werte für 'creationTime' werden in den resultierenden CBEs unter Umständen Nullwerte angegeben, und das CBE-Feld 'msg' bleibt möglicherweise leer.
Um dieses Problem zu vermeiden, stellen Sie sicher, dass die Werte für die ISO-Sprachencodeattribute und die ISO-Landescodeattribute für das Kontextexemplar ('Context Instance') in der Datei für den regelbasierten Adapter der Ländereinstellung der Zeitmarken in der Protokolldatei entsprechen, für die eine Syntaxanalyse ausgeführt werden soll.
Das Konvertieren von Protokolldateien, die Zeitzonensymbole aus drei Buchstaben verwenden, in CBE-Format mit Hilfe von Generic Log Adapter kann fehlerhafte Uhrzeiten für die Erstellung von Protokollereignissen zur Folge haben, wenn das Zeitzonensymbol aus drei Buchstaben besteht und nicht eindeutig ist. Das aus drei Buchstaben bestehende Symbol 'IST' könnte zum Beispiel als 'Israeli Standard Time', 'Indian Standard Time', 'Iran Standard Time' oder 'Irish Summer Time' interpretiert werden.
Wenn Sie für IBM(R) DB2(R) Express ein Diagnoseprotokoll mit den Adaptern im Verzeichnis %GLA_Install%\GenericLogAdapter\config\DB2\diag\tool ausführen, verstoßen die daraus hervorgehenden CBEs, die in die Ausgabedatei geschrieben werden, gegen manche CBE-Spezifikationen. Dies ist auf einen Programmfehler im Dienstprogramm 'db2diag.exe' zurückzuführen, das zum Konvertieren der DB2-Diagnoseprotokolle in CBEs verwendet wird. Dies sollte jedoch die Syntaxanalyse als Vorgang nicht beeinträchtigen. Zu diesem Problem ist keine Fehlerumgehung möglich, solange der Programmfehler in 'db2diag.exe' nicht behoben wird.
Das Parsing einer Protokolldatei mit einer Adapterdatei, die mit einer Vorgängerversion des Adapterkonfigurationseditors erstellt wurde, kann zur Folge haben, dass eine Fehlernachricht des folgenden Typs in die Protokolldatei hgla.log von Generic Log Adapter geschrieben wird:
IWAT0383E Fehler bei der Auswertung des Adapters: cvc-complex-type.4: Attribut 'lineBreakSymbol' muss im Element 'ex:Extractor' vorkommen.
Ältere Versionen des Adapterkonfigurationseditors erstellten Adapterdateien ohne das erforderliche Extrahierungsprogrammattribut lineBreakSymbol. Dieses Attribut muss jedoch im Extrahierungsprogrammelement vorhanden sein, selbst wenn einen leeren Wert aufweist. Generic Log Adapter gleicht jetzt die Adapterdatei vor ihrer Verwendung mit dem Schema von Generic Log Adapter ab, und das Attribut lineBreakSymbol ist ein erforderliches Attribut in dem Schema.
Um dieses Problem zu umgehen, öffnen Sie die Adapterdatei im Adapterkonfigurationseditor, fügen Sie einen Wert (kein Leerzeichen) zum Feld lineBreakSymbol des Extrahierungsprogrammelements hinzu, speichern Sie die Adapterdatei, löschen Sie diesen Wert (sofern er nicht erforderlich ist) und speichern Sie die Datei erneut. Die Adapterdatei enthält nun das Attribut lineBreakSymbol im Extrahierungsprogrammelement.
Das Parsing einer Protokolldatei mit einer Adapterdatei, die mit einer Vorgängerversion des Adapterkonfigurationseditors erstellt wurde, kann zur Folge haben, dass Fehlernachrichten des folgenden Typs in die Protokolldatei hgla.log von Generic Log Adapter geschrieben werden:
IWAT0438E CBE-Formatierungsprogramm N76D20B0042411D98000E0362B33D6F0 kann kein 'CommmonBaseEvent' erstellen, da die erforderliche Eigenschaft 'sourceComponentId' fehlt.
Diese Nachricht gibt an, dass die Formatierungskomponente von Generic Log Adapter kein CBE erstellen konnte, weil sourceComponentId eine erforderliche CBE-Eigenschaft ist und fehlt. Generic Log Adapter überprüft nun, ob alle erforderlichen Eigenschaften im Common Base Event vorhanden sind. Sollten Eigenschaften fehlen, wird das Common Base Event nicht zurückgegeben. Die Adapterdatei darf keine Regeln für die Syntaxanalyse von Eigenschaften aufweisen, die in Nachrichten angegeben werden, oder die Regeln für die Syntaxanalyse sind falsch.
Um dieses Problem zu umgehen, fügen Sie für die fehlenden erforderlichen CBE-Eigenschaften Regeln für die Syntaxanalyse zur Adapterdatei hinzu oder überprüfen Sie, ob die vorhandenen Regeln korrekt sind.
Bei der Syntaxanalyse von Protokollen werden möglicherweise Fehlernachrichten des folgenden Typs in die Konsole geschrieben:
IWAT0310E Generic Log Adapter konnte wegen Konfigurationsfehlern nicht gestartet werden. IWAT0317E Fehler beim Erstellen der Komponente AdapterLogSensor. IWAT0319E Klasse org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor kann nicht instanziert werden. Ausnahme = org/eclipse/emf/ecore/EObjectUm dieses Problem zu umgehen, aktualisieren Sie die Option -classpath in den Laufzeitscriptdateien 'gla.bat' und 'gla.sh' wie folgt: