Una volta creato un progetto plugin per contenere le risorse per un programma di analisi del log, è necessario configurare il plugin in modo da poter essere utilizzato dall'Analizzatore di log e di traccia. Procedere come segue:
Le seguenti dipendenze plugin devono essere incluse nel file manifest del plugin. Aprire il file plugin.xml in un editor di testo e aggiungere le seguenti righe dopo l'elemento di runtime:
<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>
È necessario definire un punto di estensione per ciascun tipo di file di log dell'applicazione da analizzare e importare nell'Analizzatore di log e di traccia. Di seguito viene riportato un esempio di punto di estensione per l'applicazione MyApp con l'adattatore di regole e l'adattatore statico definiti:
<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>
Per personalizzare il punto di estensione per il programma di analisi del log, è necessario apportare una serie di aggiornamenti:
<parserParameter
name="Default"
value="./MyAdapter/myadapter.adapter">
</parserParameter>
I campi specificati creeranno un'opzione per MyApp myapp.log
nella procedura guidata di importazione log come mostrato di seguito:
È possibile utilizzare un file plugin.properties per definire alcune proprietà nel file plugin.xml con diverse versioni. Ad esempio, in presenza di stringhe di testo che verranno incluse nella procedura guidata Importa file di log e che dovranno essere tradotte in diverse lingue, è possibile definirle nel file plugin.properties e includere diversi file delle proprietà per le lingue da supportare. Nel file plugin.properties vengono definite variabili di sostituzione che possono essere utilizzate nel file plugin.xml. Il file plugin.properties per il suddetto plugin.xml apparirà come segue:
# Properties for RulesParser Plugin pluginName = RulesParser providerName = MyCompany # logParser extension point message(s): STR_MYAPP_PARSER_DESCRIPTION = MyApp rules parser v1.0 STR_MYAPP_TOOLTIP1 = Enter the location of the log file STR_MYAPP_TOOLTIP2 = Select the version of the log file to import
Creare una classe wrapper statica che estende org.eclipse.hyades.logging.adapter.config.StaticParserWrapper. Questa classe viene utilizzata per i programmi di analisi statici e basati su regole. Creare la classe nel progetto plugin del programma di analisi del log. È possibile utilizzare la seguente classe di esempio sostituendo RulesParser con il nome del proprio progetto plugin del programma di analisi del log.
/*
* Created on Apr 12, 2004
* StaticParserExtension class created to be used in RulesParser Plug-in
*/
package RulesParser;
import org.eclipse.hyades.logging.adapter.config.StaticParserWrapper;
/**
* @author developer
* StaticParserExtension class
*/
public class StaticParserExtension extends StaticParserWrapper {
public StaticParserExtension(){
super();
currentPlugin="RulesParser";
}
}
Per verificare di aver configurato correttamente il file manifest del plugin, è possibile eseguire il progetto plugin in un nuovo workbench di runtime. Procedere come segue:
Per distribuire il plugin del programma di analisi del log in un workbench Eclipse, è necessario creare pacchetti dei file plugin esportandoli in un file zip. Procedere come segue:
<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%"/>dove PARSER_PLUGIN è la directory del programma di analisi che si sta estendendo. Il nuovo elemento <Variable> deve essere aggiunto come il primo nodo secondario dell'elemento <Application> quando il nuovo elemento <Parameter> deve essere aggiunto come ultimo elemento secondario dell'elemento <Application>.
bin.includes = MyAdapters/,\ config/,\ plugin.xml,\ plugin.properties,\ parsers.jar source.parsers.jar = src/ output.parsers.jar = bin/
È possibile distribuire il plugin del programma di analisi del log decomprimendo il file zip creato nella directory del plugin di un'installazione Eclipse. A questo punto si è pronti a verificare il plugin del programma di analisi del log appena creato utilizzando l'Analizzatore di log e di traccia.
Per distribuire il plugin del programma di analisi del log su un sistema remoto in modo da poter importare un file di log in remoto, decomprimere il file zip creato nella directory di installazione di Agent Controller sul sistema remoto.
Argomenti correlati
Attività correlate
Creazione di un programma di analisi del log
Creazione di un adattatore statico
Creazione di un adattatore basato su regole
Verifica di un programma di analisi del log
Impostazione di un progetto plugin per un programma di analisi del log
Riferimenti correlati
Struttura del file di configurazione dell'adattatore
Editor configurazione adattatore
Grammatica espressione regolare
(C) Copyright IBM Corporation 2000, 2004. Tutti i diritti riservati.