1 概要とロードマップ

このドキュメントでは、WebLogic診断フレームワーク(WLDF)について説明します。WLDFは、監視および診断フレームワークであり、WebLogic Serverのプロセス内で実行する一連のサービスの定義および実装を行い、標準サーバー・ライフ・サイクルに参加します。WLDFを使用すると、実行中のサーバーおよびそのコンテナ内にデプロイされているアプリケーションによって生成された、診断データを作成、収集、分析、アーカイブし、それらのデータに対するアクセスを行うことができます。このデータを基に、サーバーおよびアプリケーションの実行時パフォーマンスを把握できます。また、フォルト発生時に、このデータを使用して、フォルトを隔離および診断できます。

次の項では、このガイド(Oracle WebLogic Server診断フレームワークの構成と使用)の内容と対象読者について説明します。

WebLogic診断フレームワークとは
ドキュメントのスコープと対象読者
このドキュメントの手引き
関連ドキュメント
サンプルとチュートリアル
このリリースでの新機能と変更された機能

WebLogic診断フレームワークとは

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

Oracle HotSpotとの統合: WebLogic ServerがOracle HotSpotとともに構成されている場合、Javaフライト・レコーダ・ファイルにキャプチャされているWebLogic Serverに関して、WLDFによる診断情報の生成が可能です。
組込み診断システム・モジュール: そのまま使用できる一連の診断モジュールです。これにより、JVM、WebLogic Serverの実行時間およびWebLogic Serverの主要サブシステム(JDBCデータ・ソース、メッセージング、Java EEコンテナ(サーブレット、EJB、リソース・アダプタなど)を含む)の基本的なパフォーマンス・データを動的に取得できます。組込み診断モジュールは複製や変更も可能なため、簡単にカスタム診断システム・モジュールを作成する方法として使用できます。
監視ダッシュボード: WebLogic Serverおよびホストされたアプリケーションの現在の動作状態および動作状態の履歴をグラフィカルに表示します。これには組込み診断システム・モジュールにより収集された情報も含まれます。WebLogic Server管理コンソールからアクセスされた監視ダッシュボードは、重要性の高いランタイムWebLogic Serverのパフォーマンス・メトリックおよびそれらのメトリックの一定時間での変化を表示するビューに診断データを編成し表示するための一連のツールを提供します。
診断イメージ・キャプチャ - 障害発生後の分析に使用できる診断スナップショットをサーバーから作成します。診断イメージ・キャプチャには、Javaフライト・レコーダ・データが含まれていて、それが使用可能である場合、Java Mission Controlで表示できます。
アーカイバ - サーバー・インスタンスおよびアプリケーションから、データ・イベント、ログ・レコード、およびメトリックをキャプチャし、永続化します。
インストゥルメンテーション - WebLogic Serverインスタンスおよびその上で実行されているアプリケーションに診断コードを追加し、コード内の指定された場所で診断アクションを実行します。インストゥルメンテーション・コンポーネントは、システム内のリクエストの流れを追跡できるように、診断コンテキストをリクエストに関連付けるための手段を提供します。WebLogic Server管理コンソールには、アプリケーションにおけるパフォーマンスの問題の識別に役に立つツールとして機能しているWLDFインストゥルメンテーション機能から取得したメソッド・パフォーマンス情報のリアルタイムおよび履歴ビューを表示する「リクエスト・パフォーマンス」ページが含まれています。
ハーベスタ - WebLogic Server MBeanやカスタムMBeanなどのランタイムMBeanからメトリックをキャプチャします。メトリックはアーカイブして、履歴データを参照するために後でアクセスできます。
監視および通知 - サーバーおよびアプリケーションの状態をモニターし、監視の中で設定されている条件に基づいて通知を送信する手段を提供します。
ロギング・サービス - サーバー、サブシステムおよびアプリケーション・イベントを監視するためのログを管理します。WebLogic Serverロギング・サービスは、WebLogic診断フレームワークの他の部分とは別個のドキュメントで説明されています。『Oracle WebLogic Serverログ・ファイルの構成とログ・メッセージのフィルタ処理』を参照してください。

