ログ・パーサーの成果物を収めるプラグイン・プロジェクトを作成したら、 ログおよびトレース・アナライザーが使用できるようにそのプラグインを構成する必要があります。 以下の手順を実行してください。
プラグイン・マニフェスト・ファイルに、以下のプラグイン依存関係を組み込む必要があります。 テキスト・エディターで plugin.xml ファイルを開き、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>
構文解析を行って、ログおよびトレース・アナライザーへインポートしたい それぞれのタイプのアプリケーション・ログ・ファイルごとに、拡張ポイントを定義する必要があります。 以下は、規則アダプターと static アダプターの両方を定義した、MyApp アプリケーションのサンプル拡張ポイントです。
<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>
ログ・パーサーの拡張ポイントをカスタマイズするには、次の更新を行うことが必要です。
<parserParameter name="Default" value="./MyAdapter/myadapter.adapter"> </parserParameter>
上記に指定したフィールドにより、「ログのインポート (Import Log)」ウィザードに
MyApp myapp.log 用のオプションが作成されます (以下の図を参照)。
plugin.properties ファイルを使用すると、異なるバージョンを持つ必要のある特定プロパティーを、plugin.xml ファイル内で定義することができます。 たとえば、「ログ・ファイルのインポート」ウィザードに組み込まれるテキスト・ストリングで、 別の言語に翻訳する必要があるものがある場合、それらのテキスト・ストリングを plugin.properties ファイルで定義することができ、またサポートしたい言語用の別のプロパティー・ファイル をインクルードすることができます。 plugin.xml ファイルで使用できる置換変数を、その plugin.properties ファイルで定義してください。 上記の plugin.xml に対する plugin.properties ファイルは以下のようになります。
# 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
org.eclipse.hyades.logging.adapter.config.StaticParserWrapper を拡張する静的なラッパー・クラスを作成します。 このクラスは、static パーサーと規則ベース・パーサーの両方に使用します。 ログ・パーサー・プラグイン・プロジェクトでクラスを作成します。 RulesParser をご使用のログ・パーサー・プラグイン・プロジェクトの名前で置き換えて、 以下のサンプル・クラスを使用してください。
/*
* 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";
}
}
プラグイン・マニフェスト・ファイルを正しく構成したかどうかを検査するため、新規の ランタイム・ワークベンチでプラグイン・プロジェクトを実行することができます。 以下の手順を実行してください。
ログ・パーサー・プラグインを Eclipse ワークベンチにデプロイするには、プラグイン・ファイルを、zip ファイルにエクスポートしてパッケージする必要があります。以下の手順を実行してください。
<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%"/>ここで、PARSER_PLUGIN は、拡張するログ・パーサーのディレクトリーです。 <Application> エレメントの最初の子ノードとして新規の <Variable> エレメントを追加し、<Application> エレメントの最後の子として新規の <Parameter> エレメントを追加する必要があります。
bin.includes = MyAdapters/,¥ config/,¥ plugin.xml,¥ plugin.properties,¥ parsers.jar source.parsers.jar = src/ output.parsers.jar = bin/
Eclipse のインストール先のプラグイン・ディレクトリーに、先に作成した zip ファイルを解凍して、 ログ・パーサー・プラグインをデプロイすることができます。 これで、ログおよびトレース・アナライザーを使用して、 新たに作成したログ・パーサー・プラグインをテストする準備ができました。
ログ・ファイルをリモート側でインポートすることができるように、 リモート・システムにログ・パーサー・プラグインをデプロイするには、先に作成した zip ファイルを、リモート・システムの Agent Controller インストール・ディレクトリーに解凍します。
関連概念
関連タスク
ログ・パーサーの作成
static アダプターの作成
規則ベース・アダプターの作成
ログ・パーサーのテスト
ログ・パーサー・プラグイン・プロジェクト・セットアップ
関連参照
アダプター構成ファイルの構造
アダプター構成エディター
正規表現グラマー
(C) Copyright IBM Corporation 2000, 2004. All Rights Reserved.