TOP
＞
設計・移行・活用
＞ アダプタ構成ファイルの作成
Eclipseでテストとパフォーマンス検証
第６回：ログファイルのパーサを作成する
著者：
ビーブレイクシステムズ 益原 祐介
2005/11/14
前のページ
1
2
3
4
次のページ
アダプタ構成ファイルの作成
次にアダプタ構成ファイルを作成します。アダプタ構成ファイルとは、ログを共通基本イベントに変換（マッピング）する規則を記述するファイルです。正規表現でログを分析・変換する"規則ベースアダプタ"とJavaクラスを使用する"スタティックアダプタ"の2種類が存在します。
規則ベースアダプタは比較的単純な構造のログの分析に使用するのに対し、スタティックアダプタは複雑な構造のログの分析に使用します。今回はスタティックアダプタを作成します。
スタティックアダプタを作成するには、「File → New → Other... → Generic Log Adapter → Generic Log Adapter File」を選択して「Next>」をクリックします。
「Generic Log Adapter File」画面が開いたら、ファイルの格納先／ファイル名／XMLエンコードを指定します。今回は格納先を"MyAdapter"フォルダ、ファイル名を"static.adapter"、XMLエンコードを"UTF-8"と指定します。指定して「Next>」をクリックすると「Template log file」画面が開きますので、ここでは変換対象と同じ形式を持つログファイルを指定してください。
「Finish」をクリックするとアダプタ構成ファイルがMyAdapter下に作成され、「Generic Log Adapter」ビューへ画面を切替えるか聞かれますので「Yes」をクリックしてください。今後アダプタ構成ファイルを編集する際はこの「Generic Log Adapter」ビューを使用します。
アダプタ構成ファイルは「Contexts」と「Configuration」の2つのノードから成ります。各ノードには複数のコンポーネントが含まれますが、今回作成するスタティックアダプタはすべてのコンポーネントを使用するわけではないので、不必要なコンポーネントは削除します。
「Contexts → Contexts Basic Context Implementation」ノードからは「Component Regular Expression Extractor」「Component Generic Parser」「Component CBE Formatter」を右クリックから削除します。残った「Component OS File Sensor」の「Name」と「Description」を任意に指定します。今回は両方とも"JMS Message Log Parser Sensor"と指定します。同様に「Component Logging Agent Outputter」の「Name」と「Description」には"Log Import Outputter"と指定します。
「Configuration → Context Instance」ノードからは「Extractor」「Parser」「Formatter」を右クリックから削除します。残った「Sensor A single file sensor」の「Description」を任意に変更します。今回は"JMS Message Log Parser Sensor"としました。「Outputter」の「Description」は"Log Import Outputter"とします。
次に「Configuration → Context Instance」を選択します。右側の「Continuous operation」チェックボックスをオフにします。
以上の設定がすべて終了すると、アダプタ構成ファイルは図1のようになります。今回削除されたコンポーネントは後ほど作成するJavaクラスで代用されることになります。
図1：アダプタ構成ファイルの設定
（画像をクリックすると別ウィンドウに拡大図を表示します）
次に変換規則を定義したJavaクラスを実装します。Javaクラスは「org.eclipse.hyades.logging.parser」パッケージの「Parser」クラスか「MonitoringParser」クラスを継承する必要があります。
ログ・ファイルが今以上に更新されない場合は「Parser」を、更新される場合は「MonitoringParser」を継承します。今回は更新されないログファイルを分析するので「Parser」クラスを使用します。
この「Parser」を使用するためには、META-INFフォルダのMANIFEST.MFファイルを編集します。
MANIFEST.MFファイルを開いて「Dependencies」タブをクリックし、左側の「Required Plug-ins」欄で「Add…」をクリックします。すると「Plug-in Selection」ウィンドウが開くので「org.eclipse.hyades.logging.parsers」を選択して「OK」をクリックしてください。これでJavaクラスを実装する準備が整いました。
プロジェクト作成時に"src/jMSMessageLogParser"というフォルダが作成されているので、「File → New → Class」を選択して、ここに変換用のJavaファイルを作成します。
「Name」には"JMSMessageLogParser"、「Superclass」には"org.eclipse.hyades.logging.parsers.Parser"を指定します。抽象メソッドのparseNext()、getName()、getVersion()を実装する必要があります。parseNext()で実際にログファイルを1行ずつ読み込んで共通基本イベントに設定します。変換処理の際に使用する主な変数やメソッドは以下の通りです。
protected CommonBaseEvent[] messages
共通基本イベントオブジェクトの配列、読み込んだログファイルの情報を格納します。最終的にこのオブジェクトに格納された値がログ・ビューで表示されます。
protected String curLine
読み込んだログファイルの現在行が格納されます。
protected String readALine()
ログファイルの次の行を取得します。
表2：変換処理に使用する主な変数やメソッド
実際に作成したJavaファイル
jmsmessagelogparser.zip
（2.54KB）
Javaファイルを作成したら、アダプタ構成ファイルに登録します。まずはセンサー・コンポーネントの編集です。static.adapterを開いて「Adapter → Configuration →JMS Message Log Parser Sensor」を選択し、右側の「Sensor type」を「StaticParserSensor」に設定します。
なお「Maximum blocking」は出力される共通基本イベントの数です。「Confidence buffer size」と「File footer size」はMonitoringParserを継承した場合に必要なので、今回は意識する必要はありません。
現在選択している「Sensor JMS Message Log Parser Sensor」を右クリックして「Add → Property」をクリックします。「Property Name」には"parserClassName"、「Property value」には"jMSMessageLogParser.JMSMessageLogParser"と指定します。
次に「Adapter → Contents → Context Basic Context Implementation → Component JMS Message Log Parser Sensor」を選択し、右側の「Executable class」に"org.eclipse.hyades.logging.parsers.adapter.sensors.StaticParserSensor"と指定します。
センサー・コンポーネントの次はアウトプッター・コンポーネントを編集します。「Adapter → Contexts → Context Basic Context Implementation → Component Log Import Outputter」を選択し、右側の「Executable class」に"org.eclipse.hyades.logging.parsers.adapter.outputters.LogImportOutputter"を指定します。
変更が完了したら「Adapter → Configuration → Context Instance → Outputter」を選択し、「Outputter type」に"undeclared"を指定します。
前のページ
1
2
3
4
次のページ
著者プロフィール
株式会社ビーブレイクシステムズ 益原 祐介
Javaスペシャリスト
九州大学文学部卒業。在学中は考古学の研究、遺跡の発掘作業を行う。その後、情報システムに興味を持ちビーブレイクシステムズに入社。徹底した社内教育によりJavaエンジニアとなる。現在は社内技術レポートの執筆や技術雑誌への寄稿を行い、社内の技術力の向上に貢献。
INDEX
第6回：ログファイルのパーサを作成する
はじめに
アダプタ構成ファイルの作成
プラグイン・マニフェスト・ファイルの編集
ログファイルを使用してパーサのテストを行う
