このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索の URL を出力します。
このスクリプトは e-docs マニュアルで必要なバナーを出力します。
このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索のパラメータを出力します。
このスクリプトは e-docs マニュアルで必要な製品のブレッドクラムを出力します。
>
管理ガイド > 監査情報およびログ情報の操作
管理ガイド
アプリケーションのモニタ 」を参照してください。
注意 : 監査は、エンジンが呼び出されて監査オプションが有効化されていると生じます。 タイムスタンプなどの収集されたデータにより、特定のクエリ演算と監査情報を照合できます。
図 9-1 ) により、AquaLogic Data Services Platform XQuery エンジン解析、更新、デプロイメント、および再コンフィグレーション イベント監査に含めるプロパティを選択できるページが開かれます。 監査は、パラメータや例外など、クエリの個々の局面について、有効化または無効化できます。 また、本質的に監査プロセスのすべての局面に適用される、いくつかのグローバル監査オプションもあります。
注意 : デフォルトでは、監査レポート生成ユーティリティは無効化されています。 初めてレポートを生成する際には、その前に後続の節で説明する監査設定を指定する必要があります。 監査が有効化されていると、監査レベルおよび監査されているプロパティの数に応じて、パフォーマンスに影響が及ぶことがあります。
表 9-1 で、使用可能なグローバル監査オプションについて説明します。 AquaLogic Data Services Platform Console でそれぞれのチェック ボックスをクリックし、必要な監査オプションを選択および実装します。
注意 : 監査が有効化されていると、監査レベルおよび追跡されている項目の数に応じて、パフォーマンスにある程度の影響が及ぶことがある。
クエリ評価中に、監査をアクティブにするかどうかを決定する。
アプリケーションのデプロイメント、コンフィグレーション変更など、管理操作中に監査をアクティブにするかどうかを決定する。
更新操作中に、監査をアクティブにするかどうかを決定する。
監査プロセスによって取り込まれた情報のレベルを決定する。 詳細については「
監査の重大度 」を参照。
イベントを同期的に処理するか、非同期的に処理するかを決定する。
監査情報を、アプリケーション サーバ ログ ファイルに含めるかどうかを決定する。
注意 : このオプション (ロギング) を有効化する場合は、確実に [全般] タブの [ロギング] の値を、[Info] または [Debug] に設定する。 それ以外の値にすると、ログ ファイルはまったく情報を受け付けなくなる。
表 9-2 に示しています。 また、個々のプロパティ レベルで監査設定を行うこともできます。詳細については、表 9-3 に示しています。
このチェック ボックスをクリックすると、プロパティ固有の監査情報は確実にクライアント API に返される。
このドロップダウン リストには、すべてのプロパティに対する全般的なオプションが 3 つある。 このオプションとは、[At Default Level]、[Always]、および [Never] である。 [At Default Level] を選択すると、個々のプロパティすべてのレベルが、あらかじめ決定されたデフォルトのレベルに設定される。
注意 : 個々の監査プロパティ設定を指定および適用後は、個々のプロパティに対して加えるすべての変更が、そのプロパティのみに対する初期設定をオーバーライドする。
表 9-3 に、個々のプロパティのそれぞれに対して設定できる監査レベルを示します。 この表に示すレベルはどれも、すべてのプロパティに適用できるわけではありません。 通常、各プロパティには、選択できるレベルが 3 つしかありません。
この設定では、プロパティの監査情報は常に収集される。
この設定では、プロパティの監査情報は常に無視される。
この設定では、グローバルしきい値レベルが [
Information ] 以下の場合に、監査情報が収集される。
この設定では、グローバルしきい値レベルが [
Warning ] 以下の場合に、監査情報が収集される。
この設定では、グローバルしきい値レベルが [
Failure ] 以下の場合に、監査情報が収集される。
この設定では、グローバルしきい値レベルが [
Debug ] の場合に、監査情報が収集される。
デプロイされたアクセス制御リソースの通知を記録する。 次に例を示す。
notification: jmx.attribute.change
クエリ プランがフラッシュされた場合に通知する。 次に例を示す。
AquaLogic Data Services Platform Console で変更されたプロパティのすべてのインスタンスを記録する。 次に例を示す。
notification: jmx.attribute.change
デプロイされたアプリケーションの名前を記録する。 次に例を示す。
デプロイされたアプリケーションの名前を記録する。 次に例を示す。
イベントまたは処理の種類を記録する。クエリ、更新などが考えられる。 次に例を示す。
ユーザが所属するグループを記録する。 次に例を示す。
principals:
アプリケーション サーバのユニークな ID を記録する。次に例を示す。
例外メッセージが発生した場合に、それを記録する。 次に例を示す。
exception:
イベントまたは操作についてのユニークなトランザクション ID を記録する。
データ サービス、アプリケーション、送信など、使用されるリソースの種類を記録する。 次に例を示す。
リソース識別子に対する要求を記録する。 次に例を示す。
resource: <ld type="function"><app>RTLApp</app><ds>ld:DataServices/CustomerDB/ADDRESS.ds</ds><res>{ld:DataServices/CustomerDB/ADDRESS}ADDRESS:0</res></ld>
アプリケーションに対するセキュリティ アクセス設定を記録する。次に例を示す。
JDBC ドライバのサーバ サイドの next () メソッドに対する呼び出しの日付と時間を記録する。
結果の次のブロックを計算するために必要な継続期間または時間をミリ秒単位で記録する。
返されるシリアライズされたデータ ブロックのサイズを、バイト単位で記録する。
監査イベントを完了させるのにかかる時間を、ミリ秒単位で記録する。 監査の開始から完了までの時間差を計算する。 次に例を示す。
監査イベントが開始された時間を記録する。次に例を示す。
timestamp: Tue Feb 14 09:21:02 IST 2006
注意 : ストリーミング API を使用している場合、または RequestConfig.OUTPUT_FILENAME 機能を使用している場合、クエリ結果は非常に大きくなると想定されるため、監査されません。 つまり、監査プロバイダにディスパッチされる AuditEvent と、クライアントに返される DataServiceAudit には、管理プロパティのクエリ/サービス/結果に関する値が含まれません。
クエリに渡された外部パラメータまたは変数を記録する。
ブール値で、
TRUE はデータが現在のデータ ソースからのものであることを示し、
FALSE はキャッシュからのものであることを示す。
クエリ キャッシュが更新されるまでの残り時間を秒単位で示す。
データがクエリ キャッシュから取得されたものであるかどうかを示す。
注意 : queryplan 監査プロパティは、関数が Workshop のテスト ビュー から実行された場合には、収集されない。 これは、関数キャッシュが、テスト ビュー で実行された関数に対しては利用されないからである。
クエリ プラン キャッシュが見つかったかどうかを示す。
クエリ プラン キャッシュが挿入されたかどうかを示す。
フェイルオーバ発生時に、その原因となった例外を記録する。
fn:bea:timeout、
fn:bea:fail-over のいずれかであり得る関数名を記録する。 例えば、次のように指定します。
function: {http://www.bea.com/xquery/xquery-fncts}timeout-with-lbl
ユーザ定義のラベルがある場合は、それを記録する。 次に例を示す。
関数呼び出しのソース カラムを記録する。 次に例を示す。
関数呼び出しのソース ファイルを記録する。 次に例を示す。
関数呼び出しのソース行を記録する。 次に例を示す。
超過されたタイムアウトが適用される場合は、それを記録する。 次に例を示す。
注意 : function 監査プロパティは、監査対象としてデータ サービスの個々の関数が選択されている場合にのみ収集される。 詳細については、「関数を監査する 」を参照。
name: {ld:DataServices/CustomerDB/CUSTOMER}getCustomer
監査される関数を通じて渡されるパラメータを記録する。 次に例を示す。
監査される関数を実行した後の結果を記録する。 次に例を示す。
クエリのコンパイル時間を、ミリ秒単位で記録する。 次に例を示す。
クエリの評価時間を、ミリ秒単位で記録する。 次に例を示す。
dataservice: ld:DataServices/RTLServices/ApplOrder.ds
データ サービスの関数名を記録する。次に例を示す。
クエリを通じて渡されるパラメータを記録する。次に例を示す。
データ サービスに対して実行されるクエリのテキスト全文を記録する。次に例を示す。
query:
ORDER_10_0
呼び出された関数が、File データ ソースを通じて作成されたデータ サービスに属するものである場合に、例外が発生したらそれを記録する。 次に例を示す。
exception: com.bea.ld.wrappers.df.exceptions.DFException: {bea-err}DF0004: [ld:DataServices/Demo/Valuation.csv]: Expected end of line at (row:2, column:3).
name: ld:DataServices/Demo/Valuation.csv
クエリにかかる時間を、ミリ秒単位で記録する。 次に例を示す。
呼び出された関数が、Java クラスを通じて作成されたデータ サービスに属するものである場合に、例外が発生したらそれを記録する。 次に例を示す。
exception: {ld:DataServices/Demo/Java/Physical/PRODUCTS}getFirstProduct:0, line 4, column 5: {bea-err}JFW0401: Class or Method not found exception : {ld:DataServices/Demo/Java/Physical/PRODUCTS}getFirstProduct
サービスの名前を記録する。 これは、例外プロパティが追加された場合には必ず記録される。 次に例を示す。
name: public static int Demo.Java.JavaSource4West.echoInt(int)
サービスに渡される外部パラメータを記録する。 次に例を示す。
実行されたクエリの結果を記録する。 次に例を示す。
クエリの実行にかかる時間を、ミリ秒単位で記録する。 次に例を示す。
呼び出された関数が、ストアド プロシージャを通じて作成されたデータ サービスに属するものである場合に、例外が発生したらそれを記録する。 次に例を示す。
exception: weblogic.xml.query.exceptions.XQueryDynException:
プロシージャ識別子を記録する。 これは、例外プロパティが追加された場合には必ず記録される。 次に例を示す。
name: WIRELESS.SIDEEFFECT_REG_PACKAGE.READ2
データ サービス メソッドに渡される外部パラメータを記録する。 次に例を示す。
parameters: s 2.2 22.0 ss
プロシージャの実行後に返される行数を記録する。次に例を示す。
プロシージャの実行にかかる時間を、ミリ秒単位で記録する。 次に例を示す。
リレーショナル データベースのクエリ例外が発生した場合は、それを記録する。 次に例を示す。
exception: com.bea.ld.wrappers.rdb.exceptions.RDBWrapperException:...
データ サービス メソッドに渡される外部パラメータを記録する。次に例を示す。
parameters:
リレーショナル データベースから返される行数を記録する。次に例を示す。
データベース ソース名を記録する。 これは、例外プロパティが追加された場合には必ず記録される。 次に例を示す。
クエリに使用される SQL 文を記録する。次に例を示す。
sql:
クエリの実行に消費した時間を、ミリ秒単位で記録する。 次に例を示す。
呼び出された関数が、Web サービスを通じて作成されたデータ サービスに属するものである場合に、例外が発生したらそれを記録する。 次に例を示す。
exception: {bea-err}WSW0101: Unable to create Call : {ld:DataServices/ElectronicsWS/getCustomerOrderResponse}getCustomerOrder
実行されるデータ サービス メソッドを記録する。 次に例を示す。
operation: getCustomerOrder
データ サービス メソッドに渡されるパラメータを記録する。 次に例を示す。
parameters: <ns0:getCustomerOrder xmlns:ns0="http://www.openuri.org/">
クエリ実行後に返される結果を記録する。 次に例を示す。
result: <ns:getCustomerOrderResponse xmlns:ns="http://www.openuri.org/">
クエリの実行に消費した時間を、ミリ秒単位で記録する。 次に例を示す。
Web サービスの説明を記録する。 次に例を示す。
wsdl: http://localhost:7001/ElWS/cntrls/ElDBTest.jws?WSDL
Never ] に設定し、その後、下に示すように [監査を有効化 ] チェック ボックスを選択して個々の関数に対する監査を有効化します。
間接呼び出しの監査を有効化 ] チェック ボックスが選択されていると、他のデータ サービスから発生した呼び出しもまた、すべて監査されます。
注意 : 間接呼び出しの監査を有効化すると、その関数に対するクエリの最適化が無効になり、パフォーマンスが低下することがあります。
リレーショナル データベースの更新中に渡されたパラメータを記録する。
正常に完了した際に、リレーショナル データベース内の更新された行数を記録する。
データ ソース名を記録する。 これは、例外プロパティが追加された場合には必ず記録される。
リレーショナル データベースの更新中に使用される SQL 文を記録する。
リレーショナル データベースの更新にかかった時間をミリ秒単位で記録する。
更新のために送信された最上位 SDO の数を記録する。
更新にかかった実行時間の合計をミリ秒単位で記録する。
どの監査プロパティも、以下の監査レベルのいずれか 1 つに設定される。
[Always]。 この設定は、デフォルトの監査レベルをオーバーライドするが、グローバルな有効化/無効化の設定はオーバーライドしない。 [Default]。 グローバルなデフォルトの重大度設定に準拠する。 [Never]。 グローバルなデフォルトの重大度設定を無視する。 一部のエラーおよび失敗の場合には、プロパティ動作の監査が、監査レベルの設定に反して報告されたり無視されたりすることがある。
特定のプロパティが、クライアント アプリケーションに戻ることを許可されるかどうかを決定する。
これは多くの場合、「詳細な」設定として言及される。 監査レポートに追加できるすべての監査プロパティが収集される。
Information 以上の条件のプロパティが、監査レポート用に収集される。
Warning 以上の条件のプロパティが、監査レポート用に収集される。
Error 以上の条件のプロパティが、監査レポート用に収集される。
weblogic.security.spi.AuditEvent インタフェースのインスタンスとして、WebLogic Server セキュリティ フレームワークに送信されます。表 9-10 で、各イベントについて説明します。
イベントの種類を返す。この場合は、
DSPaudit。
表 9-11 で説明するインタフェースを追加します。
com.bea.ld.DSPAuditRecord のリストとしてすべてのレコードを返す。
getRecords(String recordType)
com.bea.ld.DSPAuditRecord のリストとして特定の種類のレコードを返す。
getProperty(String propertyId)
複数のレコード間にわたる、特定プロパティのすべての値を返す。
AquaLogic Data Services Platform アプリケーション識別子を返す。
アプリケーション サーバ ユーザのユーザ名を返す。
イベントの種類 (
EVALUATION_EVENT、
CONFIGURATION_EVENT、または
UPDATE_EVENT) を返す。
イベントのバージョンを返す。たとえば、ALDSP 2.1 の場合は
2.1。
表 9-12 に示すインタフェースがあります。
レコードの種類を返す。たとえば、common/time/duration。
レコード内のすべてのプロパティを返す。 String 識別子から Object 値にマップする。
注意 : ストリーミング API を使用する場合、監査は返された XMLInputStream の close( ) メソッドが呼び出されるまで完了しません。 つまり、close( ) メソッドが呼び出されるまでは、サーバによって AuditEvent が監査プロバイダにディスパッチされず、RequestConfig.getDataServiceAudit() メソッドは null を返します。
RequestConfig requestCfg = new RequestConfig();
CUSTOMERDocument [] custDocRoot1 = (CUSTOMERDocument [])custDS.invoke("getCustomer", params, requestCfg);
表 9-13 で説明します。
クエリ実行情報をログに記録する、JDBC データ ソース内のテーブルの名前。
ソース アクセス情報をログに記録する、JDBC データ ソース内のテーブルの名前。
集約された情報 (概要) をログに記録する、JDBC データ ソース内のテーブルの名前。
内部イベントバッファのサイズ。 プロファイラがイベントの処理を開始する前に、バッファに格納されるイベント数を決定する。
[Collect Execution Aggregate]
個々のクエリ実行の集約 (関数による) をメモリに格納する。最終的には、それをデータベースに書き込む。
集約がデータベースに書き込まれる前に、プロファイラによって処理されるイベント数。 デフォルト値は 10。
[Collect Execution Detail]
クエリの実行ごとに、クエリ内のソース アクセスの集約を含む行を、データベースに書き込む。 アプリケーション開発環境において有用である。
クエリ内のすべてのソース アクセスについて、データベースに行を書き込む。 このパラメータを有効にするには、[Collect Execution Detail] をコンフィグレーションする必要がある。
表 9-13 パフォーマンス プロファイリング用のコンフィグレーション パラメータ profiler.zip があります。 この zip ファイルには、次のファイルが格納されています。
README.txt - サンプル監査プロバイダの使用手順が記載されています。 dsp_profile.sql ファイル - テーブル定義が含まれています。 build.xml - ビルドのコンフィグレーションを定義します。 DSPProfilerMBean.xml - AquaLogic Data Services Platform プロファイリング監査プロバイダ用の MBean 定義ファイルです。 DSPProfilerImpl.java - weblogic.security.spi.AuditProvider インタフェースおよび weblogic.security.spi.AuditChannel インタフェースを実装するサンプル Java コードです。
http://edocs.beasys.co.jp/e-docs/wls/docs81/logging/viewing.html
アプリケーションの全般的な設定 」を参照してください。 ログ レベルには、次のものがあります。
[Error]。 実行時例外。 [Notice]。 予想される、実行時操作に影響しないエラーおよびエラー レベル イベント。 [Information]。 開始/停止イベント、失敗したアクセス試行、クエリ実行時間などと、Error および Notice レベルのイベント。
http://edocs.beasys.co.jp/e-docs/wls/docs81/logging/use_log.html
WebLogic Server ドメインのモニタ
WebLogic Server アプリケーションのチューニング 関連情報 : パフォーマンス ツールと情報
