Nach dem Erstellen eines Plug-in-Projekts zum Speichern der Artefakte für einen Protokollparser müssen Sie das Plug-in konfigurieren, damit es von der Protokoll- und Traceanalysefunktion verwendet werden kann. Gehen Sie folgendermaßen vor:
Die nachstehenden Plug-in-Abhängigkeiten müssen in die Plug-in-Manifestdatei integriert werden. Öffnen Sie die Datei 'plugin.xml' in einem Texteditor. Lokalisieren Sie in der Datei das erforderliche Element und fügen Sie die Plug-in-Abhängigkeiten hinzu. Beispiel:
<import plugin="org.eclipse.core.runtime"/> <requires> <import plugin="org.eclipse.hyades.logging.adapter"/> <import plugin="org.eclipse.hyades.logging.parsers"/> <import plugin="org.eclipse.hyades.logging.adapter.config"/> </requires>
Hinweis: Die oben angegebenen erforderlichen Plug-ins müssen sich entweder im Verzeichnis für Eclipse-Plug-ins befinden, oder in den aktuellen Arbeitsbereich integriert werden.
Sie müssen einen Erweiterungspunkt für jeden Typ einer Anwendungsprotokolldatei definieren, die Sie analysieren und in die Analysefunktion für Protokoll und Trace importieren möchten. Im Folgenden sehen Sie ein Beispiel für eine Erweiterungspunkt für die MyApp-Anwendung, in dem sowohl ein Regeladapter als auch ein statischer Adapter definiert ist:
<extension
point="org.eclipse.hyades.logging.parsers.logParser">
<parser
name="Sample Rules Adapter for MyApp"
icon=""
description="%STR_MYAPP_PARSER_DESCRIPTION"
class="RulesParser.StaticParserExtension"
ui_name="MyApp myapp.log file"
id="org.eclipse.hyades.logging.parsers.MyAppLogParser">
<field
useBrowse="true"
defaultValue="d:\temp\sample.log"
name="Directory"
helpContextId=""
tooltip="%STR_MYAPP_TOOLTIP1"
id="file_path"
browseType="*.log">
</field>
<field
useBrowse="false"
defaultValue="MyApp 1.0(rules), MyApp 1.0(static)"
name="Supported versions"
helpContextId=""
tooltip="%STR_MYAPP_TOOLTIP2"
ui_type="combobox"
id="version">
</field>
<parserParameter
name="MyApp 1.0(rules)"
value="./MyAdapter/myadapter.adapter">
</parserParameter>
<parserParameter
name="MyApp 1.0(static)"
value="./MyAdapter/mystaticadapter.adapter">
</parserParameter>
</parser>
</extension>
Um den Erweiterungspunkt für Ihren Protokollparser anzupassen, müssen die folgenden Aktualisierungen vorgenommen werden:
<parserParameter name="Default" value="./MyAdapter/myadapter.adapter"> </parserParameter>
Anhand der oben angegebenen Felder wird eine Option für 'MyApp myapp.log' im Assistenten 'Protokolldatei importieren'
erstellt, wie nachstehend gezeigt:
Sie können eine Datei 'plugin.properties' verwenden, um bestimmte Eigenschaften in der Datei 'plugin.xml' zu definieren, die eventuell verschiedene Versionen haben muss. Wenn es z.B. in dem Assistenten für den Import von Protokolldateien Zeichenfolgen gibt, die in verschiedene Sprachen übersetzt werden müssen, können diese in der Datei 'plugin.properties' definiert werden und Sie können verschiedene Eigenschaftsdateien für die Sprachen, die Sie unterstützen möchten, aufnehmen. In der Datei 'plugin.properties' definieren Sie Ersatzvariablen, die in der Datei 'plugin.xml' verwendet werden können. Die Datei 'plugin.properties' für die vorstehende Datei 'plugin.xml' würde wie folgt aussehen:
# Eigenschaften für das Plug-in RulesParser pluginName = RulesParser providerName = MeineFirma # Nachricht(en) für den Erweiterungspunkt des Protokollparsers: STR_MYAPP_PARSER_DESCRIPTION = 'MyApp' - Regelbasierter Parser v1.0 STR_MYAPP_TOOLTIP1 = Speicherposition der Protokolldatei eingeben STR_MYAPP_TOOLTIP2 = Version der zu importierenden Protokolldatei auswählen
Hinweis: Je nach Ländereinstellung, in der eine Anwendung ausgeführt wird, kann sie Daten in verschiedenen Sprachen in ihre Protokolldatei schreiben. Statische Parserklassen und Regeln mit regulären Ausdrücken sind so geschrieben, dass sie eine Protokolldatei in einer einzigen Sprache syntaktisch analysieren. Zur Unterstützung eines Protokolldateityps, der in mehreren Sprachen geschrieben werden kann, muss daher eine separate statische Parseradapterdatei bzw. Regeladapterdatei für jede Sprache erstellt werden. Danach sollte im Erweiterungspunkt 'logParser' dieses Protokolldateityps ein Tag 'parserParameter' für jede Adapterdatei eingefügt werden, das die Sprache angibt, die es auf das Namensfeld anwendet. Vergessen Sie nicht, die Namenswerte 'parserParameter' zur Liste im Attribut 'defaultValue' des Versionsfeldes hinzuzufügen. So kann ein Benutzer beim Import einer Protokolldatei die richtige Sprache der Protokolldatei auswählen.
Die folgenden Parserparameter können beispielsweise zum Erweiterungspunkt 'logParser' hinzugefügt werden, um den Import von englischen, französischen und deutschen Protokollen zu unterstützen:
<parserParameter name="MyApp 1.0(rules) English" value="./MyAdapter/myadapter_en.adapter"/> <parserParameter name="MyApp 1.0(rules) French" value="./MyAdapter/myadapter_fr.adapter"/> <parserParameter name="MyApp 1.0(rules) German" value="./MyAdapter/myadapter_de.adapter"/>
Dieser Schritt ist für die Erstellung eines statischen Parsers erforderlich.
Für statische Parser muss die von Ihnen erstellte statische Parserklasse in der Datei plugin.xml über eine Erweiterung staticParser angegeben werden. Über diesen Erweiterungspunkt kann die Klasse gefunden werden, wenn sie zur syntaktischen Analyse einer Datei im Protokollimportszenario verwendet werden soll.
Fügen Sie den folgenden Erweiterungspunkt hinzu:
<extension
point="org.eclipse.hyades.logging.adapter.config.staticParser">
<parserClassname
name="myLogParser33.MyStaticParser">
</parserClassname>
</extension>
Erstellen Sie eine statische Wrapperklasse zur Erweiterung von org.eclipse.hyades.logging.adapter.config.StaticParserWrapper. Diese Klasse wird von sowohl statischen als auch regelbasierten Parsern verwendet, um über die Laufzeit des generischen Protokolladapters die Adapterkonfigurationsdatei, die der vom Benutzer im Assistenten für den Protokollimport ausgewählten Version zugeordnet ist, auszuführen.
/*
* Erstellt am 12. April 2004
* StaticParserExtension-Klasse zur Verwendung im RulesParser-Plug-in erstellt
*/
package RulesParser;
import org.eclipse.hyades.logging.adapter.config.StaticParserWrapper;
/**
* @Autor/Entwickler
* StaticParserExtension-Klasse
*/
public class StaticParserExtension extends StaticParserWrapper {
public StaticParserExtension(){
super();
currentPlugin="RulesParser";
}
}
Um zu prüfen, ob Sie die Plug-in-Manifestdatei korrekt konfiguriert haben, können Sie Ihr Plug-in-Projekt in einer neuen Laufzeit-Workbench ausführen. Gehen Sie folgendermaßen vor:
Um Ihr Protokollparser-Plug-in in eine Eclipse-Workbench zu implementieren, müssen Sie die Plug-in-Dateien packen, indem Sie sie in eine ZIP-Datei exportieren. Gehen Sie folgendermaßen vor:
<?xml version="1.0" encoding="UTF-8"?>
<PluginConfiguration requires="org.eclipse.hyades.logging.parsers">
<Application configuration="default"
executable="RemoteLogParserLoader"
extends="default"
location=="%SYS_TEMP_DIR%"
path="%JAVA_PATH%">
<Variable name="CLASSPATH"
position="prepend"
value="%RASERVER_HOME%\plugins\RulesParser_1.0.0\parsers.jar"/>
<Variable name="GLA_CONFIG_PATH" position="prepend" value="%RASERVER_HOME%\plugins\RulesParser_1.0.0"/>
<Parameter position="append" value=""config_path=%GLA_CONFIG_PATH%""/>
</Application>
<Option name="RulesParser" type="version" value="1.0.0"/>
</PluginConfiguration>
Sie können Ihr Protokollparser-Plug-in implementieren, indem Sie die gerade erstellte ZIP-Datei in das eclipse-Verzeichnis einer Eclipse-Installation extrahieren. Nun können Sie unter Verwendung der Protokoll- und Traceanalysefunktion Ihr neu erstelltes Protokollparser-Plug-in testen.
Um Ihr Protokollparser-Plug-in auf einem fernen System zu implementieren, so dass eine Protokolldatei fern importiert werden kann, extrahieren Sie die gerade erstellte ZIP-Datei in das Agent Controller-Installationsverzeichnis auf dem fernen System. Starten Sie den Agent Controller erneut.
Verwandte Konzepte
Verwandte Aufgaben
Protokollparser erstellen
Statischen Adapter erstellen
Regelbasierten Adapter erstellen
Protokollparser testen
Plug-in-Projekt für Protokollparser einrichten
Verwandte Verweise
Struktur der Adapterkonfigurationsdatei
Editor für Adapterkonfiguration
Grammatik von regulären Ausdrücken
(C) Copyright IBM Corporation 2000, 2005. Alle Rechte vorbehalten.