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

概要とロードマップ

以下の節では、このマニュアル『WebLogic 診断フレームワークのコンフィグレーションと使い方』の内容と対象読者について説明します。

WebLogic 診断フレームワーク (WebLogic Diagnostic Framework) とは

WebLogic 診断フレームワーク (WLDF) とは、BEA WebLogic Server® のプロセス内で実行され標準的なサーバのライフサイクルに参加する、一連のサービスを定義および実装するモニタおよび診断フレームワークです。WLDF を使用すると、実行中のサーバおよびそのコンテナ内にデプロイされているアプリケーションによって生成された、診断データを作成、収集、分析、アーカイブし、それらのデータに対するアクセスを行うことができます。このデータにより、サーバの実行時パフォーマンスに関する識見が得られます。

WLDF には、以下のようなデータの収集および分析用コンポーネントが含まれています。

診断イメージキャプチャ - 障害発生後の分析に使用できる診断スナップショットをサーバから作成します
アーカイバ - サーバインスタンスおよびアプリケーションから、データイベント、ログレコード、およびメトリックをキャプチャし、永続化します
インスツルメンテーション - WebLogic Server インスタンスおよびその上で実行されているアプリケーションに診断コードを追加し、コード内の指定された場所で診断アクションを実行します。インスツルメンテーションコンポーネントは、システム内のリクエストの流れを追跡できるように、診断コンテキストをリクエストに関連付けるための手段を提供します。
ハーベスタ - WebLogic Server MBean やカスタム MBean などの実行時 MBean からメトリックをキャプチャします。メトリックはアーカイブして、履歴データを参照するために後でアクセスできます。
監視と通知 - サーバおよびアプリケーションの状態をモニタし、監視の中で設定されている条件に基づいて通知を送信する手段を提供します
ロギングサービス - サーバ、サブシステム、およびアプリケーションイベントをモニタするためのログを管理します。WebLogic Server ロギングサービスは、WebLogic 診断フレームワークの他の部分とは別個のドキュメントで説明されています。『ログファイルのコンフィグレーションとログメッセージのフィルタ処理』を参照してください。

WLDF は、診断データに対する動的なアクセスと制御を可能にする標準化された一連のアプリケーションプログラミングインタフェース (API)、ならびにサーバに関する可視性をもたらす改良されたモニタを実現します。

WLDF は WebLogic Server 9.0 の新機能でした。WLDF により、標準インタフェースを通じてサーバデータへの動的なアクセスが可能となり、特定の時点にアクセスされたデータを、サーバの停止および再起動を行うことなく変更できます。

マニュアルの内容と対象読者

このマニュアルでは、WLDF によるモニタサービスと診断サービスをコンフィグレーションおよび使用する方法について説明します。

WLDF は、WebLogic Server インスタンスおよびクラスタを実行する際の問題点や、それらにデプロイされているアプリケーションにおける問題点をモニタし、診断するための機能を提供します。したがって、このマニュアル内の情報は、システム管理者とアプリケーション開発者の双方を対象としています。また、WLDF をサポートおよび拡張するツールを構築するサードパーティのツール開発者向けの情報も記載しています。

読者は、Web テクノロジ、および WebLogic Server がインストールされているオペレーティングシステムとプラットフォームに精通していることが前提となっています。

このマニュアルの手引き

このマニュアルの構成は次のとおりです。

