Una volta creato un progetto plugin per contenere le risorse per un programma di analisi di 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. Individuare l'elemento richiesto nel file e aggiungere ad esso le dipendenze plugin. Ad esempio:
<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>
Nota: il plugin necessario sopra specificato deve essere posizionato nella directory di plugin eclipse o deve essere incluso nello spazio di lavoro corrente.
È necessario definire un punto di espansione 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 espansione 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 espansione per il programma di analisi di 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
Suggerimento: un'applicazione può scrivere dati nel proprio file di log in diverse lingue, in funzione dell'ambiente in cui viene eseguita. Le classi statiche di programma di analisi o le regole di espressione regolare vengono scritte per analizzare un file di log in una singola lingua. Perciò per supportare un tipo di file di log che può essere scritto in molte lingue, è necessario creare un file di adattatore di programma di analisi statico distinto o un file di adattatore di regole per ogni lingua. Quindi, nel punto di espansione logParser per quel tipo di file di log, è necessario aggiungere un tag parserParameter per ogni file di adattatore, specificando la lingua che applica nel campo del nome. Non dimenticare di aggiungere i valori di nome parserParameter all'elenco nell'attributo defaultValue del campo versione. Ciò consentirà a un utente di scegliere la lingua corretta del file di log quando lo importa.
Ad esempio, i parametri seguenti del programma di analisi possono essere aggiunti al punto di espansione logParser per supportare l'importazione di log inglesi, francesi e tedeschi:
<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"/>
Questo passo è obbligatorio se si crea un programma di analisi statico.
Per i programmi di analisi statici, la relativa classe creata deve essere specificata in plugin.xml tramite un'estensione staticParser. Questo punto di estensione permetterà di trovare la classe quando viene utilizzato per analizzare un file nello scenario di importazione di log.
Aggiungere il seguente punto di espansione:
<extension
point="org.eclipse.hyades.logging.adapter.config.staticParser">
<parserClassname
name="myLogParser33.MyStaticParser">
</parserClassname>
</extension>
Creare una classe wrapper statica che estende org.eclipse.hyades.logging.adapter.config.StaticParserWrapper. Questa classe viene utilizzata per i programmi di analisi, sia statici che basati su regole, allo scopo di eseguire il file di configurazione dell'adattatore associato alla versione selezionata dall'utente nel corso della procedura guidata di importazione del log mediante il run-time dell'adattatore log generico.
/*
* 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 di log in un workbench Eclipse, è necessario creare pacchetti dei file plugin esportandoli in un file zip. Procedere come segue:
<?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>
È possibile distribuire il plugin del programma di analisi di log decomprimendo il file zip creato nella directory eclipse e di un'installazione Eclipse. A questo punto si è pronti a verificare il plugin del programma di analisi di log appena creato utilizzando l'Analizzatore di log e di traccia.
Per distribuire il plugin del programma di analisi di 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. Riavviare Agent Controller.
Argomenti correlati
Attività correlate
Creazione di un programma di analisi di log
Creazione di un adattatore statico
Creazione di un adattatore basato su regole
Verifica di un programma di analisi di log
Impostazione di un progetto plugin per un programma di analisi di log
Riferimenti correlati
Struttura del file di configurazione dell'adattatore
Editor configurazione adattatore
Grammatica espressione regolare
(C) Copyright IBM Corporation 2000, 2005. Tutti i diritti riservati.