ライブ・アプリケーション・モニターのアダプターを構成

汎用ログ・アダプターには、アダプターで生成された共通ベース・イベント・オブジェクトをロギング・エージェントに送ることができるアウトプッター・クラスが用意されています。 ログおよびトレース・アナライザーを使用すると、ロギング・エージェントへの接続、モニター、 およびアプリケーション・ログのリアルタイムでの分析を行うことができます。

前提条件:

モニターのアダプターを構成するには、以下のステップに従ってください。

アウトプッター・コンポーネントの更新

注: 新しいアダプター構成ファイルを作成すると、 デフォルトでは CBELogOutputter クラスを使用するように構成されます。 この設定を変更していない場合は、この手順をスキップしてください。

共通ベース・イベント・オブジェクトをロギング・エージェントに書き込む CBELogOutputter クラスを使用するように、 アダプター構成ファイル内のアウトプッター・コンポーネントを更新する必要があります。 既存のアウトプッター・コンポーネントを更新する方法と、新しいアウトプッター・コンポーネントを追加する方法があります。

新しいアウトプッター・コンポーネントを追加するには、以下のステップに従います。

  1. アダプター構成ファイルを編集するには、 「ナビゲーター」ペインでアダプター構成ファイルを選択します。 右マウス・ボタン・クリックし、 「アプリケーションから開く」>「アダプター構成エディター」と選択します。 エディターにファイルが開きます。
  2. アダプター構成エディター・ウィンドウで、 「アダプター」>「構成」>「コンテキスト・インスタンス」ノードと展開します。
  3. 「コンテキスト・インスタンス」を右マウス・ボタン・クリックし、 「追加」>「アウトプッター」と選択します。 「コンテキスト・インスタンス」に新しいアウトプッターが作成されます。
  4. 「アウトプッター・タイプ」フィールドで、「LoggingAgentOutputter」を選択します。
  5. 「agentName」プロパティーをクリックします。 プロパティーの詳細が右側のペインに表示されます。
  6. 希望するロギング・エージェント名でプロパティー値を更新します。 これは、ログおよびトレース・アナライザーで、モニターするロギング・エージェントとして表示される名前です。
  7. 情報が CBELogOutputter クラスにログされるまでアウトプッターを待機させる場合は、 waitUntilLoggingTime というプロパティーを追加し、 そのプロパティーの値を時間 (ミリ秒単位) に設定します。 プロパティーを追加するには、新たに作成したアウトプッターを右マウス・ボタン・クリックし、 「追加」>「プロパティー」と選択します。 新しいアウトプッター・ノードの下に新規プロパティーが作成されます。
  8. CBELogOutputter クラスを使用可能にするには、 「コンテキストの基本コンテキスト実装 (Contexts Basic Context Implementation)」で、 関連するアウトプッター・コンポーネントを作成する必要があります。 「コンテキスト」>「コンテキストの基本コンテキスト実装 (Context Basic Implementation Context)」を開きます。
  9. 「コンテキストの基本コンテキスト実装 (Context Basic Implementation Context)」を右マウス・ボタン・クリックし、 「追加」>「コンポーネント」と選択します。 新規コンポーネントがコンテキストに追加されます。
  10. 新規コンポーネントを以下の値で構成します。
    名前: コンテキストにおけるアウトプッターの名前
    説明: このアウトプッターが実行する内容の説明
    実行可能クラス: org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter
    ロギング・レベル:アウトプッター・コンポーネントが使用する内部ロギングのレベル。
    値 99 は、アウトプッターがメッセージをログに記録しないことを意味します。
    値 0 は、アウトプッターがすべての重大度のメッセージをログに記録することを意味します。
    推奨値は 50 です。この値は、「重大」または「致命的」の内部アウトプッター・ エラー・メッセージがログに記録されることを意味します。
    役割: アウトプッター
    固有の ID: ステップ 2 で 「コンテキスト・インスタンス」に定義したアウトプッターを指していなければなりません。 「参照」ボタンを使用して正しい ID を選択します。
  11. アダプター構成ファイルの変更内容を保管します。

コンテキスト・インスタンスの更新

ログ・パーサーによってログ・ファイルを連続モニターする場合は、 アダプター構成ファイルのコンテキスト・インスタンス・プロパティーを連続稼働に合わせて更新する必要があります。

  1. アダプター構成ファイルを編集するには、 「ナビゲーター」パースペクティブでアダプター構成ファイルを選択します。 右マウス・ボタン・クリックし、「アプリケーションから開く」>「アダプター構成エディター」と選択します。 エディターにファイルが開きます。
  2. エディター・ウィンドウで、 「アダプター」>「構成」>「コンテキスト・インスタンス」と選択します。 コンテキスト・インスタンスの詳細が右側のペインに表示されます。
  3. 「連続稼働」チェック・ボックスを選択します。
  4. 必要に応じて、「最大アイドル時間」フィールドと「一時停止インターバル」フィールドを構成します。
  5. アダプター構成ファイルの変更内容を保管します。

アダプターを実行する Java プロセスの起動