WLDFは、診断データに対する動的なアクセスと制御を可能にする標準化された一連のアプリケーション・プログラミング・インタフェース(API)、ならびにサーバーに関する可視性をもたらす改良されたモニターを実現します。独立系ソフトウェア・ベンダー(ISV)は、カスタム・モニタリングとWLDFとの統合に使用される診断ツールの開発にこれらのAPIを使用できます。第17章「WLDFのプログラムの構成と使用」で説明されているように、これらのAPIにはJMXやWebLogic Scripting Tool (WLST)を使用してアクセスできます。

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

ドキュメントのスコープと対象読者

このドキュメントでは、WLDFによるモニター・サービスと診断サービスを構成および使用する方法について説明します。

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

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

このドキュメントの手引き

このドキュメントの構成は次のとおりです。

この章「概要とロードマップ」では、WLDFコンポーネントの概要を示し、このガイドの対象読者について説明します。
第2章「WLDFアーキテクチャの概要」では、WLDFアーキテクチャの概要を示します。
第3章「組込み診断システム・モジュールの使用」では、組込み診断システム・モジュールについて説明します。これらはWebLogic診断フレームワーク(WLDF)に用意され、WebLogic Serverインスタンスの基本的なヘルス状態およびパフォーマンスの監視を実行する、シンプルかつ使用しやすいメカニズムです。
第4章「Javaフライト・レコーダと連携したWLDFの使用」では、Javaフライト・レコーダのWLDF統合機能および基本使用方法のシナリオを説明し、Javaフライト・レコーダ・ファイルに取得されたWebLogic Serverイベントを確認するためにJava Mission Controlを使用したサンプル・ウォークスルーを提供します。
第5章「WLDF構成の理解」では、WLDFの機能がサーバーとアプリケーションでどのように構成されるかについての概要を示します。
第6章「診断イメージの構成とキャプチャ」では、サーバーの重要な構成設定と状態のスナップショットをキャプチャするために、WLDF診断イメージ・キャプチャ・コンポーネントを構成および使用する方法について説明します。
第7章「診断アーカイブの構成」では、診断データをファイル・ストアまたはデータベースで永続化するために、WLDF診断アーカイブ・コンポーネントを構成および使用する方法について説明します。
第8章「メトリック収集用のハーベスタの構成」では、WebLogic Server MBeanおよびカスタムMBeanを含むランタイムMBeanからメトリックを収集するために、WLDFハーベスタ・コンポーネントを構成および使用する方法について説明します。
第9章「監視および通知の構成」では、WLDF監視および通知の概要を示します。
第10章「監視の構成」では、指定した条件に対してサーバー・インスタンスおよびアプリケーションをモニターして、その条件に合致した場合に通知を送信するように監視を構成する方法について説明します。
第11章「通知の構成」では、監視によってトリガー可能な通知を構成する方法について説明します。
第12章「インストゥルメンテーションの構成」では、WebLogic Serverクラスおよびサーバー上で実行しているアプリケーションのクラスに診断インストゥルメンテーション・コードを追加する方法について説明します。
第13章「診断コンテキストを管理するためのDyeInjectionモニターの構成」では、DyeInjectionモニターを使用する方法、および診断モニターで仕分けフィルタを使用する方法について説明します。
第14章「データ・アクセサを使用した診断データへのアクセス」では、診断データを取得するためにWLDFデータ・アクセサ・コンポーネントを使用する方法について説明します。
第15章「WLDFアプリケーション・モジュールのデプロイ」では、診断アプリケーション・モジュールとしてアプリケーションのインストゥルメンテーションを構成および管理する方法について説明します。
第16章「監視ダッシュボードの使用方法」では、WebLogic Serverの現在の動作状態および動作状態の履歴、およびWLDFでキャプチャした診断データを一部的に使用するホストされたアプリケーションをグラフィカルに表示する方法について説明します。
第17章「WLDFのプログラムの構成と使用」では、JMX APIおよびWebLogic Scripting Tool (WLST)を使用してWLDFの各コンポーネントを構成および使用する方法について概要を示します。
付録A「WLDF問合せ言語」では、データ・アクセサを使用して診断データを問合わせたり、監視ルールを作成したり、ログをフィルタ処理するためのルールを作成する式を作るためのWLDF問合せ言語について説明します。
付録B「WLDFインストゥルメンテーション・ライブラリ」では、WLDFインストゥルメンテーション・ライブラリであらかじめ定義されている診断モニターと診断アクションについて説明します。
付録C「式でのワイルドカードの使用方法」では、どのようにワイルドカードをWLDF式で使用するかについて説明します。
付録D「WebLogic Scripting Toolのサンプル」では、WebLogic Scripting Toolを使用してWLDFモニター・アクティビティと診断アクティビティを実行する方法の例を示します。
「用語集」はWLDFの用語集です。

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

