このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索の URL を出力します。
このスクリプトでは、e-docs マニュアルに必要なバナーを出力します。
このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索のパラメータを出力します。
このスクリプトでは、e-docs マニュアルに必要な製品のブレッドクラムを出力します。
>
管理ガイド > 監査情報およびログ情報の操作
管理ガイド
注意 : 監査は、エンジンが呼び出されて監査オプションが有効化されていると生じます。タイムスタンプなどの収集されたデータにより、特定のクエリ演算と監査情報を照合できます。
図 9-1 に示すように、[システム管理] カテゴリを選択して [監査] タブを選択します。
注意 : 監査が有効化されていると、監査レベルおよび監査されているプロパティの数に応じて、パフォーマンスに影響が及ぶことがあります。
表 9-1 で、使用可能なグローバル監査オプションについて説明します。ALDSP Console でそれぞれのチェック ボックスをクリックし、必要な監査オプションを実装します。
注意 : 監査が有効化されていると、監査レベルおよび追跡されている項目の数に応じて、パフォーマンスにある程度の影響が及ぶことがある。
クエリ評価中に、監査をアクティブにするかどうかを決定する。
データスペースのデプロイメントおよびコンフィグレーション中に監査データを収集する。
更新操作中に、監査をアクティブにするかどうかを決定する。
監査プロセスによって取り込まれた情報のレベルを決定する。詳細については「
監査の重大度 」を参照。
イベントを同期的に処理するか、非同期的に処理するかを決定する。
監査情報を、アプリケーション サーバ ログ ファイルに含めるかどうかを決定する。
注意 : このオプション (ロギング) を有効化する場合は、確実に [全般] タブの [ロギング] の値を、[Info] または [Debug] に設定する。それ以外の値にすると、ログ ファイルはまったく情報を受け付けなくなる。
各新レコードの場合、その監査レコードが部分的にディスパッチされるかまたは完全にディスパッチされるかを決定する。
図 9-1 ) を使用して重大度を設定します。重大度は、WebLogic Server セキュリティで提供されているものと類似しています。WebLogic Server の詳細については、「メッセージの重大度
ALDSP 監査の重大度
これは多くの場合、「詳細な」設定として言及される。監査レポートに追加できるすべての監査プロパティが収集される。
Information 以上の条件のプロパティが、監査レポート用に収集される。
Warning 以上の条件のプロパティが、監査レポート用に収集される。
Error 以上の条件のプロパティが、監査レポート用に収集される。
図 9-2 に示すように、[監査プロパティ] タブをクリックします。
注意 : [デフォルト設定] をクリックして、監査プロパティをデフォルト値に再配置します。
表 9-3 に、個々のプロパティのそれぞれに対して設定できる監査レベルを示します。この表に示すレベルはどれも、すべてのプロパティに適用できるわけではありません。通常、各プロパティには、選択できるレベルが 3 つしかありません。
注意 : プロパティ固有の監査情報はクライアントに返される場合、[クライアントが使用できる] チェックボックスを選択します。
この設定では、プロパティの監査情報は常に収集される。
この設定では、プロパティの監査情報は常に無視される。
この設定によって、プロパティがデフォルト レベルでコンフィグレーションされます。
注意 : このオプションは、[すべてのプロパティを選択] 監査プロパティの場合のみ利用可能です。
この設定では、グローバルしきい値レベルが [
Information ] 以下の場合に、監査情報が収集される。
この設定では、グローバルしきい値レベルが [
Warning ] 以下の場合に、監査情報が収集される。
この設定では、グローバルしきい値レベルが [
Failure ] 以下の場合に、監査情報が収集される。
この設定では、グローバルしきい値レベルが [
Debug ] の場合に、監査情報が収集される。
注意 : 個々の監査プロパティ設定を指定および適用後は、個々のプロパティに対して加えるすべての変更が、そのプロパティのみに対する初期設定をオーバーライドする。
デプロイされたアクセス制御リソースの通知を記録する。次に例を示す。
notification: jmx.attribute.change
ALDSP Console で変更されたプロパティのすべてのインスタンスを記録する。次に例を示す。
notification: jmx.attribute.change
注意 : この情報はデフォルトでは監査ログに表示されます。このプロパティに対する監査レベルは変更できません。
データスペースに対して行われた作成、変更および削除操作を記録する。
最後のコンフィグレーション更新以降の変更を記録する。
イベントまたは処理の種類を記録する。クエリ、更新などが考えられる。次に例を示す。
例外メッセージが発生した場合に、それを記録する。次に例を示す。
exception:
デプロイされたアプリケーションの名前を記録する。次に例を示す。
ユーザが所属するグループを記録する。次に例を示す。
principals:
アプリケーション サーバのユニークな ID を記録する。次に例を示す。
イベントまたは操作についてのユニークなトランザクション 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 監査プロパティは、関数がテスト ビューから実行された場合には、収集されない。これは、関数キャッシュが、テスト ビューで実行された関数に対しては利用されないからである。
True でありクエリ プランがフラッシュされた場合設定される。
クエリ プラン キャッシュが見つかったかどうかを示す。
クエリ プラン キャッシュが挿入されたかどうかを示す。
XQUERY_PLAN_CACHE、SQL_PLAN_CACHE、または STORED_PROC_CACHE.などのクエリ プランの種類を示します。
フェイルオーバ発生時に、その原因となった例外を記録する。
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
SQL プロシージャに関連付けられるパラメータを記録する。
呼び出された関数が、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:
置換される 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/">
クエリの実行に消費した時間を、ミリ秒単位で記録する。次に例を示す。
wsdl: http://localhost:7001/ElWS/cntrls/ElDBTest.jws?WSDL
更新例外の tostring() の値を記録する。
データスペース監査の更新エラーの例外オブジェクトを記録する。
この更新によって実行されたプロシージャのステータス。
監査されるプロシージャに渡されるパラメータを記録する。
リレーショナル データベースの更新中に渡されたパラメータを記録する。
正常に完了した際に、リレーショナル データベース内の更新された行数を記録する。
データ ソース名を記録する。これは、例外プロパティが追加された場合には必ず記録される。
リレーショナル データベースの更新中に使用される SQL 文を記録する。
リレーショナル データベースの更新にかかった時間をミリ秒単位で記録する。
呼び出された関数に関連付けられる引数の数を記録する。
データ サービスの完全修飾プロシージャ名を記録する。
更新のために送信された最上位 SDO の数を記録する。
更新にかかった実行時間の合計をミリ秒単位で記録する。
NEVER に設定し、その後、個々の関数に対する監査を有効化します。そのためには、次の手順に従います。
図 9-3 に示すように、[監査] タブを選択します。
間接呼び出しの監査を有効化 ] チェック ボックスが選択されていると、他のデータ サービスから発生した呼び出しもまた、すべて監査されます。
注意 : 間接呼び出しの監査を有効化すると、その関数に対するクエリの最適化が無効になり、パフォーマンスが低下することがあります。
weblogic.security.spi.AuditEvent インタフェースのインスタンスとして、WebLogic Server セキュリティ フレームワークに送信されます。表 9-8 で、各イベントについて説明します。
イベントの種類を返す。この場合は、
DSPaudit。
表 9-9 で説明するインタフェースを追加します。
com.bea.ld.DSPAuditRecord のリストとしてすべてのレコードを返す。
getRecords(String recordType)
com.bea.ld.DSPAuditRecord のリストとして特定の種類のレコードを返す。
getProperty(String propertyId)
複数のレコード間にわたる、特定プロパティのすべての値を返す。
アプリケーション サーバ ユーザのユーザ名を返す。
イベントの種類 (
EVALUATION_EVENT、
CONFIGURATION_EVENT、または
UPDATE_EVENT) を返す。
イベントのバージョンを返す。たとえば、ALDSP 2.1 の場合は
2.1。
表 9-10 に示すインタフェースがあります。
レコードの種類を返す。たとえば、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-11 で説明します。
クエリ実行情報をログに記録する、JDBC データ ソース内のテーブルの名前。
ソース アクセス情報をログに記録する、JDBC データ ソース内のテーブルの名前。
集約された情報 (概要) をログに記録する、JDBC データ ソース内のテーブルの名前。
内部イベント バッファのサイズ。プロファイラがイベントの処理を開始する前に、バッファに格納されるイベント数を決定する。
[Collect Execution Aggregate]
個々のクエリ実行の集約 (関数による) をメモリに格納する。最終的には、それをデータベースに書き込む。
集約がデータベースに書き込まれる前に、プロファイラによって処理されるイベント数。デフォルト値は 10。
[Collect Execution Detail]
クエリの実行ごとに、クエリ内のソース アクセスの集約を含む行を、データベースに書き込む。アプリケーション開発環境において有用である。
クエリ内のすべてのソース アクセスについて、データベースに行を書き込む。このパラメータを有効にするには、[Collect Execution Detail] をコンフィグレーションする必要がある。
表 9-11 パフォーマンス プロファイリング用のコンフィグレーション パラメータ profiler.zip があります。この zip ファイルには、次のファイルが格納されています。
README.txt - サンプル監査プロバイダの使用手順が記載されています。 dsp_profile.sql ファイル - テーブル定義が含まれています。 build.xml - ビルドのコンフィグレーションを定義します。 DSPProfilerMBean.xml - ALDSP プロファイリング監査用の MBean 定義ファイルです。 DSPProfilerImpl.java - weblogic.security.spi.AuditProvider インタフェースおよび weblogic.security.spi.AuditChannel インタフェースを実装するサンプル Java コードです。
WebLogic Server ログの表示
データスペースのキャッシュおよびログをコンフィグレーションする 」を参照してください。ログ レベルには、次のものがあります。
[Error]。 実行時例外。 [Notice]。 予想される、実行時操作に影響しないエラーおよびエラー レベル イベント。 [Information]。 開始/停止イベント、失敗したアクセス試行、クエリ実行時間などと、Error および Notice レベルのイベント。 WebLogic Server ロギング サービスの使い方
WebLogic Server ドメインのモニタ
WebLogic Server アプリケーションのチューニング 関連情報 : パフォーマンス ツールと情報
![[監査プロパティ] タブ](wwimages/auditprop_new1.gif)
