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 hierzu 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 und fügen Sie die folgenden Zeilen nach dem Element 'runtime' (Laufzeit) hinzu:
<requires> <import plugin="org.eclipse.ui"/> <import plugin="org.eclipse.core.runtime.compatibility"/> <import plugin="org.eclipse.hyades.logging.adapter"/> <import plugin="org.eclipse.hyades.logging.parsers"/> <import plugin="org.eclipse.hyades.logging.adapter.config"/> </requires>
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
Erstellen Sie eine statische Wrapperklasse zur Erweiterung von org.eclipse.hyades.logging.adapter.config.StaticParserWrapper. Diese Klasse wird sowohl für statische als auch für regelbasierte Parser verwendet. Erstellen Sie die Klasse in dem Protokollparser-Plug-in-Projekt. Sie können die folgenden Beispielklasse verwenden, indem Sie RulesParser durch den Namen Ihres Protokollparser-Plug-in-Projekts ersetzen.
/*
* 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:
<runtime> <library name="parsers.jar"> <export name="*"/> </library> </runtime>
<?xml version="1.0" encoding="UTF-8"?>
<PluginConfiguration>
<Application configuration="default"
executable="RemoteLogParserLoader"
extends="default"
location="%RASERVER_HOME%\plugins\RulesParser_1.0.0"
path="%JAVA_PATH%">
<Variable name="CLASSPATH"
position="prepend"
value="%RASERVER_HOME%\plugins\RulesParser_1.0.0\parsers.jar"/>
</Application>
<Option name="RulesParser" type="version" value="1.0.0"/>
</PluginConfiguration>
<Variable name="GLA_CONFIG_PATH" position="append" value="%RASERVER_HOME%\plugins\PARSER_PLUGIN\config"/> <Parameter position="append" value="config_path=%GLA_CONFIG_PATH%"/>wobei 'PARSER_PLUGIN' das Verzeichnis des Protokollparsers ist, den Sie erweitern. Das neue Element <Variable> muss als erster untergeordneter Knoten des Elements <Application> hinzugefügt werden, während das neue Element <Parameter> als letztes untergeordnetes Element des Elements <Application> hinzugefügt werden muss.
bin.includes = MyAdapters/,\ config/,\ plugin.xml,\ plugin.properties,\ parsers.jar source.parsers.jar = src/ output.parsers.jar = bin/
Sie können Ihr Protokollparser-Plug-in implementieren, indem Sie die gerade erstellte ZIP-Datei in das Plug-in-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 de m fernen System.
Verwandte Konzepte
Verwandte Tasks
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, 2004. Alle Rechte vorbehalten.