この章「概要とロードマップ」では、WLDF コンポーネントの概要を示し、このガイドの対象読者について説明します。
「WLDF アーキテクチャの概要」では、WLDF アーキテクチャの概要を示します。
「WLDF コンフィグレーションについて」では、WLDF の各機能がサーバとアプリケーションでどのようにコンフィグレーションされるかについて概要を示します。
「診断イメージのコンフィグレーションとキャプチャ」では、サーバの重要なコンフィグレーション設定と状態のスナップショットをキャプチャするために、WLDF 診断イメージキャプチャコンポーネントをコンフィグレーションおよび使用する方法について説明します。
「診断アーカイブのコンフィグレーション」では、診断データをファイルストアまたはデータベースで永続化するために、WLDF 診断アーカイブコンポーネントをコンフィグレーションおよび使用する方法について説明します。
「メトリック収集用のハーベスタのコンフィグレーション」では、WebLogic Server MBean およびカスタム MBean を含む実行時 MBean からメトリックを収集するために、WLDF ハーベスタコンポーネントをコンフィグレーションおよび使用する方法について説明します。
「監視と通知のコンフィグレーション」では、WLDF 監視と通知の概要を示します。
「監視のコンフィグレーション」では、サーバインスタンスおよびアプリケーションをモニタして、指定した条件に合致するかどうかをチェックし、その条件に合致した場合に通知を送信するように監視をコンフィグレーションする方法について説明します。
「通知のコンフィグレーション」では、監視によってトリガ可能な通知をコンフィグレーションする方法について説明します。
「インスツルメンテーションのコンフィグレーション」では、WebLogic Server クラスおよびサーバ上で動作するアプリケーションのクラスに診断インスツルメンテーションコードを追加する方法について説明します。
「診断コンテキストを管理するための DyeInjection モニタのコンフィグレーション」では、DyeInjection モニタを使用する方法、および診断モニタで仕分けフィルタを使用する方法について説明します。
「データアクセサを使用した診断データへのアクセス」では、診断データを取得するために WLDF データアクセサコンポーネントを使用する方法について説明します。
「WLDF のプログラム的なコンフィグレーションと使用」では、JMX API および WebLogic Scripting Tool (weblogic.WLST) を使用して WLDF の各コンポーネントをコンフィグレーションおよび使用する方法について概要を示します。
「WLDF クエリ言語」では、データアクセサを使用して診断データを問い合わせたり、監視ルールを作成したり、ログをフィルタ処理するためのルールを作成する式を作るための WLDF クエリ言語について説明します。
「WLDF インスツルメンテーションライブラリ」では、WLDF インスツルメンテーションライブラリであらかじめ定義されている診断モニタと診断アクションについて説明します。
「WebLogic Scripting Tool のサンプル」では、WebLogic Scripting Tool を使用して WLDF モニタアクティビティと診断アクティビティを実行する方法の例を示します。
「用語」は WLDF の用語集です。

サンプルとチュートリアル

このマニュアルの他にも、WLDF のコンフィグレーションや使い方を示すさまざまなサンプルとチュートリアルが用意されています。

Avitek Medical Records アプリケーション (MedRec) とチュートリアル

MedRec は WebLogic Server に付属したエンドツーエンドのサンプル J2EE アプリケーションであり、一元的で独立した医療記録管理システムをシミュレートします。MedRec アプリケーションは、患者、医師、および管理者に対して、さまざまなクライアントを使用して患者のデータを管理するためのフレームワークを提供します。

MedRec では WebLogic Server と J2EE の機能が例示され、BEA 推奨のベストプラクティスが重要点として示されます。MedRec は WebLogic Server 配布キットに含まれており、Windows マシンの [スタート] メニューからアクセスできます。Linux などのプラットフォームでは、WL_HOME\samples\domains\medrec ディレクトリから MedRec を起動します。WL_HOME は、WebLogic Platform の最上位インストールディレクトリです。

このリリースでの新機能と変更点

WebLogic 診断フレームワークは WebLogic Server 9.0 で導入されました。このリリースでは以下の新機能があります。

デプロイメントプランを使用する場合のホットスワップのサポート

WebLogic Server では、J2EE デプロイメント仕様 API (JSR-88) で指定されているように、デプロイメントプランをサポートしています。デプロイメントプランを使うと、アプリケーション構築後に、そのアプリケーションのアーカイブに変更を加えることなく、コンフィグレーションを変更できます。

リリース 9.0 では、デプロイメントプランを使用していても、診断コンフィグレーションを変更後は、アプリケーションを再デプロイする必要がありました。

WebLogic Server 9.1 では、デプロイメントプランを使用する場合、WLDF は「ホットスワップ」という機能をサポートしています。ホットスワップを有効化してから、デプロイメントプランと共にアプリケーションをデプロイすると、アプリケーションを再デプロイすることなく、診断インスツルメンテーションの設定を動的に更新できます。

「インスツルメンテーションコンフィグレーションを動的に制御するためのデプロイメントプランの使用」を参照してください。

WLDF コンソール拡張

WebLogic 診断フレームワーク (WLDF) コンソール拡張は、WebLogic Server Administration Console に追加可能な拡張機能です。これにより、診断データをチャートやグラフとしてグラフィックに提示 (「ビジュアライズ」) する表示方式とツールが提供されます。『WebLogic 診断フレームワークコンソール拡張の使い方』を参照してください。