このドキュメントの他にも、WLDFの構成や使い方を示す様々なサンプルとチュートリアルが用意されています。

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

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

MedRecはWebLogic ServerとJava EEの機能を例示し、推奨されるベスト・プラクティスを重要点として示します。MedRecはWebLogic Serverのディストリビューションにオプションでインストールされ、完全インストール・タイプを選択すると使用できます。Medrecは、デフォルトではインストール後にORACLE_HOME/user_projects/domains/medrecディレクトリに構成されます。ここでORACLE_HOMEは、使用するマシンのOracleホーム・ディレクトリを表します。詳細は、Oracle WebLogic Serverの理解のサンプル・アプリケーションおよびサンプル・コードに関する項を参照してください。

ダウンロード可能なWLDFサンプル

その他のWLDFサンプルは、http://www.oracle.com/technetwork/indexes/samplecode/index.htmlからダウンロードできます。これらのサンプルは、既存WebLogic Serverサンプル・ディレクトリ構成に展開できる.zipファイルとして配布されています。これらのサンプルには、Oracleが認定したもののほかに、開発協力者から提示されたサンプルもあります。

このリリースでの新機能と変更された機能

このドキュメントには次の変更点が含まれており、このリリースのWebLogic Serverに導入されたWLDFの新機能について説明されています。

組込み診断システム・モジュール: WebLogic Serverインスタンスの基本的なヘルス状態およびパフォーマンスの監視を実行する、シンプルかつ使用しやすいメカニズムを提供します。第3章「組込み診断システム・モジュールの使用」を参照してください。
Oracle HotSpotのサポート: WLDFはOracle HotSpotおよびJavaフライト・レコーダをサポートするようになりました。Javaフライト・レコーダは現在、デフォルトでは無効になっていることに注意してください。「Oracle HotSpotと連携したJavaフライト・レコーダの使用」を参照してください。
WLDF実行時制御: これにより、ターゲットのサーバーまたはクラスタを再起動することなく、診断システム・モジュールを動的にアクティブ化および非アクティブ化することが可能になります。「診断システム・モジュールの構成」を参照してください。
WLSTの新しいコマンド: 診断システム・モジュールの活性化および非活性化、ドメイン構成に永続化されないリソース記述子に基づいた診断システム・モジュールのデプロイおよびアンデプロイ、および診断システム・モジュールによりファイルに収集された、診断ハーベスタ・データのダンプを行います。「WLSTの使用による診断システム・モジュールの活性化および非活性化」および「診断のためのWLSTコマンド」を参照してください。

このリリースで導入されたWebLogic Serverの総合的な新機能一覧は、『Oracle WebLogic Serverの新機能』を参照してください。