Après avoir créé un projet de plug-in destiné à contenir les artefacts d'un programme d'analyse syntaxique de journal, vous devez configurer le plug-in de telle sorte qu'il puisse être utilisé par l'analyseur de trace et de journaux. Procédez aux opérations ci-dessous.
Vous devez inclure les dépendances de plug-in suivantes dans le fichier manifeste. Ouvrez le fichier plugin.xml dans un éditeur de texte et ajoutez les lignes suivantes après l'élément 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>
Vous devez définir un point d'extension pour chaque type de fichier journal d'application à analyser et à importer dans l'analyseur de trace et de journaux. Vous trouverez ci-après un exemple de point d'extension pour l'application MyApp comportant un adaptateur de règles ainsi qu'un adaptateur statique.
<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>
Si vous voulez personnaliser le point d'extension pour votre programme d'analyse syntaxique de journal, vous devez effectuer les mises à jour ci-dessous.
<parserParameter name="Default" value="./MyAdapter/myadapter.adapter"> </parserParameter>
Les zones spécifiées ci-dessus créent une option pour MyApp
myapp.log dans l'assistant d'importation de fichier journal, comme
indiqué ci-après :
Vous pouvez utiliser un fichier plugin.properties pour définir dans le fichier plugin.xml certaines propriétés qui pourraient nécessiter des versions différentes. Par exemple, s'il est nécessaire de traduire dans différentes langues des chaînes de texte qui figureront dans l'assistant Importation du fichier journal, vous pouvez les définir dans le fichier plugin.properties et inclure plusieurs fichiers de propriétés pour les langues à prendre en charge. Dans le fichier plugin.properties, vous définissez les variables de substitution pouvant être utilisées dans le fichier plugin.xml. Le fichier plugin.properties associé au fichier plugin.xml décrit plus haut doit ressembler à l'exemple suivant :
# Properties for RulesParser Plugin pluginName = RulesParser providerName = MyCompany # logParser extension point message(s): STR_MYAPP_PARSER_DESCRIPTION = Programme d'analyse syntaxique des règles MyApp v1.0 STR_MYAPP_TOOLTIP1 = Entrez l'emplacement du fichier journal STR_MYAPP_TOOLTIP2 = Sélectionnez la version du fichier journal à importer
Créez une classe de programme d'analyse syntaxique d'encapsuleur statique qui étend org.eclipse.hyades.logging.adapter.config.StaticParserWrapper. Cette classe est utilisée à la fois pour les programmes d'analyse syntaxique statiques et fondés sur des règles. Créez la classe dans le projet de plug-in du programme d'analyse syntaxique de journal. Vous pouvez utiliser l'exemple de classe ci-dessous en remplaçant la chaîne RulesParser par le nom du projet de plug-in de votre programme d'analyse syntaxique de journal.
/*
* 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";
}
}
Pour vérifier que vous avez correctement configuré le fichier manifeste du plug-in, vous pouvez exécuter votre projet de plug-in dans un nouveau plan de travail d'exécution. Procédez aux opérations ci-dessous.
Pour déployer le plug-in de votre analyseur de journaux dans un plan de travail eclipse, vous devez mettre en forme les fichiers de plug-in en les exportant dans un fichier zip. Procédez aux opérations ci-dessous.
<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%"/>où PARSER_PLUGIN est le répertoire du programme d'analyse syntaxique de journal que vous développez. Le nouvel élément <Variable> doit être ajouté comme premier noeud enfant de l'élément <Application> alors que le nouvel élément <Parameter> doit être ajouté comme dernier enfant de l'élément <Application>.
bin.includes = MyAdapters/,\ config/,\ plugin.xml,\ plugin.properties,\ parsers.jar source.parsers.jar = src/ output.parsers.jar = bin/
Vous pouvez déployer le plug-in de votre programme d'analyse syntaxique de journal en dézippant le fichier zip que vous venez de créer dans le répertoire plugin d'une installation eclipse. Vous pouvez maintenant tester le nouveau plug-in du programme d'analyse syntaxique de journal à l'aide de l'analyseur de trace et de journaux.
Pour déployer le plug-in de votre programme d'analyse syntaxique de journal sur un système distant afin qu'un fichier journal puisse être importé à distance, dézippez le fichier zip que vous venez de créer dans le répertoire d'installation d'Agent Controller sur le système distant.
Concepts connexes
Tâches connexes
Création d'un programme d'analyse syntaxique de journal
Création d'un adaptateur statique
Création d'un adaptateur fondé sur des règles
Test d'un programme d'analyse syntaxique de journal
Configuration d'un projet de plug-in pour un programme d'analyse syntaxique de journal
Références connexes
Structure du fichier de configuration d'adaptateur
Editeur de configuration d'adaptateur
Syntaxe d'une expression régulière
(C) Copyright IBM Corporation 2000, 2004. All Rights Reserved.