WebLogic 診断フレームワークのコンフィグレーションと使い方

データアクセサを使用した診断データへのアクセス

WebLogic 診断フレームワーク (WLDF) のデータアクセサコンポーネントでは、ログレコード、データイベント、収集されたメトリックなどのさまざまなソースから得られた診断データにアクセスできます。

データアクセサを使用すると、型、コンポーネント、属性を基準としてデータをルックアップできます。時間ベースのフィルタ処理を実行でき、イベントにアクセスする際には重大度、ソース、コンテンツを基準としたフィルタ処理が可能です。また、表形式の診断データにアクセスすることもできます。

以下の節では、データアクセサについて説明し、オンライン (サーバが実行中の状態) およびオフライン (サーバが実行中でない状態) でデータアクセサを使用する方法について示します。

データアクセサのアクセス対象のデータストアについて

データアクセサでは、他の WLDF コンポーネントから診断情報を取得します。キャプチャされた情報は、診断データの種類別に分かれた複数の論理データストア内に分類されます。たとえば、サーバログ、HTTP ログ、収集されたメトリックは、それぞれ別のデータストアにキャプチャされます。

WLDF では、診断データがサーバ単位で管理されます。そのため、データアクセサでは個々のサーバのデータストアにアクセスできます。

データストアは表形式を取ることがあります。表の各レコードが 1 つの項目を表し、その項目の特性が複数のカラムで説明されます。さまざまなデータストアに多様なカラムがありますが、データ項目が収集された時間などほとんどのデータストアで共有されるカラムもあります。

データアクセサでは、サーバの WLDF で使用されるデータストアについて以下のような情報を取得できます。

サポートされるデータストアのタイプのリスト。以下のようなものがあります。

HTTP_LOG
HARVESTED_DATA_ARCHIVE
EVENTS_DATA_ARCHIVE
SERVER_LOG
DOMAIN_LOG
HTTP_ACCESS_LOG
WEBAPP_LOG
CONNECTOR_LOG
JMS_MESSAGE_LOG
CUSTOM_LOG

利用可能なデータストアのインスタンスのリスト。
各データストアのレイアウト (データストアのカラムが記述された情報)

WLDFAccessRuntimeMBean を使用すると、このようなデータストアを検索したり、データストアにあるデータの性質を判断したりできます。また、クエリを使用してそうしたデータに選択的にアクセスすることもできます。

WebLogic のログの詳細については、『ログファイルのコンフィグレーションとログメッセージのフィルタ処理』を参照してください。

診断データへのオンラインアクセス

実行中のサーバの診断データには、Administration Console、JMX API 群、または WebLogic Scripting Tool (WLST) を使用してアクセスできます。

Administration Console を使用してデータにアクセスする

Administration Console では、明示的にデータアクセサを使用することはありませんが、アクセサで収集された情報は Administration Console に表示されます。たとえば、[ログファイルの概要] ページなどがそれに該当します。Administration Console オンラインヘルプの「ログの表示とコンフィグレーション」を参照してください。

実行時 MBean を使用してプログラム的にデータにアクセスする

データアクセサには、データストアの検索とデータストアからのデータ取得のために以下の実行時 MBean が用意されています。

以下の処理には WLDFAccessRuntimeMBean を使用する。

サーバ上の利用可能なデータストアの論理名を取得する。
特定のデータストアのデータにアクセスするために、論理名を基に WLDFDataAccessRuntimeMBean をルックアップする。さまざまなデータストアは、各自の論理名によってユニークに識別されます。

『WebLogic Server MBean リファレンス』の「WLDFAccessRuntimeMBean」を参照してください。

検索条件またはクエリに基づいてデータストアを取得するには、WLDFDataAccessRuntimeMBean を使用する。クエリには任意で時間間隔を指定して、特定の時間内にデータレコードを取得するようにできます。この MBean には、データセットの複数のカラム、およびデータストア内のレコード群の最古と最新のタイムスタンプに関するメタデータが備わっています。

現在、データアクセサの実行時 MBean が作成されて登録されるまでには時間がかかります。そのため、このような MBean にリモートクライアントからアクセスしようとすると、MBean が存在せずに InstanceNotFoundException が送出されることがあります。
クライアントでは、WLDFAccessRuntime の WLDFDataAccessRuntimes 属性を取得して、認識されているすべてのデータアクセス実行時 MBean を作成するようにできます。たとえば、次のようにします。 ObjectName objName = new ObjectName("com.bea:ServerRuntime=" + serverName + ",Name=Accessor," + "Type=WLDFAccessRuntime," + "WLDFRuntime=WLDFRuntime"); rmbs.getAttribute(objName, "WLDFDataAccessRuntimes");
『WebLogic Server MBean リファレンス』の「WLDFDataAccessRuntimeMBean」を参照してください。

注意 : WebLogic Server インスタンスをホストするサーバのクロックがリセットされると、タイムスタンプに基づくクエリで予期しない結果を招くことがあります。

WLST を使用してオンラインで診断データにアクセスする

WLST の exportDiagnosticDataFromServer コマンドを使用すると、実行中のサーバの診断データにアクセスできます。このコマンドの構文とサンプルについては、「WLST コマンドおよび変数リファレンス」の「診断コマンド」を参照してください。

データアクセサで WLDF クエリ言語を使用する

データストアのデータを問い合わせるには、WLDF クエリ言語を使用します。データアクセサのクエリ言語の構文については、「WLDF クエリ言語」を参照してください。

診断データへのオフラインアクセス

WLST の exportDiagnosticData コマンドを使用すると、オフライン状態にあるサーバの診断データの履歴にアクセスできます。このコマンドの構文とサンプルについては、「WLST コマンドおよび変数リファレンス」の「診断コマンド」を参照してください。

注意 : アーカイブされたデータについては、そのデータの永続化を行ったマシンに置かれている場合にのみ exportDiagnosticData を使用してアクセスできます。

データアクセサのオフラインモードでは、データストアインスタンスの検索はできません。インスタンスについてはあらかじめ認識しておく必要があります。

データ アクセサを使用した診断データへのアクセス

データ アクセサのアクセス対象のデータ ストアについて

診断データへのオンライン アクセス