ADFモニタリングに使用できる様々なデータ収集オプションがあります。 RUEIデータ収集の詳細は、「データ・コレクション」を参照してください。 ADFは、次のいずれかの方法を使用して監視できます。
表4-1 ADF監視のオプション
モード | 収集されるメトリック | 説明 |
---|---|---|
ネットワーク・データ・コレクタのみ |
「RUEIユーザー・ガイド」の「Oracle ADFサポート」の付録で説明されているデフォルトのADFメトリック。 |
このオプションは、「データ・コレクション」で説明されており、ADFサーバーでの特定の構成は必要ありません。 |
ADF監視サービスのみ |
ページ、UserID、ADFベースのディメンションおよびクライアント側のページ・ロード時間 |
このオプションを使用するには、「ADFモニタリング・サービスのデプロイ」の説明に従ってADFモニタリング・サービスをデプロイし、ADFアプリケーションでモニタリング・サービスを有効化する必要があります。 |
混合 - ネットワーク・データ・コレクタ |
デフォルトのADFメトリック(RUEIユーザーズ・ガイドの付録Oracle ADFのサポートを参照)と、ADF監視サービスからのユーザーID、ADFベース・ディメンション、クライアント側ページ・ロード時間 |
ネットワーク・データ・コレクタがデータのプライマリ・ソースとなり、ADF監視サービスが拡張的なレポートを提供します。 RUEI 12.1.0.6では、このモードの操作のみがサポートされていました。 ネットワーク・データ・コレクタは主にADFアプリケーションの監視に使用され、ADF監視サービスは、ECIDキャッシュを使用してネットワーク・トラフィックと相互に関連付けられた追加情報(ユーザーIDなど)を提供します。 このオプションを使用するには、「ADFモニタリング・サービスのデプロイ」の説明に従ってADFモニタリング・サービスをデプロイし、ADFアプリケーションでモニタリング・サービスを有効化する必要があります。 |
真の混合 |
デフォルトのADFメトリック(RUEIユーザーズ・ガイドの付録Oracle ADFのサポートを参照)と、ADF監視サービスからのユーザーID、ADFベース・ディメンション、クライアント側ページ・ロード時間 |
このオプションを指定すると、データ収集は最もフレキシブルになり、ネットワーク・データ・コレクタから一部のデータを、ADF監視サービスから別のデータを収集できます。 これは、ADFベースでないコンポーネントがアプリケーションに含まれている場合に特に有用です。 このオプションを使用するには、「ADFモニタリング・サービスのデプロイ」の説明に従ってADFモニタリング・サービスをデプロイする必要があります。ADFアプリケーションのモニタリング・サービスを有効にし、フレームワーク例外を使用して、ネットワーク・データ・コレクタによってアプリケーションのどの部分がモニターされ、ADFモニタリング・サービスによってモニターされているかを判断します。 フレームワーク例外の作成方法の詳細は、「RUEIユーザー・ガイド」の「スイートおよびWebサービスの使用」の章を参照してください。 |
この項では、ADF監視サービスをデプロイおよび構成する手順について説明します。
ADFモニタリング・サービスの使用はオプションです。 ADF監視サービスを使用すると、ネットワーク・プロトコル分析(NPA)でアクセスできない層から診断情報を収集できます。 この情報を他のADF情報と統合して、エンド・ユーザーの操作性に関する問題を特定するために使用できます。 結果の情報は、RUEIレポート、データ・ブラウザおよびセッション診断で使用可能です。
ADF監視サービスがRUEIと通信するためには、ADF監視サービス権限を持つRUEIユーザーが必要です。 この権限は、RUEIシステム・アカウントにのみ使用可能です。 アカウントの作成および権限の設定の詳細は、「RUEIユーザー・ガイド」の「ユーザーと権限の管理」を参照してください。
ADFモニタリング・サービスをWebLogicサーバー環境にデプロイするには、次の手順を実行します:
RUEIディストリビューションzipファイルの/root/RUEI/131/extra
ディレクトリにあるRueiEUMService.war
を、WebLogic Serverからアクセス可能な場所にコピーします。
WebLogicサーバー管理コンソールにログインし、「デプロイメント」画面にナビゲートし、「インストール」をクリックしてwarファイルをデプロイします。 アプリケーションとしてではなくライブラリとしてインストールします。
前述のステップ2のかわりに、コマンドラインを使用してデプロイすることもできます。
環境変数を設定します。
setenv BEA_HOME Weblogic_home_dir setenv PATH JDK_dir/bin:$PATH setenv DOMAIN_HOME ${BEA_HOME}/user_projects/domains/domain_name setenv WARFILE $DOMAIN_HOME/servers/AdminServer/upload/RueiEUMService.war
ここで、
Weblogic_home_dir
は、WebLogicがインストールされている場所です。
JDK_dir
は、JDKがインストールされている場所です。
domain_name
は、WebLogicドメインの名前です。
ディレクトリをステップ1で使用したロケーションに変更し、次のコマンドを実行します(プロンプトが表示されたらパスワードを入力します):
. $BEA_HOME/wlserver_10.3/server/bin/setWLSEnv.sh cp RueiEUMService.war $DOMAIN_HOME/servers/AdminServer/upload/ java weblogic.Deployer -adminurl adminurl -username username -deploy -source $WARFILE -targets wlservername -stage -library
ここで、
adminurl
は、WebLogic管理コンソールのURLです
username
は、管理者ユーザー名です。
wlservername
は、WebLogic Serverの名前です。
ADFアプリケーションをADF監視サービスで使用できるように構成するには、カスタム・デプロイメント・プランを使用して再デプロイする必要があります。
ADFアプリケーションのEARの標準デプロイメント・ディスクリプタを生成するには、Webコンソールまたは下記のコマンドを使用できます。
環境変数を設定します。
setenv BEA_HOME Weblogic_home_dir setenv PATH JDK_dir/bin:$PATH
ここで、
Weblogic_home_dir
は、WebLogicがインストールされている場所です。
JDK_dir
は、JDKがインストールされている場所です。
次のコマンドを実行します。
. $BEA_HOME/wlserver_10.3/server/bin/setWLSEnv.sh setenv PLANFILE path_of_app/Appname/deploy/stdplan.xml setenv EARFILE path_of_app/Appname/deploy/application_file java weblogic.PlanGenerator -all -plan $PLANFILE $EARFILE
ここで、
path_of_app
は、ADFアプリケーションへの完全なディレクトリ場所です。
Appname
ADFアプリケーションの名前
application_file
は、アプリケーションのearファイルまたはwarファイルの名前です。
「デフォルトのデプロイメント・ディスクリプタを生成」で作成したデプロイメント・ディスクリプタ・ファイルを変更するには、次の手順を実行します:
次のコードを使用して、<variable-definition>
セクションをstdplan.xml
ファイルに追加します。
<!-- variables for RUEI eum --> <variable> <name>oracle.adf.view.faces.context.ENABLE_ADF_EXECUTION_CONTEXT_ PROVIDER</name> <value>true</value> </variable> <variable> <name>oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.rueiUrl</name> <value>http(s)://app_host:port/ruei/receive.php</value> </variable> <variable> <name>LibraryRef_RueiEUMLibrary</name> <value>RueiEUMLibrary</value> </variable> <variable> <name>oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.bufferSize </name> <value>Buffer_size</value> </variable> <variable> <name>oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.flushTime</name> <value>Buffer_fushtime</value> </variable> <!-- variables for RUEI eum -->
ここで、
app_host
はRUEIホスト名です。
port
はRUEIポート番号です。
Buffer_size
は、RUEIに送信されるデータをバッファリングするための整数値です。
Buffer_flushtime
は、バッファ・データをRUEIにフラッシュするまでの時間(ミリ秒)です。
次のコードを使用して、<module-override>
セクションをWebLogic.xml
ファイルに追加します。
<!-- RUEI library --> <variable-assignment> <name>LibraryRef_RueiEUMLibrary</name> <xpath>/weblogic-web-app/library-ref/[context-root="null",library-name="RueiEndUserMonitoringService"]/library-name</xpath> </variable-assignment> <!-- RUEI library -->
次のコードを使用して、<module-override>
セクションをweb.xml
ファイルに追加します。
<!-- set RUEI eum variables --> <variable-assignment> <name>oracle.adf.view.faces.context.ENABLE_ADF_EXECUTION_CONTEXT_PROVIDER</name> <xpath>/web-app/context-param/[param-name="oracle.adf.view.faces.context.ENABLE_ADF_EXECUTION_CONTEXT_PROVIDER"]/param-value</xpath> </variable-assignment> <variable-assignment> <name>oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.bufferSize</name> <xpath>/web-app/context-param/[param-name="oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.bufferSize"]/param-value</xpath> </variable-assignment> <variable-assignment> <name>oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.flushTime</name> <xpath>/web-app/context-param/[param-name="oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.flushTime"]/param-value</xpath> </variable-assignment> <variable-assignment> <name>oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.rueiUrl</name> <xpath>/web-app/context-param/[param-name="oracle.sysman.apm.ruei.monitoring.RueiEndUserMonitoringService.rueiUrl"]/param-value</xpath> </variable-assignment> <!-- set RUEI eum variables -->
注意:
前述の変数のいずれかがすでにADFアプリケーションに存在している場合、<operation>replace</operation>
を使用して、それらの変数を新しい値で置き換えることができます。
「RUEIシステム・ユーザーの作成」で、ADFモニタリング・サービスのユーザー資格証明を作成しました。 これらの資格証明を格納するウォレットを作成する手順は、次のとおりです。
環境変数を設定します。
setenv BEA_HOME Weblogic_home_dir setenv PATH JDK_dir/bin:$PATH
ここで、
Weblogic_home_dir
は、WebLogicがインストールされている場所です。
JDK_dir
は、JDKがインストールされている場所です。
WebLogic Serverコンソールを起動します。
. $BEA_HOME/wlserver_10.3/server/bin/setWLSEnv.sh $BEA_HOME/oracle_common/common/bin/wlst.sh
次のWebLogicサーバー・コンソール・コマンドを実行します:
connect()
プロンプトが表示されたら、WebLogic管理者のユーザー名とパスワードを入力します。 URLを要求されたら、t3://admin_host:admin_portと入力します。各要素の意味は次のとおりです。
admin_host
は、WebLogicホスト名です。
admin_password
は、WebLogicポートです。
次のWebLogicサーバー・コンソール・コマンドを実行します():に要求された場合はパスワードを入力します):
map = "ruei_adf_monitoring_agent" key = "receiver" desc = "RUEI Receiver" createCred(map=map, key=key, user="user", password="password", desc=desc)
ここで、
user
は「RUEIシステム・ユーザーの作成」で作成したユーザー名です
password
は、RUEIシステム・ユーザーのパスワードです。
ユーザーが作成されたことを確認するには、次のWebLogic Serverコンソールを実行します:
listCred(map=map, key=key)
ユーザーがリストされている場合は、次のWebLogic Serverコンソールを実行して接続を解除します:
disconnect()
[Ctrl]+[D]を使用して、WebLogicコンソールを終了します。
user_projects/domains/
domain_name
/config/fmwconfig/system-jazn-data.xml
ファイルに含まれるように編集します:
<grant> <grantee> <codesource> <url>file:${domain.home}/servers/${weblogic.Name}/tmp/_WL_user/RueiEndUserMonitoringService/-</url> </codesource> </grantee> <permissions> <permission> <class>oracle.security.jps.service.credstore.CredentialAccessPermission</class> <name>context=SYSTEM,mapName=ruei_adf_monitoring_agent,keyName=receiver</name> <actions>read</actions> </permission> </permissions> </grant>
ここで、
domain_name
は、WebLogicドメインの名前です。
ADFアプリケーションを再デプロイするには、WebLogic Server管理コンソール(デプロイメント→更新)を使用するか、次に示す手順を使用します。
環境変数を設定します。
setenv BEA_HOME Weblogic_home_dir setenv PATH JDK_dir/bin:$PATH . $BEA_HOME/wlserver_10.3/server/bin/setWLSEnv.sh setenv PLANFILE deployment_path/stdplan.xml setenv EARFILE path_to_YourApplicationFile
,
Weblogic_home_dir
は、WebLogicがインストールされている場所です。
JDK_dir
は、JDKがインストールされている場所です。
deployment_path
は、ADFデプロイメントの場所です。
path_to_YourApplicationFile
は、ADF earファイルまたはwarファイルの場所です。
次のコマンドを実行します():に要求された場合はパスワードを入力します):
java weblogic.Deployer -adminurl adminurl -username username -deploy -name app_name -source $EARFILE -targets target_server -stage -plan $PLANFILE
ここで、
adminurl
は、WebLogic管理コンソールのURLです。
username
は、管理者ユーザー名です。
app_name
は、アプリケーション・デプロイメント名です。
target_server
は、ターゲットWebLogic Serverの名前です。
ADFアプリケーションを監視するときに、Weblogicのドメイン/ポートがユーザー・アプリケーションのドメイン/ポートと異なっている場合(ロード・バランサを使用する場合や、ネットワーク内のRUEIインストールの場所によって異なる場合など)、RUEIでスイートを定義する際にアプリケーションのドメイン/ポート詳細の両方を入力する必要があります。
スイートの作成後、次の手順で2番目のアプリケーション・ドメイン/ポート詳細を追加します。
アプリケーション→スイートを選択します。
変更するADFスイートを選択します。
識別タブで新規フィルタの追加を選択します。 2番目のドメイン/ポートの詳細を入力します。
ADFモニタリング・サービスのトラブルシューティングを行うには、次の手順を実行します:
ADFアプリケーションにログインし、これと対話してHTTPリクエストを取り消します(ADFモニタリング・サービスは最初のHTTPリクエストの後にのみ初期化されます)。
HTTPツール(HTTPHeaders Firefox拡張機能など)を使用して、POSTヘッダーにoracle.adf.view.rich.monitoring.UserActivityInfo
という文字列が含まれていることを確認します。
次に例を示します。
...&org.apache.myfaces.trinidad.faces.FORM=f1...&oracle.adf.view.rich.monitoring.UserActivityInfo=%3Cm+xmlns%3D%22http%3A%2F%2Foracle.com...
ヘッダーにこのテキストが含まれていない場合は、web.xml
ファイルおよび使用されているADFバージョンを確認してください。
サーバー・ログでライブラリ登録ログを確認します。
たとえば、次のようなエントリについて、Oracle_Home
/Middleware_11.1.2.3.0/user_projects/domains/
domain_name
/servers/AdminServer/logs/AdminServer.log
ファイルを検索します:
Registered library Extension-Name: RueiEndUserMonitoringService
ログ・ファイルに前述のようなエントリが含まれない場合は、「ADFモニタリング・サービス・ソフトウェアのデプロイ」の説明に従って、ライブラリ(RueiEUMService.war
)が正しくデプロイされていることを確認します。
server
-diagnostics.log
ファイルでoracle.sysman.apm.ruei
エントリを確認します。
たとえば、AdminServer-diagnostics.log
内に次のログ・エントリがあれば、正常な処理が行われています。
.[NOTIFICATION] ... Starting RUEI End User Monitoring Service ...[NOTIFICATION] ... Succesfully retrieved information for user eud from the wallet ...[NOTIFICATION] ... Using Basic Authentication ...[NOTIFICATION] ... Set RUEI receiver URL to http://<your ruei host:port>/ruei/receive.php ...[NOTIFICATION] ... RUEI End User Monitoring Service running ...[TRACE]...[SRC_METHOD: logUserActivity] Received useractivity to ruei ecid= 649d46b0ef2a475a:d6e5334:14077999955:-8000-0000000000000259:_adfStreaming ...[TRACE]...[SRC_METHOD: logUserActivity] Received useractivity with requestobject to ruei ecid=weblogic.servlet.internal.RequestEventsFilter$EventsRequestWrapper ...[TRACE]...[SRC_METHOD: process] 9 items for http://<your ruei host:port>/ruei/receive.php ......
該当するログ・エントリが見つからない場合は、この章で説明している手順を繰り返します。