メソッドパフォーマンスチャートおよびグラフの操作

メソッドパフォーマンスチャートおよびグラフとは、メソッドパフォーマンス情報をプロットするものです。メソッドパフォーマンス情報は、WLDF のインスツルメンテーション機能でキャプチャされたメソッドパフォーマンスの、リアルタイムビューおよび履歴ビューに基づいてプロットされます。

以下の節では、メソッドパフォーマンスチャートおよびグラフを操作する方法について説明します。

メトリックチャートおよびグラフの操作や、メソッドパフォーマンスチャートおよびグラフの操作の概要については、「すべてのチャートおよびグラフの操作」を参照してください。

メソッドパフォーマンスチャートでのインスツルメンテーションデータの使用

メソッドパフォーマンスチャートおよびグラフの作成にインスツルメンテーションデータを使用できるようにするには、WLDF コンソール拡張の外部に WLDF インスツルメンテーションをコンフィグレーションする必要があります。このために必要な条件を、以下に示します。

WLDF システムリソースが作成されてサーバに対象指定されている必要がある。weblogic-diagnostics.xml 記述子を作成することにより、システムリソースを作成します。この作業には WebLogic Server Administration Console や WebLogic Scripting Tool (WLST) を利用できます。直接、エディタで作成することも可能です。
対象指定された WLDF システムリソースで、インスツルメンテーションが有効になっている必要がある。
アプリケーションのインスツルメンテーションが、そのアプリケーションの META-INF/weblogic-diagnostics.xml 記述子で有効になっている必要がある。
アプリケーションのインスツルメンテーションの記述子では、「Around」タイプの診断モニタにアタッチされた TraceElapsedTimeAction 診断アクションを使用する必要がある。たとえば、次のような記述が含まれる記述子を使用します。

<instrumentation>
  <enabled>true</enabled>
    <wldf-instrumentation-monitor>
      <name>Connector_Around_Inbound</name>
      <action>TraceElapsedTimeAction</action>
    </wldf-instrumentation-monitor>
</instrumentation>

「Around」タイプのモニタの一覧については、『WebLogic 診断フレームワークのコンフィグレーションと使い方』の「診断モニタライブラリ」を参照してください。

WLDF コンソール拡張の外部でこうしたタスクを実行する方法については、『WebLogic 診断フレームワークのコンフィグレーションと使い方』の「インスツルメンテーションのコンフィグレーション」を参照してください。

選択したサーバでインスツルメンテーションがコンフィグレーションおよび有効化されていない場合、WLDF コンソール拡張の [Requests] タブにはデータが表示されません。

サーバの選択

[Requests] タブには、選択したサーバで使用できるインスツルメントされたメソッドが表示されます。一度に選択可能なサーバは 1 つだけです。別のサーバを選択するには、[Server] ドロップダウンリストでそのサーバを選択します。[Server] ドロップダウンリストにはドメイン内のすべてのサーバが表示されます。

メソッドパフォーマンスチャートおよびグラフの作成

インスツルメントされたメソッドに基づくチャートおよびグラフの作成や変更を行うには、メソッドを [Requests] タブから [View] パネルにドラッグして、メソッドパフォーマンスチャートを作成または変更します。各グラフには、選択したメソッドの呼び出し回数が時間の経過とともに表示されます。

[Requests] タブのリクエストとメソッドの表示

[Requests] タブには、インスツルメントされたコードを通過するリクエストについての情報が表示されます。このようなリクエストによってインスツルメントされたメソッドが実行されると、メソッドの開始時と終了時にインスツルメンテーションイベントが生成されます。

[Requests] タブには、識別されているリクエストのメソッド呼び出しのツリーが表示されます。図 8-2 に示すように、ツリーの最上位には、指定した時間間隔において識別された特定のサーバからのリクエストがすべて表示されます。

図 8-3 に示すように、リクエストノードを展開すると、インスツルメントされている最上位のメソッドが表示されます。メソッドで他のインスツルメントされたメソッドを呼び出している場合、呼び出しツリーにはそうしたメソッドが子ノードとして示されます。呼び出しツリーのメソッドノードには、インスツルメントされたクラスとメソッド名が表示されます。

リクエストの詳細の表示

[Requests] タブのツリーにあるリクエストの詳細を表示するには、

([Expand]) ボタンや

([Collapse]) ボタンではなく、リクエストを特定する文字列をクリックします。図 8-4 に示すように、ツリーの下のパネルに情報が表示されます。

表 8-1 リクエストパネルに表示されるリクエスト値
属性	説明
[Class Name]	このリクエストで使用されたメソッドを含む Java クラス。
[Method]	このリクエストで使用されたメソッド。
[Count]	このリクエストでこのメソッドが使用された回数。
[Total Time (ms)]	このリクエストでこのメソッドの使用にかかった合計時間 (ミリ秒単位)。
[Average Time (ms)]	このリクエストでこのメソッドの使用にかかった平均時間 (ミリ秒単位)。
[Scope]	インスツルメントされたコードを含むクラスのスコープ。
[Module]	このクラスを含むアプリケーションモジュール。
[Signature]	メソッドのシグネチャ。