作成したログ・アダプターは、Windows 環境ではバッチ・ファイルから、 または Windows 以外の環境ではシェル・スクリプトから外部で実行することができます。 以下に、ログ・アダプターを実行する Java プロセスを起動する場合に役立つサンプル・ファイルを示します。
注: システムで汎用ログ・アダプターを実行するには、 そのシステムに Hyades がインストールされていなければなりません。

Windows バッチ・ファイル

@rem USAGE:  runregex
@rem Change the following lines to point to the directory where you unzipped the runtime
@rem and the directory where your log adapter resides 
SET HYADES_HOME=d:¥hyadesDC
SET YOUR_ADAPTER_DIRECTORY=MyAdapterDirectory
SET CONFIG_FILE=%HYADES_HOME%¥%YOUR_ADAPTER_DIRECTORY%¥myadapter.adapter
PUSHD %HYADES_HOME%¥%YOUR_ADAPTER_DIRECTORY%
java -classpath
"%HYADES_HOME%¥lib¥glaconfigs.jar;%HYADES_HOME%¥lib¥hexr.jar;%HYADES_HOME%¥lib¥hgla.jar;%HYADES_HOME%¥lib¥hglaconfig.jar;%HYADES_HOME%¥lib¥hlcore.jar;%HYADES_HOME%¥lib¥hlevents.jar;%HYADES_HOME%¥lib¥hparse.jar;;%HYADES_HOME%¥lib¥logparsers.jar;%HYADES_HOME%¥lib¥xalan.jar;"
org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD
Windows 以外のバッチ・ファイル
#!/bin/sh
# USAGE:  runregex_example.sh
# Change the following line to point to the directory where you unzipped the runtime
HYADES_HOME=/home/hyadesDC
export HYADES_HOME
YOUR_DIRECTORY=/yourdirectory
export YOUR_DIRECTORY

CONFIG_FILE=$HYADES_HOME/$YOUR_DIRECTORY/myadapter.adapter
export CONFIG_FILE

CUR_DIR=`pwd`
export CUR_DIR

cd $HYADES_HOME/$YOUR_DIRECTORY

java -classpath "$HYADES_HOME¥lib¥glaconfigs.jar;$HYADES_HOME¥lib¥hexr.jar;$HYADES_HOME¥lib¥hgla.jar;$HYADES_HOME¥lib¥hglaconfig.jar;$HYADES_HOME¥lib¥hlcore.jar;$HYADES_HOME¥lib¥hlevents.jar;$HYADES_HOME¥lib¥hparse.jar;;$HYADES_HOME¥lib¥logparsers.jar;$HYADES_HOME¥lib¥xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE"
cd $CUR_DIR
必要に応じて、アダプターを実行する Java プロセスを起動するファイルを構成します。

ライブ・アプリケーション・ログのモニター

ライブ・アプリケーション・ログをモニターできるようになりました。

  1. 「設定」でロギングが使用可能になっていることを確認します。
    1. メイン・ツールバーから、「ウィンドウ」>「設定」と選択します。 「設定」ウィザードが開きます。
    2. 左側のペインから「プロファイルおよびロギング」を選択します。 右側のペインに「プロファイルおよびロギング」の設定がロードされます。
    3. 「プロファイルおよびロギング」オプションで「ロギングを使用可能にする」を選択します。

      「プロファイルおよびロギング」の「設定」ペインで「ロギングを使用可能にする」チェック・ボックスを選択する

    4. 「OK」を選択して変更内容を適用します。
  2. 「プロファイルおよびロギング」パースペクティブで、 ツールバーから「プロファイル」 「プロファイル」ツールのアイコンアイコンをクリックし、 「プロファイル」を選択します。 「プロファイル」ウィザードが開きます。
  3. 「接続 - Java プロセス」を選択し、リストの一番下にある「新規」ボタンをクリックします。 新しい Java プロセス構成が作成されます。
  4. 「ホスト」タブをクリックし、 アプリケーション・ログがあるホストを選択します。
    注: ライブ・アプリケーション・ログをモニターするには、 Hyades データ収集エンジンがアプリケーションと同じシステム上で実行されていなければなりません。
  5. 「エージェント」タブをクリックし、 矢印キーを使用して、構成したロギング・エージェントを選択します。

    「プロファイルの設定」ウィザードで、ユーザーが作成したロギング・エージェントが左側のペインに作成される

  6. 「適用」をクリックします。
  7. 「実行」をクリックしてロギング・エージェントに接続します。
  8. 「プロファイル・モニター」ビューの「プロファイルおよびロギング」パースペクティブで、 ロギング・エージェントを選択します。
  9. エージェントを右マウス・ボタン・クリックし、「モニターの開始」を選択します。
  10. エージェントを右マウス・ボタン・クリックし、 「アプリケーションから開く」>「ログ・ビュー」と選択します。 ログ・イベントがアプリケーション・ログからログ・ビューにロードされます。

 

関連概念
Hyades 汎用ログ・アダプターの概説
共通ベース・イベント・フォーマットの仕様

関連タスク
ログ・パーサーの作成

関連参照
アダプター構成ファイルの構造
アダプター構成エディター
正規表現グラマー