Administration Console オンライン ヘルプ

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

アプリケーションのインスツルメンテーションのコンフィグレーション

始める前に

診断アプリケーション モジュールは、実行中のアプリケーションまたはアプリケーション モジュールの様子をモニタするためにコンフィグレーションするソフトウェア コンポーネントです。診断アプリケーション モジュールは診断システム モジュールと似ていますが、診断アプリケーション モジュールではインスツルメンテーションしかコンフィグレーションできません (その他の診断機能は診断システム モジュールでコンフィグレーションできます。診断システム モジュールの作成を参照してください)。アプリケーションのインスツルメンテーションをコンフィグレーションする場合は、WebLogic 診断フレームワーク インスツルメンテーション ライブラリの標準の診断モニタと診断アクションを使用することも、独自の診断モニタを作成して、そこにライブラリの診断アクションをアタッチすることもできます。

Administration Console でアプリケーション スコープのインスツルメンテーションコンフィグレーションするには、まず、weblogic-diagnostics.xml という名前の整形式の診断記述子ファイルを作成して、アプリケーションまたはアプリケーション モジュールのルートの META-INF ディレクトリに配置する必要があります (『WebLogic 診断フレームワークのコンフィグレーションと使い方』のアプリケーション スコープのインスツルメンテーションのコンフィグレーションを参照してください)。このファイルを作成してディレクトリに配置したら、Administration Console を起動して、診断アプリケーション モジュールの診断モニタを作成または変更することができます。


診断アプリケーション モジュールでインスツルメンテーションをコンフィグレーションするには、次の手順に従います。

  1. まだ行っていない場合、Administration Console のチェンジ センタで [ロックして編集] をクリックします (チェンジ センタの使用を参照)。
  2. 左ペインで、[デプロイメント] をクリックします。
  3. [デプロイメントの概要|制御] ページで、診断モニタをコンフィグレーションするアプリケーションまたはアプリケーション モジュールの名前をクリックします。
  4. [(アプリケーション名またはモジュール名) の設定] ページで、[コンフィグレーション|インスツルメンテーション] を選択します。
  5. このアプリケーションまたはモジュールのすべての診断モニタを有効または無効にするには、[有効] を選択または選択解除します。

    注意: アプリケーションまたはモジュールのインスツルメンテーションを有効にするには、そのアプリケーションまたはモジュールがデプロイされているサーバまたはクラスタのインスツルメンテーションも有効にする必要があります。診断システム モジュール内のインスツルメンテーションの有効化または無効化を参照してください。

  6. (省略可能) フィルタを指定すると、診断モニタで定義されているジョインポイントの指定に沿って、診断コードをクラス コードにウィービングすべきかどうかを決定するために WebLogic 診断フレームワーク (WLDF) が処理するクラスを制限することができます。
    1. [含まれるクラス] フィールドに、処理するクラスを指定するパターン式を入力します。
    2. [除外されるクラス] フィールドに、処理しないクラスを指定するパターン式を入力します。

    パターン式は、対象とするまたは除外するパッケージまたはクラスのカンマ区切りのリストです。アスタリスク (*) のワイルドカードを使用して 1 つまたは複数の文字を表すことができます。

    式は次のように評価されます。

    • [含まれるクラス] も [除外されるクラス] も指定しない場合は、アプリケーションまたはアプリケーション モジュール内のすべてのクラスが処理されます。
    • [含まれるクラス] を指定し、[除外されるクラス] を指定しない場合は、すべての [含まれるクラス] が処理されて、それ以外のクラスは処理されません。
    • [除外されるクラス] を指定し、[含まれるクラス] を指定しない場合は、[除外されるクラス] で指定されたクラスを除くすべてのクラスが処理されます。
    • [含まれるクラス] と [除外されるクラス] の両方を指定した場合は、すべての [含まれるクラス] が処理されます。ただし、含まれるクラスとして指定されたクラスが除外されるクラスとしても指定されている場合、そのクラスは処理から外されます。
  7. (省略可能) [除外されるクラス] フィールドに、診断モニタを追加できないクラスを指定するパターン式を入力します。
  8. インスツルメンテーションを有効または無効にした場合、あるいは [含まれるクラス] または [除外されるクラス] でパターン式を追加したり編集したりした場合は、[保存] をクリックして変更を保存します。
  9. 次の手順に従って、診断モニタを追加、作成、または変更します。
  10. WLDF インスツルメンテーション ライブラリからモニタを追加するには、次の手順に従います。
    1. [ライブラリからモニタを追加] をクリックします。
    2. [ライブラリからモニタを追加/削除] ページで、[使用可能] リストから 1 つまたは複数の診断モニタを選択し、右矢印ボタンをクリックして [選択済み] リストにモニタを移動します。
    3. [完了] をクリックします。
  11. カスタム モニタを作成してこの診断モジュールに追加するには、アプリケーションのカスタム診断モニタの作成を参照してください。
  12. 既存のモニタのコンフィグレーションを変更するには、[このモジュールの診断モニタ] の下で、コンフィグレーションするモニタの名前をクリックします。[(診断モニタ名) の設定] ページで、コンフィグレーション設定を変更します。
  13. これらの変更をアクティブにするには、Administration Console のチェンジ センタで [変更のアクティブ化] をクリックします。
    すべての変更が即座に有効になるわけではありません。再起動が必要なものもあります (チェンジ センタの使用を参照)。

 

Skip navigation bar ページの先頭