インスツルメンテーションイベントの詳細の表示

メソッド呼び出しのノードをクリックすると、そのメソッド呼び出しに関連付けられたインスツルメンテーションイベントの詳細を表示できます。図 8-5 に示すように、呼び出しツリーの下のパネルに情報が表示されます。

表 8-2 リクエストパネルに表示されるイベント値
属性	説明
[Record ID]	ログ内でこのレコードを特定するためのユニークな ID。
[Timestamp]	このイベントが生成された日付。
[Context ID]	特定のリクエストまたはアプリケーションから受け取ったメッセージを相互に関連付ける診断コンテキスト情報。
[Transaction ID]	この診断イベントを開始したトランザクションの ID。トランザクションのコンテキスト内でログに記録されたメッセージに対してのみ表示される。
[User]	この診断イベントを実行したユーザ ID。
[Type]	この診断イベントによってトリガされた診断アクションのタイプ。
[Domain]	このイベントが生成されたドメイン。
[Server]	このイベントが生成された WebLogic Server インスタンスの名前。
[Scope]	この診断イベントが生成されたサーバまたはアプリケーションのスコープ。
[Module]	この診断イベントが生成された診断モジュール。
[Monitor]	この診断イベントをトリガした診断モニタ。
[File Name]	この診断イベントを生成したインスツルメントされたメソッドを含む Java ファイルの名前。
[Line Number]	ソースファイルにおけるインスツルメントされたコードの行番号。
[Class Name]	インスツルメントされたメソッドを含む Java クラスの名前。
[Method Name]	この診断イベントを生成したインスツルメントされたメソッドの名前。
[Method signature]	この診断イベントを生成したメソッドのシグネチャ。
[Payload]	ペイロード。
[Context Payload]	診断イベントに関連付けられた診断コンテキストペイロード。
[Dyes]	このイベントを開始したメソッドに関連付けられた診断仕分け。

[Requests] タブのリクエストとメソッドの詳細の表示

リクエストやメソッド呼び出しの詳細を表示するには、[Requests] タブに表示されているツリー上のリクエストおよびメソッドの項目をマウスポインタでポイントします。

リクエストデータを取得する時間間隔の選択

指定した時間間隔の間に実行されたイベントに基づいて、グラフを作成できます。次の表で、その方法について説明します。

現在を終了時間とする既定義の間隔を指定するには	[Interval] ドロップダウンリストから、次のいずれかを選択する。 [Last 5 minutes] - 直前の 5 分間のイベントデータを表示する [Last 15 minutes] - 直前の 15 分間のイベントデータを表示する [Last 30 minutes] - 直前の 30 分間のイベントデータを表示する [Last 1 hour] - 直前の 1 時間のイベントデータを表示する
現在を終了時間とするカスタムの間隔を指定するには	[Interval] ドロップダウンリストから [Last dd hh mm] を選択する。[Duration (DD HH MM)] テキスト入力フィールドが表示される。時間間隔の値を、DD HH MM の形式で入力する。 - DD は直前の日数 - HH は直前の時間数 - MM は直前の分数
現在を終了時間にしないこともできるカスタムの間隔を指定するには	[Interval] ドロップダウンリストから [Custom] を選択する。間隔を指定するためのフィールドのセットが表示される。 [Start] ドロップダウンコントロールをクリックしてカレンダーを表示し、開始日を選択する。テキスト入力ボックスの [HH MM] を、指定する開始時間で置き換える。 [Duration] テキスト入力ボックスの [DD HH MM] を、指定する期間の日数、時間数、分数で置き換える。

メソッドパフォーマンスチャートの詳細の表示

[View] パネルに表示されているメソッドパフォーマンスチャートおよびグラフの詳細を表示できます。

グラフのデータポイントをポイントすると、そのデータポイントがプロットされた時間と、プロット時の値が表示される (ナノ秒単位)。
チャートのスクロールバーをポイントすると、表示されている時間間隔の開始日時と終了日時が表示される。この情報から、この時間間隔が現在の時間間隔かどうかも判断できます。
チャートの凡例をポイントすると、凡例の各エントリについて以下の情報が表示される。

インスツルメントされたメソッドを含むクラスの名前
インスツルメントされたメソッドのスコープ
インスツルメントされたメソッドのシグネチャ

WebLogic 診断フレームワーク コンソール拡張の使い方

メソッド パフォーマンス チャートおよびグラフの操作

メソッド パフォーマンス チャートでのインスツルメンテーション データの使用

サーバの選択

メソッド パフォーマンス チャートおよびグラフの作成

[Requests] タブのリクエストとメソッドの表示

リクエストの詳細の表示

インスツルメンテーション イベントの詳細の表示