この章では、ADFアプリケーションのパフォーマンスの表示方法について説明します。さらに、Oracle WebLogic Serverへのデプロイ後にADFアプリケーションのプロパティを構成する方法についても説明します。Oracle Enterprise Manager Fusion Middleware ControlとそのシステムMBeanブラウザを使用して監視および構成タスクを実行する方法について説明します。また、診断フレームワークによる問題の診断およびDMS SPYを使用したメトリックの監視についても説明します。
この章の内容は次のとおりです。
ADFアプリケーションをOracle WebLogic Serverにデプロイすると、このサーバーでアプリケーションのパフォーマンスを表示したり、アプリケーションのプロパティを構成できます。これらのタスクはEnterprise Manager Fusion Middleware Controlを使用して実行できます。
Enterprise Manager Fusion Middleware Controlは、パフォーマンス・タスクのユーザー・インタフェースを提供します。表3-1に示すように、一部の構成タスクはユーザー・インタフェースから実行することも、MBeanを構成して実行することもできます。
表3-1 Fusion Middleware Controlを使用した構成タスク
構成タスク | Fusion Middleware Control UI | Fusion Middleware Control MBeanブラウザ |
---|---|---|
ADFビジネス・コンポーネント |
第3.3.1項「ADFビジネス・コンポーネント・パラメータの変更」 |
第3.4.3項「MBeanを使用したADFビジネス・コンポーネント構成の変更」 |
ADF接続 |
|
|
ADFアプリケーション構成 |
第3.4.1項「MBeanを使用したADFアプリケーション構成の変更」 |
|
メタデータ・サービス(MDS) |
|
|
アクティブ・データ・サービス(ADS) |
第3.4.5項「MBeanを使用したアクティブ・データ・サービス構成の変更」 |
デフォルトで、MBeanを使用して行われたデプロイ後の変更は、レイヤー名adfshare
およびレイヤー値adfshare
でMDSに保存されます。特定のレイヤー名を指定するには、アプリケーションのadf-config.xml
でadfAppUId
プロパティを指定します。
例3-1に、adf-config.xml
内のadf-properties-child
コードを示します。
例3-1 adf-config.xmlファイルのMDSレイヤー
<adf:adf-properties-child xmlns="http://xmlns.oracle.com/adf/config/properties"> <adf-property name="adfAppUID" value="DeptApp.myApp"/> </adf:adf-properties-child>
テスト・システムから本番システムへの移動などMDSリポジトリ間でデータを移動させる場合は、『Oracle Fusion Middlewareの管理者』のOracleメタデータ・リポジトリの管理に関する章、および『WebLogic Server WLSTコマンド・リファレンス』のメタデータ・サービスのカスタムWLSTコマンドに関する章で説明しているように、MDSのexportMetadata
コマンドおよびimportMetadata
コマンドを使用します。
次のトピックで説明するように、Fusion Middleware Controlを使用して、Oracle ADFアプリケーションのパフォーマンスを監視できます。
アプリケーション・モジュール・プールおよびADFタスク・フローに関するパフォーマンス情報を表示できます。アプリケーション・モジュール・コンポーネントを使用すると、複数のブラウザ・ページにまたがる作業ユニットをサポートできます。
次のことが可能です。
アプリケーション・モジュールのプール・パフォーマンスを表示します。
タスク・フローのパフォーマンスを表示します。
ADFランタイムJARファイルのバージョン情報を検索して、結果を表で表示するか情報をExcelファイルにエクスポートできます。列ごとにフィルタを指定すると、結果を絞り込むことができます。
ランタイムJARのバージョン情報を検索するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、ランタイムJARを表示するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「バージョン」を選択します。
「ログ構成」ページが表示されます。
各列の結果にフィルタをかけるには、各列の上にある入力フィールドにフィルタ基準を入力します。たとえば、仕様2.2に関連付けられたJARファイルのみを表示する場合は、「仕様バージョン」列の上にあるフィールドに2.2と入力し、[Enter]キーを押します。
結果表をExcelファイルにエクスポートする場合は、「Excelにエクスポート」をクリックします。
アプリケーション・モジュールに関するパフォーマンス情報を表示できます。アプリケーション・モジュール・コンポーネントを使用すると、複数のブラウザ・ページにまたがる作業ユニットをサポートできます。
アプリケーションのパフォーマンスを表示するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、表示するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「ADFパフォーマンス」を選択します。
ADFパフォーマンス・ページが表示されます。ここには、アクティブなアプリケーション・モジュール・プールおよびタスク・フローに関するパフォーマンス情報を表示するサブタブが含まれます。
アプリケーション・モジュール・プールとは、複数のアプリケーション・クライアントによって共有される単一のアプリケーション・モジュール・タイプのインスタンスの集合です。1つのアプリケーション・モジュール・プールは、ADF Webアプリケーション(ADFビジネス・コンポーネント、ADF ControllerまたはADF Faces)が使用する各ルート・アプリケーション・モジュールごとに、各Java仮想マシンで作成されます。各Java仮想マシンでは、そのタイプのルート・アプリケーション・モジュールがADFコントローラ・レイヤーによって使用されます。
アプリケーション・モジュール・プールのパフォーマンスを表示するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、プールのパフォーマンスを表示するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「ADFパフォーマンス」を選択します。
「アプリケーション・モジュール・プール」タブをクリックします。
「モジュール」列で、アプリケーション・モジュールを選択すると、「アプリケーション・モジュール・プール」表にその詳細が表示されます。
アプリケーションが実行されていない場合は、「モジュール」列に「使用可能なデータがありません」
が表示されます。
モジュールをクリックすると、そのモジュールに関して、存続期間、状態の管理、プール使用およびアプリケーション・モジュール・プール・ページなどの詳細情報が表示されます。
アプリケーション・モジュール・プール・ページを使用して、アクティブなアプリケーション・モジュール・プールを表示します。アプリケーション・モジュール・プールは、同じタイプのアプリケーション・モジュール・インスタンスの集合です。アプリケーション・モジュール・プール・ページで、次の操作を行います。
プール接続に関するサイズおよびパフォーマンスの情報の表示
アプリケーション・モジュール・プールの動作に影響を与える設定の指定
アプリケーション・モジュール・プールの資格証明情報の指定
タスク・フローに関するパフォーマンス情報を表示できます。タスク・フローでは、ナビゲーションおよびアプリケーション制御へのモジュールおよびトランザクション方式のアプローチが提供されます。ほとんどの場合、タスク・フローには各種ページが表示されますが、マネージドBeanのメソッドのコール、EL式の評価または別のタスク・フローのコールを実行するアクティビティも表示され、これらは特定のページを開かなくても実行できます。
タスク・フローのパフォーマンスを表示するには、次の手順を実行します。
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、タスク・フローのパフォーマンスを表示するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「ADFパフォーマンス」を選択します。
「タスク・フロー」タブをクリックします。
デフォルトでは、タブ上のタスク・フロー・パフォーマンスのグラフに、直近の15分間のデータが表示されます。別の間隔を設定するには、ページにある時間をクリックするか、またはスライダを別の間隔に移動(例: 午前8時から午前8時半までに移動)できます。
TFグラフをクリックします。
「リクエスト処理時間」には、選択した期間に実行するすべてのADFタスク・フローの平均リクエスト処理時間が表示されます。
「アクティブ・タスクフロー」には、選択した期間の各ADFタスク・フローのアクティブなインスタンスの数が表示されます。
Enterprise Manager Fusion Middleware Controlを使用して、ADFアプリケーションの構成パラメータを構成できます。構成パラメータは、ADF MBeanに格納されます。Fusion Middleware Controlは、ADFビジネス・コンポーネントおよびADF接続MBeanを構成するためのユーザー・インタフェースを提供します。システムMBeanブラウザを使用して、直接基礎となるMBeanにアクセスし、その値を構成することもできます。基礎となるMBeanへのアクセスの詳細は、第3.4項を参照してください。
Fusion Middleware Controlを使用して、次のトピックで説明するように、ADFパラメータを構成できます。
アプリケーション・モジュール・プールの実行時動作は、適切な構成パラメータの設定により制御します。Fusion Middleware Controlは、ここで説明するとおり、ADFビジネス・コンポーネントを構成するためのUIを提供します。第3.4.3項で示すように、汎用のMBeanブラウザを使用して、直接ADFビジネス・コンポーネントMBeanを構成することもできます。
ビジネス・コンポーネント・パラメータを変更するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、ビジネス・コンポーネントを構成するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「ADFビジネス・コンポーネントの構成」を選択します。
「アプリケーション・モジュール」をクリックします。
「プーリングおよびスケーラビリティ」、「コア」、「データベース」または「セキュリティ」タブをクリックし、構成パラメータを更新します。
アプリケーション・モジュールにデータソースが使用される場合、「コア」タブの「データソースの編集」をクリックすることにより、データソースを構成できます。
ADFビジネス・コンポーネントの構成ページは、次のセクションまたはタブで構成されます。
「アプリケーション・モジュール」セクション
「プーリングおよびスケーラビリティ」タブ - 「アプリケーション・プール・プロパティ」
「プーリングおよびスケーラビリティ」タブ - 「接続プール・プロパティ」
「コア」タブ
「データベース・プロパティ」タブ
「セキュリティ・プロパティ」タブ
接続構成には、クライアント・アプリケーションがADFアプリケーション・モジュールのデプロイ・シナリオを識別する際に使用する情報が含まれます。Oracle Enterprise Manager Fusion Middleware Controlを使用して、次のタスクを実行します。
バックエンド・サービスの登録および管理(メール、ディスカッション・フォーラム・サーバーなど)
ユーザーがアプリケーションでの作業中にアクセスする必要がある外部アプリケーションの登録および管理
アプリケーションが使用するポートレット・プロデューサ、またはユーザーがアクセスする必要があるポートレット・プロデューサの登録および管理
Fusion Middleware Controlは、ここで説明するとおり、ADF接続を構成するためのUIを提供します。第3.4.2項で示すように、システムMBeanブラウザを使用して、直接ADF接続MBeanを構成することもできます。
Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。
ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADF接続属性はMDSに保存されます。
アプリケーションをクラスタ内の複数のノードにデプロイした場合、1つのノードのADF接続に対する変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについて接続に関する単一の情報セットが保存されます。
接続構成を変更するには、次の手順を実行します。
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、接続を構成するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「ADF接続の構成」を選択します。
「接続タイプ」ドロップダウン・リストで、構成する接続のタイプを選択します。
ADF BCサービス
エンタープライズ・スケジューリング・サービス
URL
Webサービス
Essbase接続は作成できませんが、アプリケーションとともにデプロイされている既存のEssbase接続を編集することはできます。
「接続名」フィールドに、接続構成の一意の名前を入力します。
「接続の作成」をクリックします。
接続構成ページが更新され、選択した接続タイプのオプションを指定できるセクションが表示されます。
Fusion Middleware ControlのシステムMBeanブラウザを使用して、ADFアプリケーションとともにOracle WebLogic ServerにデプロイされたADF MBean内の値にアクセスし、これを変更できます。
Fusion Middleware ControlのシステムMBeanブラウザを使用して、次のトピックで説明するような構成タスクを実行できます。
MBeanブラウザを使用して、ADFアプリケーション構成MBeanを変更できます。
ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADFアプリケーション属性はMDSに保存されます。
アプリケーションをクラスタ内の複数のノードにデプロイした場合、MBeanによる1つのノードに対するADFアプリケーション構成の変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについてADFアプリケーション構成に関する単一の情報セットが保存されます。
システムMBeanブラウザを使用してADFアプリケーション構成を変更するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、構成するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「ADFの構成(adf-config)」を選択します。
システムMBeanブラウザの左ペインで、親ADF MBean「ADFConfig」を展開してから「ADFConfig」フォルダを展開し、子ADF MBeanを表示します。
子ADF MBean「ADFcConfiguration」および「MDSAppConfig」が表示されます。
左ペインで「ADFcConfiguration」 MBeanを選択し、右ペインで表示または変更する属性を選択します。
属性値を変更し、「適用」をクリックします。
左ペインで、親ADF Mbean「ADFConfig」を選択します。
右ペインで、「操作」タブをクリックし、「保存」をクリックします。
親MBeanから「保存」をクリックした後、編集した新しい値がMDSに書き込まれます。
MBeanブラウザを使用して、ADF接続構成MBeanを変更できます。
第3.3.2項で示すように、Fusion Middleware UIを使用して、ADF接続を変更することもできます。
ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADFアプリケーション属性はMDSに保存されます。
アプリケーションをクラスタ内の複数のノードにデプロイした場合、MBeanによる1つのノードに対するADF接続の変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについてADFアプリケーション構成に関する単一の情報セットが保存されます。
システムMBeanブラウザを使用してADF接続構成を変更するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、構成するアプリケーションをクリックします。
「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」の左ペインで、「ADFConnections」 MBeanに移動します。MBeanは、oracle.adf.share.connections、サーバー名、アプリケーション名の順に移動した場所にあります。
左ペインでADF接続MBeanを選択し、右ペインで表示または変更する属性を選択します。
属性値を変更し、「適用」をクリックします。
右ペインで、「操作」タブをクリックし、「保存」をクリックします。
「保存」をクリックすると、編集した新しい値がMDSに書き込まれます。
MBeanブラウザを使用して、ADFビジネス・コンポーネント構成MBeanを変更できます。ADFビジネス・コンポーネントの構成情報は、各アプリケーションに固有のMbeanに格納されます。一度に同じアプリケーションのすべてのバージョンに対して構成できるADF接続やADFアプリケーション構成情報とは異なり、ADFビジネス・コンポーネントはアプリケーションのバージョンごとに構成する必要があります。
第3.3.1項で示すように、Fusion Middleware UIを使用して、ADFビジネス・コンポーネント構成情報を変更することもできます。
ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADFアプリケーション属性はMDSに保存されます。
アプリケーションをクラスタ内の複数のノードにデプロイした場合、MBeanによる1つのノードに対するADFビジネス・コンポーネントの変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについてADFアプリケーション構成に関する単一の情報セットが保存されます。
システムMBeanブラウザを使用してADFビジネス・コンポーネント構成を変更するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、構成するアプリケーションをクリックします。
「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」の左ペインで、BC4J MBeanに移動します。これらのMBeanは、oracle.bc4j.mbean.share、サーバー名、アプリケーション名の順に移動した場所にあります。
左ペインでADF接続MBeanを選択し、右ペインで表示または変更する属性を選択します。
属性値を変更し、「適用」をクリックします。
MBeanブラウザを使用して、MDSパラメータの拡張構成を実行できます。MBeanを使用したMDSの構成の詳細は、『Oracle Fusion Middlewareの管理』を参照してください。
Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。
システムMBeanブラウザを使用してMDS構成を変更するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、構成するアプリケーションをクリックします。
「アプリケーションのデプロイ」メニューで、「MDS構成」を選択します。
「構成MBeanブラウザ」または「ランタイムMBeanブラウザ」をクリックします。
MBeanおよび表示または変更する属性を選択します。
値を変更し、「適用」をクリックします。
左ペインで、親ADF Mbean「ADFConfig」を選択します。
右ペインで、「操作」タブをクリックし、「保存」をクリックします。
親MBeanから「保存」をクリックした後、編集した新しい値がMDSに書き込まれます。
アクティブ・データ・サービス(ADS)フレームワークを使用して、Oracle ADFアプリケーションおよび該当するADF Facesコンポーネントの実行時の動作を制御し、サーバーでデータが変更されると、ADFモデル・レイヤーによってコンポーネントに通知され、コンポーネントが変更されたデータを再度反映するように設定できます。
Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。
アプリケーションのADF Facesコンポーネントは、ADSを使用するように構成されている必要があります。さらに、アプリケーション・サービスがADSをサポートしていない場合、アプリケーションによってサービス・プロキシを定義して、データがソースで更新されるとコンポーネントがそれを表示できるようにする必要があります。ADSの詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』のアクティブ・データ・サービスの使用に関する項を参照してください。
システムMBeanブラウザを使用してアクティブ・データ・サービス構成を変更するには:
ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、構成するアプリケーションをクリックします。
「アプリケーション・デプロイメント」メニューから、「ADF」→「ADFの構成(adf-config)」を選択します。
システムMBeanブラウザの左ペインで、親ADF MBean「ADFConfig」を展開してから「ADFConfig」フォルダを展開し、子ADF MBeanを表示します。
子ADF MBean「ActiveDataConfiguration」および「MDSAppConfig」が表示されます。
左ペインで「ActiveDataConfiguration」MBeanを選択し、右ペインで表示または変更する属性を選択します。
属性 | 説明 |
---|---|
Transport |
データがクライアントに送信される方法。有効な値は次のとおりです。
詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』のADSトランスポート・モードに関する必知事項を参照してください。 |
LatencyThreshold |
待機しきい値(ミリ秒単位)。このしきい値よりもネットワーク遅延が大きいアクティブなデータ・メッセージは遅延とみなされます。 |
KeepAliveInterval |
イベントが生成されていないときに、キープアライブ・メッセージを送信する頻度(ミリ秒単位)。 |
PollingInterval |
|
MaxReconnectAttemptTime |
クライアントが接続を切断された場合に、プッシュ・チャンネルの再接続の試行を続ける最大期間(ミリ秒単位)。 |
ReconnectWaitTime |
再接続の試行の間の間隔(ミリ秒単位)。 |
属性値を変更し、「適用」をクリックします。
左ペインで、親ADF Mbean「ADFConfig」を選択します。
右ペインで、「操作」タブをクリックし、「保存」をクリックします。
親MBeanから「保存」をクリックした後、編集した新しい値がMDSに書き込まれます。
Enterprise Manager Fusion Middleware Controlを使用して、ADFアプリケーションとともに資格証明ストアにデプロイされた資格証明を編集できます。新しい資格証明を作成したり、既存の資格証明を削除することもできます。
ADFアプリケーションの場合、次の考慮事項が該当します。
マップ名は、通常アプリケーションのadf-config.xml
ファイルに定義されたadfAppUId
プロパティです。
キー名は、通常anonymous#
connection
の形式となります。ここでconnection
は接続名です。
資格証明タイプは汎用で、これはキー/値ペアのハッシュ・マップとしてモデル化されます。
詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のFusion Middleware Controlでの資格証明の管理に関する項を参照してください。
Oracle Fusion Middlewareは、アプリケーションの問題の検出、診断および解決を支援する診断フレームワークを提供します。
クリティカル・エラーが発生すると、診断フレームワークは即座に診断データを取得し、そのデータとエラーをインシデント番号と関連付けます。この番号を使用して、自動診断リポジトリ(ADR)から分析のためのデータを取得できます。
Oracle ADFでは、INCIDENT_ERRORメッセージがログに記録されると実行されるADFConfigダンプを提供します。アプリケーションの例外ハンドラでダンプを起動するコードを追加することもできます。例3-2に、ADFConfigダンプを起動するよう、例外ハンドラに追加できるサンプル・コードを示します。
例3-2 例外ハンドラでADFConfig診断ダンプを起動するサンプル・コード
IllegalArgumentException e = new IllegalArgumentException("test exception"); LoggerFactory.getFrameworkLogger().log(ODLLevel.INCIDENT_ERROR, "Test error message", e);
診断フレームワークの詳細は、『Oracle Fusion Middlewareの管理』を参照してください。
DMS Spyサーブレットを使用してアプリケーションのメトリック情報をWebブラウザに表示できます。
詳細は、『パフォーマンスのチューニング・ガイド』のOracle Fusion Middlewareの監視に関する項を参照してください。