Oracle Web Cacheのロギング機能を使用すると、Oracle Web Cacheおよび関連プロセスの実行中および使用中に発生した問題をトラブルシューティングすることができます。
この章の項目は次のとおりです。
Oracle Web Cacheは、イベントとエラーの情報をイベント・ログに記録します。イベント・ログ・エントリは、キャッシュに格納されたオブジェクトの判別に役立つとともに、キャッシュに関するすべての問題を通知します。デフォルトでは、Oracle Web Cacheは各リクエストに関連付けられている、メモリー内のすべてのイベント・ログ・メッセージを収集します。リクエストの最も重大なメッセージが、選択されている冗長性レベルと同じかそれ以上の場合、Oracle Web Cacheはそのリクエストに関連するすべてのメッセージをイベント・ログに一度に書き込みます。診断が容易なように、1つのリクエストに対するメッセージがグループ化されログ・ファイル内に集められます。
イベント・ログのデフォルトのファイル名は、Oracle Web Cache形式およびOracle Diagnostic Logging(ODL)Text形式ではevent_log
となり、ODL XML形式ではlog.xml
となります。Oracle Web Cacheは、ログ・ファイルを次のディレクトリに格納します。
(UNIX) ORACLE_INSTANCE/diagnostics/logs/WebCache/<webcache_name> (Windows) ORACLE_INSTANCE\diagnostics\logs\WebCache\<webcache_name>
この項では、次の項目について説明します。
イベント・ログの設定を構成するときに、次のロギング形式を選択します。
Oracle Diagnostic Logging(ODL)形式は、すべての診断メッセージとログ・ファイルの共通形式であり、Oracle Fusion Middlewareの様々なコンポーネントの診断メッセージを関係付けるメカニズムです。
ODL Textを選択するとテキスト・ファイルを作成でき、ODL XMLを選択するとXMLファイルを作成できます。
ODL Textの形式は次のとおりです。
[TSTZ_ORIGINATING] [MSG_TYPE:MSG_ID] [MODULE_ID;MSG_LEVEL] [MODULE_ID] [ECID] MSG_TEXT
表9-4に、ODL Text形式の各フィールドを示します。
表9-1 ODL Textのメッセージ・フィールド
フィールド | 説明 |
---|---|
|
メッセージが生成された日付と時刻。時間は、ローカル・タイムまたはグリニッジ標準時のいずれかで表示されます。 |
|
メッセージのタイプ。可能な値はNOTIFICATION、WARNING、TRACEおよびDEBUGです。 |
|
メッセージ・レベルは、メッセージ・タイプを限定する整数値で示されます。使用可能な値は1(最高重大度)から32(最低重大度)です。 |
|
コンポーネント内でメッセージを一意に識別するID。コンポーネントを表す接頭辞、ダッシュおよび5桁の数字で構成されます。例: メッセージの詳細は、Oracle Fusion Middlewareのエラー・メッセージ・リファレンスを参照してください。 |
|
メッセージを送信したモジュールのID。コンポーネントが単一のモジュールである場合は、この属性にコンポーネントIDが示されます。 |
|
実行コンテキストID(ECID)。生成コンポーネントが関与する特定のリクエストの実行のグローバル一意識別子。ECIDは、別のコンポーネントで発生したエラー・メッセージの関連付けに使用できます。 関連項目: |
|
エラー・メッセージのテキスト。 |
次に、ODL Text形式が含まれているイベント・ログの抜粋を示します。
[2008-11-04T05:55:35-05:00] [webcache] [NOTIFICATION:1] [WXE-08513] [logging] [ecid: ] Cache server process ID 11679 is starting up. [2008-11-04T05:55:35-05:00] [webcache] [NOTIFICATION:1] [WXE-09612] [main] [ecid: ] Oracle Web Cache 11g (11.1.1) [2008-11-04T05:55:35-05:00] [webcache] [NOTIFICATION:1] [WXE-13002] [config] [ecid: ] Maximum allowed incoming connections are 700 [2008-11-04T05:55:35-05:00] [webcache] [NOTIFICATION:1] [WXE-09446] [stats] [ecid: ] Statistics initialization commencing. [2008-11-04T05:55:35-05:00] [webcache] [NOTIFICATION:1] [WXE-09441] [stats] [ecid: ] DMS enabled [2008-11-04T05:55:35-05:00] [webcache] [NOTIFICATION:1] [WXE-09447] [stats] [ecid: ] Statistics initialization complete. [2008-11-04T05:55:36-05:00] [webcache] [NOTIFICATION:1] [WXE-12209] [cluster] [ecid: ] A 1 node cluster successfully initialized [2008-11-04T05:55:36-05:00] [webcache] [NOTIFICATION:1] [WXE-09614] [main] [ecid: ] The following Oracle Web Cache internal files are pre-populated to the cache: [[/host:port/_oracle_http_server_webcache_static_.html]]
表9-2に、ODL XML形式の各フィールドを示します。
表9-2 ODL XMLのメッセージ・フィールド
フィールド | 説明 |
---|---|
|
メッセージが生成された日付と時刻。時間は、ローカル・タイムまたはグリニッジ標準時のいずれかで表示されます。 |
|
メッセージの発生元コンポーネントのID。 |
|
コンポーネント内でメッセージを一意に識別するID。コンポーネントを表す接頭辞、ダッシュおよび5桁の数字で構成されます。例: |
|
メッセージのタイプ。可能な値はNOTIFICATION、WARNING、TRACEおよびDEBUGです。 |
|
メッセージ・レベルは、メッセージ・タイプを限定する整数値で示されます。使用可能な値は1(最高重大度)から32(最低重大度)です。 |
|
メッセージの発生元ホストの名前。 |
|
メッセージの発生元ホストのネットワーク・アドレス。 |
|
メッセージを送信したモジュールのID。コンポーネントが単一のモジュールである場合は、この属性にコンポーネントIDが示されます。 |
|
実行コンテキストID(ECID)。生成コンポーネントが関与する特定のリクエストの実行のグローバル一意識別子。ECIDは、別のコンポーネントで発生したエラー・メッセージの関連付けに使用できます。 関連項目: |
|
エラー・メッセージのテキスト。 |
ODL XML形式にはほかにもフィールドがあります。次に、ODL XML形式のイベント・ログの抜粋を示します。
<MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.0116-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>8513</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>logging</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>Cache server process ID 13176 is starting up. </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.0117-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>9612</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>main</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>Oracle Web Cache 11g (11.1.1) </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.0118-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>13002</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>config</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>Maximum allowed incoming connections are 700 </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.0191-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>9446</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>stats</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>Statistics initialization commencing. </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.0265-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>9438</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>stats</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>The statistics persistent repository is being reset by new configuration </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.1556-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>9441</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>stats</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>DMS enabled </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.1559-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>9447</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>stats</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>Statistics initialization complete. </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:14.5912-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>12209</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>cluster</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>A 1 node cluster successfully initialized </MSG_TEXT> </PAYLOAD> </MESSAGE> <MESSAGE> <HEADER> <TSTZ_ORIGINATING>2008-11-04T06:07:20.8036-05:00</TSTZ_ORIGINATING> <COMPONENT_ID>WXE</COMPONENT_ID> <MSG_ID>9614</MSG_ID> <MSG_TYPE TYPE="NOTIFICATION"></MSG_TYPE> <MSG_LEVEL>1</MSG_LEVEL> <HOST_ID>host</HOST_ID> <HOST_NWADDR>10.10.150.35</HOST_NWADDR> <MODULE_ID>main</MODULE_ID> </HEADER> <CORRELATION_DATA> <EXEC_CONTEXT_ID> <UNIQUE_ID>-</UNIQUE_ID> <SEQ>0</SEQ> </EXEC_CONTEXT_ID> </CORRELATION_DATA> <PAYLOAD> <MSG_TEXT>The following Oracle Web Cache internal files are pre-populated to the cache: [[/host:port/_oracle_http_server_webcache_static_.html]] </MSG_TEXT> </PAYLOAD></MESSAGE>
ODL形式の詳細は、次を参照してください。
ODLメッセージおよびODLログ・ファイルの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。
ログ・ファイルに書き込まれる情報量の構成については、『Oracle Fusion Middleware管理者ガイド』を参照してください。
Oracle Web Cacheログ形式は、これまでのOracle Web Cacheのリリースで提供されていた従来のログ形式を必要とする顧客向けです。
Oracle Web Cacheの形式は次のとおりです。
[TIMESTAMP] [MSG_TYPE MSG_ID] [ECID] MSG_TEXT
表9-3に、Oracle Web Cache形式の各フィールドを示します。
表9-3 Oracle Web Cacheのメッセージ・フィールド
フィールド | 説明 |
---|---|
|
メッセージが生成された日付と時刻。時間は、ローカル・タイムまたはグリニッジ標準時のいずれかで表示されます。 |
|
メッセージのタイプ。可能な値はNOTIFICATION、WARNING、TRACEおよびDEBUGです。 |
|
コンポーネント内でメッセージを一意に識別するID。IDは5桁の数字で構成されます。例: |
|
実行コンテキストID(ECID)。生成コンポーネントが関与する特定のリクエストの実行のグローバル一意識別子。ECIDは、別のコンポーネントで発生したエラー・メッセージの関連付けに使用できます。 関連項目: |
|
エラー・メッセージのテキスト。 |
次に例を示します。
[04/Nov/2008:06:11:53 -0500] [notification 08513] Cache server process ID 13466is starting up. [04/Nov/2008:06:11:53 -0500] [notification 09612] [ecid: -] Oracle Web Cache 11g (11.1.1) [04/Nov/2008:06:11:53 -0500] [notification 13002] [ecid: -] Maximum allowed incoming connections are 700 [04/Nov/2008:06:11:53 -0500] [notification 09446] [ecid: -] Statistics initialization commencing. [04/Nov/2008:06:11:53 -0500] [notification 09438] [ecid: -] The statistics persistent repository is being reset by new configuration [04/Nov/2008:06:11:53 -0500] [notification 09441] [ecid: -] DMS enabled [04/Nov/2008:06:11:53 -0500] [notification 09447] [ecid: -] Statistics initialization complete. [04/Nov/2008:06:11:54 -0500] [notification 12209] [ecid: -] A 1 node cluster successfully initialized [04/Nov/2008:06:11:54 -0500] [notification 09614] [ecid: -] The following Oracle Web Cache internal files are pre-populated to the cache: [[/host:port/_oracle_http_server_webcache_static_.html]]
イベント・ログ・メッセージで「リクエストの詳細を含む」オプションを有効にすると、Oracle Web Cacheは、メッセージ09720にリクエスト詳細形式を表示します。このメッセージは、リクエストのイベントが初めてログに記録されるときに、クライアントIPアドレス、リクエストのサイト名、リクエストのURLを含む次のリクエスト詳細とともにログに記録されます。
表9-4に、リクエスト詳細形式の各フィールドを示します。
表9-4 リクエスト詳細
フィールド | 説明 |
---|---|
|
リクエスト詳細イベント。 |
|
リクエストを作成したクライアントのIPアドレス。 |
|
リクエストのサイト名。 |
|
リクエストのURL。 |
次に例を示します。
[2008-11-20T23:27:32Z] [webcache] [TRACE:1] [WXE-09720] [io] [ecid: 15431471130,0] [req-info: ] [client: 140.87.8.166] [host: -] [url: /images/image1k.bmp] [2008-11-20T23:27:31Z] [webcache] [TRACE:1] [WXE-11331] [frontend] [ecid: 15431471130,0] Request matches configured site: www.company.com:80 [2008-11-20T23:27:31Z] [webcache] [TRACE:1] [WXE-11414] [population] [ecid: 15431471130,0] Basic cache key is composed with sitename www.company.com:80, URI /images/image1k.bmp, method GET, post body -. [2008-11-20T23:27:31Z] [webcache] [TRACE:1] [WXE-11304] [frontend] [ecid: 15431471130,0] Cache miss request.
リクエストのIPアドレス、サイト名およびURLに加えて、Oracle-ECID
リクエスト・ヘッダーのIDと順序番号がログに記録されます。Oracle-ECID
リクエスト・ヘッダーはリクエストのトラッキングに使用されます。
Oracle-ECID
リクエスト・ヘッダーは、リクエストがOracle Fusion Middlewareアーキテクチャ内を移動するときに、その経由場所をトラッキングするために使用されます。この情報は、特に診断に役立ちます。Oracle Web Cacheは、クライアント・リクエストの最初の受信者であるため、オリジン・サーバーにキャッシュ・ミスを転送する前にリクエスト・ヘッダーを設定します。Oracle-ECID
リクエスト・ヘッダーの形式は次のとおりです。
Oracle-ECID: request_id, sequence_number
この形式のrequest_id
はリクエストに対する64ビットの一意の整数、sequence_number
はOracle Fusion Middlewareを通過するときのリクエストのホップ番号です。Oracle Web Cacheは通常、最初の順序番号0(ゼロ)をリクエストに割り当てます。リクエストがOracle Web CacheからOracle Fusion Middlewareの他のコンポーネントに移るとき、リクエストIDは変わりませんが、順序番号は各ホップで増加します。
Oracle-ECID
リクエスト・ヘッダーのリクエストIDと順序番号をイベント・ログおよびアクセス・ログに記録するようにOracle Web Cacheを構成できます。Oracle-ECID
リクエスト・ヘッダーをイベント・ログに表示するには、「リクエストの詳細を含む」オプションを有効にし、アクセス・ログについてはx-ecid
フィールドを選択します。デフォルトでは、x-ecid
フィールドは拡張CLF(ECLF)、拡張複合ログ形式およびエンド・ユーザー・パフォーマンス監視の形式となります。さらに、Oracle-ECID
リクエスト・ヘッダーの情報をログに記録するようにOracle HTTP Serverを構成すると、同じリクエストに対する様々なOracle Fusion Middlewareの通過場所でのイベントを関連付けることができます。
Oracle Web Cacheでは、Server
レスポンス・ヘッダー・フィールドまたはHTMLレスポンス・ボディに診断情報を表示するように構成した場合も、Oracle-ECID
リクエスト・ヘッダー情報を記録します。
Server
レスポンス・ヘッダー・フィールドの診断出力、またはOracle-ECID
情報が含まれるHTTPレスポンス・メッセージの構成方法の詳細は、第8.8項を参照してください。
この項には、次のイベント・ログの例が含まれます。
次に、起動の失敗のイベントが含まれているイベント・ログの抜粋を示します。ポート7777は使用されているため、Oracle Web Cacheはこのポートをリスニングできません。Oracle Web Cacheが稼働中でそのポートをリスニングしている場合、または別のアプリケーションによってそのポートが使用されている場合に、このエラーが発生する可能性があります。
[2008-11-04T16:37:24-05:00] [webcache] [NOTIFICATION:1] [WXE-08513] [logging] [ecid: ] Cache server process ID 2427 is starting up. [2008-11-04T16:37:24-05:00] [webcache] [NOTIFICATION:1] [WXE-09612] [main] [ecid: ] Oracle Web Cache 11g (11.1.1) [2008-11-04T16:37:24-05:00] [webcache] [NOTIFICATION:1] [WXE-13002] [config] [ecid: ] Maximum allowed incoming connections are 700 [2008-11-04T16:37:24-05:00] [webcache] [NOTIFICATION:1] [WXE-09446] [stats] [ecid: ] Statistics initialization commencing. [2008-11-04T16:37:24-05:00] [webcache] [NOTIFICATION:1] [WXE-09438] [stats] [ecid: ] The statistics persistent repository is being reset by new configuration [2008-11-04T16:37:24-05:00] [webcache] [NOTIFICATION:1] [WXE-09441] [stats] [ecid: ] DMS enabled [2008-11-04T16:37:24-05:00] [webcache] [NOTIFICATION:1] [WXE-09447] [stats] [ecid: ] Statistics initialization complete. [2008-11-04T16:37:25-05:00] [webcache] [TRACE:1] [WXE-11366] [frontend] [ecid: ] A client connection to listening port 7777 is dropped. [2008-11-04T16:37:25-05:00] [webcache] [TRACE:1] [WXE-11380] [frontend] [ecid: ] Network failure during client listen client listen (details: internal=failure system=2) [2008-11-04T16:37:25-05:00] [webcache] [ERROR:1] [WXE-09707] [main] [ecid: ] Failed to start the server. [2008-11-04T16:37:25-05:00] [webcache] [ERROR:1] [WXE-09609] [main] [ecid: ] The server process could not initialize. [2008-11-04T16:37:25-05:00] [webcache] [NOTIFICATION:1] [WXE-09610] [main] [ecid: ] The server is exiting. [2008-11-04T16:37:25-05:00] [webcache] [NOTIFICATION:1] [WXE-08514] [logging] [ecid: ] Cache server process ID 2427 is shutting down.
次に、通常の停止エントリが含まれているイベント・ログの抜粋を示します。
[2008-11-04T16:19:58-05:00] [webcache] [NOTIFICATION:1] [WXE-09703] [main] [ecid: ] Stop Issued. The program will shut down after all accepted requests are served, or a timeout occurs. [2008-11-04T16:21:29-05:00] [webcache] [NOTIFICATION:1] [WXE-09610] [main] [ecid: ] The server is exiting.
次に、キャッシュ・ミス・リクエストのイベントが含まれているイベント・ログの抜粋を示します。
[2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11331] [frontend] [ecid: 5415484202,0] Request matches configured site: www.company.com:80 [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11414] [population] [ecid: 5415484202,0] Basic cache key is composed with sitename www.company.com:80, URI /invalidate1/tcal_fct_invalidate_basic_2.html, method GET, post body -. [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11304] [frontend] [ecid: 5415484202,0] Cache miss request. [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11224] [os] [ecid: 5415484202,0] Site localhost:8888 matches site-to-server mapping www.company.com:80. [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11227] [os] [ecid: 5415484202,0] Initial Request is routed to origin server host-server:8080 using load balancing. [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11403] [population] [ecid: 5415484202,0] begin cacheability decision for url: www.company.com:80/invalidate1/tcal_fct_invalidate_basic_2.html [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11481] [population] [ecid: 5415484202,0] Request/Response matches caching rule with URL expression "^/invalidate1/.*\.h.*$". [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-13736] [compression] [ecid: 5415484202,0] Compression is disabled because the browser does not support compression. [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11446] [population] [ecid: 5415484202,0] URL which will be cached is: www.company.com:80/invalidate1/tcal_fct_invalidate_basic_2.html [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11415] [population] [ecid: 5415484202,0] Final cache key is composed sitename www.company.com:80, URI /invalidate1/tcal_fct_invalidate_basic_2.html, method GET, post body -, multiversion -, compressed no. [2008-11-04T15:37:02-05:00] [webcache] [TRACE:1] [WXE-11088] [backend] [ecid: 5415484202,0] Following URL is now in cache: www.company.com:80/invalidate1/tcal_fct_invalidate_basic_2.html
次に、後続のキャッシュ・ヒット・リクエストのイベントが含まれているイベント・ログの抜粋を示します。
[2008-11-04T15:37:39-05:00] [webcache] [TRACE:1] [WXE-09720] [frontend] [ecid: 417732382502,0] [req-info: ] [client: 127.0.0.1] [host: www.company.com:80] [url: /x-oracle-cache-invalidate] [2008-11-04T15:37:39-05:00] [webcache] [TRACE:1] [WXE-11331] [frontend] [ecid: 417732382502,0] Request matches configured site: localhost:8888 [2008-11-04T15:37:39-05:00] [webcache] [TRACE:1] [WXE-11414] [population] [ecid: 417732382502,0] Basic cache key is composed with sitename www.company.com:80, URI /invalidate1/tcal_fct_invalidate_basic_5.html, method GET, post body -. [2008-11-04T15:37:39-05:00] [webcache] [NOTIFICATION:1] [WXE-11707] [invalidation] [ecid: 417732382502,0] Object with URL '/invalidate1/tcal_fct_invalidate_basic_5.html' is successfully invalidated. [2008-11-04T15:37:39-05:00] [webcache] [NOTIFICATION:1] [WXE-11748] [invalidation] [ecid: 417732382502,0] Invalidation with INFO 'about-ttl' has returned with status 'SUCCESS'; number of objects invalidated: '1'.
次に、オブジェクト/invalidation1/tcal_fct_invalidate_basic_5.html
の削除の無効化リクエストに関連するイベントが含まれているイベント・ログの抜粋を示します。
[2008-11-04T15:37:39-05:00] [webcache] [TRACE:1] [WXE-09720] [frontend] [ecid: 417732382502,0] [req-info: ] [client: 10.10.150.35] [host: host:port] [url: /x-oracle-cache-invalidate] [2008-11-04T15:37:39-05:00] [webcache] [TRACE:1] [WXE-11331] [frontend] [ecid: 417732382502,0] Request matches configured site: www.company.com:80 [2008-11-04T15:37:39-05:00] [webcache] [TRACE:1] [WXE-11414] [population] [ecid: 417732382502,0] Basic cache key is composed with sitename localhost:8888, URI /invalidate1/tcal_fct_invalidate_basic_5.html, method GET, post body -. [2008-11-04T15:37:39-05:00] [webcache] [NOTIFICATION:1] [WXE-11707] [invalidation] [ecid: 417732382502,0] Object with URL '/invalidate1/tcal_fct_invalidate_basic_5.html' is successfully invalidated. [2008-11-04T15:37:39-05:00] [webcache] [NOTIFICATION:1] [WXE-11748] [invalidation] [ecid: 417732382502,0] Invalidation with INFO 'about-ttl' has returned with status 'SUCCESS'; number of objects invalidated: '1'.
次に、キャッシュ・ミスに関するESIフラグメントのイベント・ログ内のメッセージ例を示します。イベント・ログ内のメッセージでは、次の情報がレポートされます。
テンプレートでのOracle Web CacheのESIの処理方法
ESI処理でのESIフラグメントのロード方法
フラグメントのロード後にESIフラグメントに対するキャッシュ・デシジョンが作成される方法。フラグメントをキャッシュするか否かの理由に関する情報も含まれます。
次の例で、TRACE:1
メッセージはverbosity=TRACE
レベル、TRACE:32
メッセージはverbosity=DEBUG
レベルに対応します。verbosity(冗長性)をDEBUG
に設定すると、TRACE
、NOTIFICATION
、WARNING
、ERROR
の各レベルのメッセージが含められます。TRACE
にはNOTIFICATION
、WARNING
、ERROR
が含まれますが、DEBUG
は含まれません。
event_log
の冗長レベルをDEBUG
に設定しないかぎり、次の例のようなログ・メッセージは表示されません。
[2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11952] [esi] [ecid: 211577120190,0] Start processing ESI document www.company.com:80/cgi-bin/esi-headers.sh?/esi/esi-headers.html&localhost:8888, nesting level 1 [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11331] [frontend] [ecid: 211577120190,0] Request matches configured site: www.company.com:80 [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11953] [esi] [ecid: 211577120190,0] In ESI template www.company.com:80/cgi-bin/esi-headers.sh?/esi/esi-headers.html&localhost:8888, the fragment's site name and URL has been discovered as www.company.com:80 and /esi/include0.html [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11304] [frontend] [ecid: 211577120190,0] Cache miss request. [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11224] [os] [ecid: 211577120190,0] Site www.company.com:80 matches site-to-server mapping www.company.com:80. [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11227] [os] [ecid: 211577120190,0] Initial Request is routed to origin server stadk61.us.oracle.com:8080 using load balancing. [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11403] [population] [ecid: 211577120190,0] [[ begin cacheability decision for url: www.company.com:80/esi/include0.html ]] [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11481] [population] [ecid: 211577120190,0] Request/Response matches caching rule with URL expression "/*". [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11446] [population] [ecid: 211577120190,0] [[ URL which will be cached is: www.company.com:80/esi/include0.html ]] [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11415] [population] [ecid: 211577120190,0] Final cache key is composed sitename www.company.com:80, URI /esi/include0.html, method GET, post body -, multiversion -, compressed no. [2008-11-04T16:29:14-05:00] [webcache] [TRACE:1] [WXE-11088] [backend] [ecid: 211577120190,0] [[ Following URL is now in cache: www.company.com:80/esi/include0.html ]]
Oracle Web Cacheは、受信したHTTPリクエストおよびHTTPSリクエストに関する情報をアクセス・ログに記録します。Oracle Web Cacheで定義される各Webサイトは、各自のアクセス・ログを持つことができます。アクセス・ログのデフォルトのファイル名はaccess_log
で、次のディレクトリに格納されます。
(UNIX) ORACLE_INSTANCE/diagnostics/logs/WebCache/<webcache_name> (Windows) ORACLE_INSTANCE\diagnostics\logs\WebCache\<webcache_name>
この項では、次の項目について説明します。
アクセス・ログ・ファイルの内容を構成するには、各HTTPリクエスト・イベントに対して表示されるフィールドを定義します。これらのフィールドは、標準拡張ログ・ファイル形式(XLF)に基づいています。Oracle Web Cacheでは、デフォルトで次のアクセス・ログ形式がサポートされています。
この形式は、アクセス・ログに適用されるデフォルトの形式です。また、多くの構成に対して適切な形式です。CLF形式では、次のフィールドがサポートされます。
c-ip
x-log-id
x-auth-id
x-clf-date
x-req-line
sc-status
bytes
この形式では多数のCLFフィールドが使用され、Oracle-ECID
リクエスト・ヘッダーに指定したリクエストIDと順序番号をトラッキングするためのx-ecid
フィールドが含まれます。
c-ip
x-log-id
x-auth-id
x-clf-date
x-req-line
sc-status
bytes
x-ecid
この形式では、CLFフィールドと、cs(Referer)
およびcs(User-Agent)
の追加フィールドがサポートされます。
c-ip
x-log-id
x-auth-id
x-clf-date
x-req-line
sc-status
bytes
cs(Referer)
cs(User-Agent)
リクエストをOracle Web Cacheに転送する前に、リクエストを送信しているブラウザの種類とブラウザが訪問した場所を判別する必要がある場合は、この形式を選択します。
この形式では多数の複合ログ形式フィールドが使用され、Oracle-ECID
リクエスト・ヘッダーに指定したIDをトラッキングするためのx-ecid
フィールドが含まれます。
c-ip
x-log-id
x-auth-id
x-clf-date
x-req-line
sc-status
bytes
cs(Referer)
cs(User-Agent)
x-ecid
この形式は、10gのエンド・ユーザーのパフォーマンス監視機能のために用意された次のフィールドをサポートしています。
x-req-type
x-date-start
x-time-start
c-ip
s-ip
x-auth-id
cs(Host)
cs-method
cs-uri
x-protocol
sc-status
bytes
cs-bytes
x-cache
time-taken
r-time-taken
x-time-delay
x-os-timeout
x-ecid
x-cookie(ORACLE_SMP_CHRONOS_ST)
x-cookie(ORACLE_SMP_CHRONOS_LT)
x-cookie(ORACLE_SMP_CHRONOS_GL)
x-glcookie-set
cs(Referer)
cs(User-Agent)
x-esi-info
x-conn-abrt
sc(Content-Type)
デフォルトの形式が使用している環境に適していない場合は、必要なフィールドを指定することにより、カスタム・ログ形式を作成できます。表9-5に、サポートされているフィールドを示します。x
またはr
の接頭辞を持つフィールドは、Oracle Web Cacheに固有のフィールドです。
表9-5 アクセス・ログのフィールド
フィールド | 説明 |
---|---|
リクエストのコンテンツの長さ。 |
|
クライアントのIPアドレス。 |
|
|
キャッシュのステータスを指定する整数。キャッシュのステータスは次のいずれかになります。
|
クライアントから送信されたHTTPリクエスト・ヘッダー。 |
|
クライアントから受信したバイト。 |
|
クライアントからOracle Web CacheへのHTTPリクエスト・メソッド。 |
|
クライアントからOracle Web CacheへのURI |
|
クライアントからOracle Web CacheへのURIの問合せ部分(ステムの部分は省略)。 |
|
クライアントからOracle Web CacheへのURIのステム部分(問合せの部分は省略)。 |
|
トランザクションが完了した日付。次の書式で表示されます。
|
|
オリジン・サーバーのIPアドレスとポート番号。キャッシュ・クラスタの場合、このフィールドには、キャッシュ・クラスタ内のピア・キャッシュのIPとポート番号が表示されます。この情報は、次の書式で表示されます。
|
|
Oracle Web Cacheとオリジン・サーバーまたはピア・キャッシュとの通信にかかった秒単位の時間(マイクロ秒も含む)。この時間は、次の2つのタイム・ポイント間の時間差です。
このフィールドは、エンド・ユーザーのパフォーマンス監視機能にタイム情報を提供する場合に便利です。 |
|
Oracle Web CacheコンピュータのIPアドレス |
|
Oracle Web Cacheからクライアントに送信されたHTTPレスポンス・ヘッダー |
|
Oracle Web Cache HTTPからクライアントへのHTTPステータス・コード。次のコードがあります。
関連項目: HTTPステータス・コードの詳細は、 |
|
Oracle Web Cacheからのレスポンスが完了した時刻。時刻は次の書式で表示されます。
|
|
トランザクションが完了するまでにかかった秒単位の時間(マイクロ秒も含む)。 |
|
HTTPのBasic認証リクエストのユーザー名。 |
|
キャッシュのステータス。キャッシュのステータスは次のいずれかになります。
|
|
診断情報。次の形式で表示されます。
例:
|
|
|
キャッシュ・キーの値。次の書式で表示されます。 " |
Oracle Web Cacheからのレスポンスが完了した日付。次の書式で表示されます。
|
|
キャッシュ・クラスタのステータスを表す1つの文字。この文字は次のいずれかになります。
|
|
クライアント・ブラウザ・リクエストのCookieの値。 |
|
レスポンスが完了する前に接続が終了したかどうかを表す1つの文字。このフィールドは、エンド・ユーザーのパフォーマンス監視用です。
|
|
Oracle Web Cacheが、リクエストの最初のバイトを受信する前の日付。次の書式で表示されます。
|
|
Oracle Web Cacheが、レスポンスの最後のバイトを送信した日付。次の書式で表示されます。
|
|
関連項目: |
|
表示されるのは、 |
|
Oracle Web Cachが
|
|
クライアントのログイン・ユーザー名。Oracle Web Cacheは、このフィールドの値を取得できません。そのため、このフィールドが設定されている場合は出力にハイフン( |
|
Oracle Web Cacheがリクエストを転送するオリジン・サーバーまたはキャッシュ・クラスタ・メンバー。次の書式で表示されます。
|
|
オリジン・サーバーがリクエスト時にタイムアウトしたかどうかを表す1文字。この文字は次のいずれかになります。
|
|
クライアント・リクエストのプロトコルおよびバージョン。次の書式で表示されます。
|
|
リクエスト行。次の書式で表示されます。
例: |
|
リクエストのタイプ。リクエストのタイプは次のいずれかになります。
|
|
Oracle Web Cacheとオリジン・サーバーまたはピア・キャッシュとの通信にかかった秒単位の時間(マイクロ秒も含む)。この時間は、次の2つのタイム・ポイント間の時間差です。
このフィールドは、エンド・ユーザー・パフォーマンス監視機能にタイム情報を提供する場合に便利です。 |
|
Oracle Web Cacheが、レスポンスの最後のバイトを送信した時刻。次の書式で表示されます。
|
|
クライアントが新規の接続を開始した時刻と、Oracle Web CacheがHTTPリクエストの最初のバイトを受信した時刻の時間差。 注意: オラクル社カスタマ・サポート・センターから指示された場合のみ、このフィールドを選択してください。 |
|
Oracle Web CacheがHTTPリクエストの最初のバイトと最後のバイトを受信した時刻の時間差。このフィールドは、ブラウザ・リクエストの読取り時間を示します。 注意: オラクル社カスタマ・サポート・センターから指示された場合のみ、このフィールドを選択してください。 |
|
Oracle Web CacheがHTTPリクエストの最初と最後のバイトをオリジン・サーバーに送信した時刻の時間差。このフィールドは、リクエストをオリジン・サーバーに送信するためにかかった時間を示します。 注意: オラクル社カスタマ・サポート・センターから指示された場合のみ、このフィールドを選択してください。 |
|
Oracle Web CacheがHTTPレスポンスの最初のバイトと最後のバイトをオリジン・サーバーから受信した時刻の時間差。このフィールドは、レスポンスをオリジン・サーバーから受信するためにかかった時間を示します。 注意: オラクル社カスタマ・サポート・センターから指示された場合のみ、このフィールドを選択してください。 |
|
Oracle Web CacheがHTTPレスポンスの最初のバイトと最後のバイトをオリジン・サーバーに送信した時刻の時間差。このフィールドは、レスポンスをクライアントに送信するためにかかった時間を示します。 注意: オラクル社カスタマ・サポート・センターから指示された場合のみ、このフィールドを選択してください。 |
|
キャッシュの更新によってリクエストがブロックされた時刻とブロックが解除された時刻の時間差。既存のオブジェクトを更新するためにリクエストがOracle Web Cacheによってオリジン・サーバーに送信されている場合、Oracle Web Cacheでは後続のリクエストがすべてブロックされます。 注意: オラクル社カスタマ・サポート・センターから指示された場合のみ、このフィールドを選択してください。 |
|
リクエストがオリジン・サーバーへのキューに入れられた時刻とデキューされた時刻の時間差。このフィールドは、リクエストが処理目的でオリジン・サーバーに送信される前に、Oracle Web Cacheのオリジン・サーバー用バックエンド・キューに入れられていた(オリジン・サーバーが最大許容量に達したため)時間を示します。 注意: オラクル社カスタマ・サポート・センターから指示された場合のみ、このフィールドを選択してください。 |
|
Oracle Web Cacheが、リクエストの最初のバイトを受信する前の時刻。次の書式で表示されます。
|
表9-6は、cs(
header_name
)
フィールドおよびsc(
header_name
)
フィールドに使用できるHTTP/1.1ヘッダーの例をリストにしたものです。この表には、使用可能なヘッダーの一部のみリストされています。包括的なリストではありません。
表9-7は、cs(
header_name
)
フィールドとsc(
header_name
)
フィールドに使用できるCookie関連ヘッダーの例をリストにしたものです。
表9-8は、cs(
header_name
)
フィールドとsc(
header_name
)
フィールドに使用できるOracle Web Cacheヘッダーの例をリストにしたものです。
次に、アクセス・ログ・ファイルの抜粋を示します。
10.10.150.35 - - [25/Jul/2005:10:27:42 -0500] "GET /~user/personal.htm HTTP/1.1" 200 2438 10.10.150.35 - - [25/Jul/2005:10:27:54 -0500] "GET /~user/personal.htm?UserName=Bob HTTP/1.1" 200 2438 10.10.150.35 - - [25/Jul/2005:10:47:30 -0500] "GET /~user/count.sh HTTP/1.1" 403 289 10.10.150.35 - - [25/Jul/2005:10:47:34 -0500] "GET /~user/sbin/count.sh HTTP/1.1" 200 321
出力の最初の行で、各フィールドの意味は次のようになります。
10.10.150.35
は、ブラウザのIPアドレス(c-ip
)です。
[25/Jul/2005:10:27:42 -0500]
は、日付([x-clf-date]
)です。
"GET /~user/personal.htm HTTP/1.1
"
は、リクエスト行("x-req-line"
)です。
200
は、HTTPステータス・コード(sc-status
)です。
2438
は、送信されたオブジェクトのサイズ(bytes
)です。
この項では、さらに次のアクセス・ログの例を示します。
他に注記がない場合、アクセス・ログの例では、CLF形式が使用されています。
c-ip x-log-id x-auth-id x-clf-date x-req-line sc-status bytes
次に、Webブラウザの再ロードが2回、続いてシフト-再ロードが2回、さらに再ロードが2回発生した場合のアクセス・ログの抜粋を示します。
10.10.150.35 - - [25/Jul/2005:11:04:24 -0500] "GET /cache.htm HTTP/1.1" 200 250 10.10.150.35 - - [25/Jul/2005:11:04:26 -0500] "GET /cache.htm HTTP/1.1" 200 250 10.10.150.35 - - [25/Jul/2005:11:29:24 -0500] "GET /cache.htm HTTP/1.1" 304 0 10.10.150.35 - - [25/Jul/2005:11:29:25 -0500] "GET /cache.htm HTTP/1.1" 304 0 10.10.150.35 - - [25/Jul/2005:11:29:30 -0500] "GET /cache.htm HTTP/1.1" 200 250 10.10.150.35 - - [25/Jul/2005:11:29:35 -0500] "GET /cache.htm HTTP/1.1" 200 250
3と4行目では、オブジェクトが変更されていないことを示すHTTPステータス・コード304が返されていますので、再ロードの必要がなかったことを表しています。
次に、リクエストされたURL /ows-img/chalk.jpg
に一致するオブジェクトをOracle Web Cacheが検出できなかった場合のアクセス・ログの抜粋を示します。このエラーは、HTTPステータス・コード404によって示されます。
10.10.150.35 - - [25/Jul/2005:10:49:44 -0500] "GET /pls/coe/find_via_post HTTP/1.1" 200 1119
10.10.150.35 - - [25/Jul/2005:10:49:44 -0500] "GET /ows-img/chalk.jpg HTTP/1.1" 404 284
複合形式を指定した場合のアクセス・ログの抜粋を示します。
c-ip x-log-id x-auth-id x-clf-date x-req-line sc-status bytes cs(Referer) cs(User-Agent) 10.10.150.35 - - [25/Jul/2005:20:09:47 +0000] "GET /manual/sections.html HTTP/1.1" 200 -1 "http://www.company.com:80/manual/mod/directive-dict.html#Syntax" "Mozilla/4.78 [ja] (Win98; U)" 10.10.150.35 - - [25/Jul/2005:20:09:50 +0000] "GET /manual/mod/core.html HTTP/1.1" 200 -1 "http://www.company.com:80/manual/sections.html" "Mozilla/4.78 [ja] (Win98; U)" 10.10.150.35 - - [25/Jul/2005:20:10:06 +0000] "GET / HTTP/1.1" 200 -1 - "Mozilla/4.78 [ja] (Win98; U)" 10.10.150.35 - - [25/Jul/2005:20:10:14 +0000] "GET /manual/LICENSE HTTP/1.1" 200 -1 "http://www.company.com:80/manual/index.html" "Mozilla/4.78 [ja] (Win98; U)"
次のフィールドを指定した場合のアクセス・ログの抜粋を示します。
c-ip x-auth-id x-clf-date cs(Host) x-req-line sc-status bytes
cs(Host)
は、サイト情報を指定するHost
リクエスト・ヘッダー・フィールドの出力を表示します。この例では、サイトwww.company.com:80
に対するリクエストがOracle Web Cacheに送信されます。
10.10.150.35 - [25/Jul/2005:20:05:51 +0000] "www.company.com:80" "GET / HTTP/1.1" 200 -1 10.10.150.35 - [25/Jul/2005:20:05:56 +0000] "www.company.com:80" "GET /manual/index.html HTTP/1.1" 200 -1 10.10.150.35 - [25/Jul/2005:20:05:59 +0000] "www.company.com:80" "GET /manual/upgrading_to_1_3.html HTTP/1.1" 200 -1 10.10.150.35 - [25/Jul/2005:20:06:02 +0000] "www.company2.com:80" "GET /manual/mod/mod_dir.html HTTP/1.1" 200 -1 10.10.150.35 - [25/Jul/2005:20:06:05 +0000] "www.company2.com:80" "GET /manual/mod/directive-dict.html HTTP/1.1" 200 -1
次のフィールドを指定した場合のアクセス・ログの抜粋を示します。
c-ip x-clf-date x-req-line sc-status bytes
x-cache-detail
x-cache-detail
によって、診断情報が表示されます。次に例を示します。
T
は、このリクエストがESIテンプレート用であることを表します。
H
は、このリクエストがキャッシュ・ヒットになったことを表します。
max-age=10+15
は、このオブジェクトがキャッシュに格納されてから10秒後に期限切れとなり、期限切れになってから15秒後にキャッシュから削除されることを表します。つまり、このドキュメントはキャッシュに格納されてから、合計で25秒間存在することになります。
age=0
は、キャッシュに格納されてから0秒経過したことを表します。つまり、期限切れになるまで残り10秒、削除されるまで残り15秒ということになります。
[25/Jul/2005:02:35:37 +0000] "GET /cgi-bin/esi-headers.sh?err1.htm HTTP/1.0" 200 42 TM;max-age=10+15;age=0
イベント・ログ設定を構成するには、次の手順を実行します。
Fusion Middleware Controlで「Webキャッシュ・メンバー」ページにナビゲートします。第2.6.2項を参照してください。
「Webキャッシュ」メニューで、「管理」、次に「イベント・ログ」を選択します。
「イベント・ログ構成」ページが表示されます。
「キャッシュ固有の設定」表内の各キャッシュに対して、次の設定を指定します。
「Directory」フィールドに、イベント・ログを作成するディレクトリを入力します。
デフォルトでは、イベント・ログは次のディレクトリに格納されます。
(UNIX) ORACLE_INSTANCE/diagnostics/logs/WebCache/<webcache_name> (Windows) ORACLE_INSTANCE\diagnostics\logs\WebCache\<webcache_name>
バッファ・ロギングを有効にするには「バッファリングを有効化?」をクリックし、バッファ・ロギングを無効にするにはこのチェック・ボックスを選択解除します。
バッファ・ロギングでは、Oracle Web Cacheはログ・メッセージをメモリーに格納します。バッファ・サイズまたはフラッシュ間隔に達すると、Oracle Web Cacheはメモリー内のログ・メッセージをまとめてイベント・ログに書き込みます。バッファ・ロギングを使用すると、ディスクI/O操作が減るのでパフォーマンスが向上します。
Oracle Web Cacheサーバーが予期せずシャットダウンすると、バッファされているログ・メッセージが失われる場合があります。
イベント・ログの結果を即時に参照する場合は、バッファリングを無効にすることをお薦めします。
バッファリングが有効になっている場合は、「フラッシュ間隔」フィールドに、Oracle Web Cacheがバッファの内容をイベント・ログ・ファイルに書き込む間隔を秒単位で指定します。
デフォルトは10秒です。間隔が経過すると、Oracle Web Cacheはバッファに格納されている情報をイベント・ログ・ファイルに書き込みます。バッファがいっぱいになっていなくても、Oracle Web Cacheはイベント・ログを更新します。時間を短くして結果を頻繁に表示する必要がある場合以外は、デフォルト値を変更しないことをお薦めします。
0を指定すると、Oracle Web Cacheは指定したバッファ・サイズを超えたときにのみバッファのイベント・ログをフラッシュします。
バッファリングを有効にしている場合は、「バッファ・サイズ」フィールドに、文字数で表したバッファのサイズを入力します。
デフォルトは2,048文字です。指定できる最大値は32,768文字です。
「Verbosity」リストから、イベント・ログに必要な詳細レベルを選択します。表9-9にレベルを示します。
「グローバル・イベント・ログの構成」セクションでグローバル・イベント・ログ設定を指定します。
「File Name」フィールドに、イベント・ログ・ファイルの名前を入力します。
デフォルトのファイル名は、event_log
です。
「File Format」リストからログ形式を選択します。
形式の詳細は、第9.1.1項を参照してください。
「Time Style」リストから、「Local」または「GMT」(グリニッジ標準時)のいずれかを選択して、イベント・ログ・ファイル内のエントリに関連付けられたタイムスタンプの書式を変更します。
「リクエストベースのロギング」をクリックして、リクエストベースのロギングを有効にします。
リクエストベースのロギングでは、Oracle Web Cacheは、各リクエストに関連付けられている、メモリー内のすべてのイベント・ログ・メッセージを収集します。リクエストの最も重大なメッセージが、選択されている冗長性レベルと同じかそれ以上の場合、Oracle Web Cacheはそのリクエストに関連するすべてのメッセージをイベント・ログに一度に書き込みます。診断が容易なように、1つのリクエストに対するメッセージがグループ化されログ・ファイル内に集められます。たとえば、冗長性が「通知」に設定されていて、トレース・レベルまたはデバッグ・レベルのエラーが検出された場合、Oracle Web Cacheはそのリクエストに対するすべてのイベント・ログ・メッセージをイベント・ログに書き込みます。
結果を発生したとおりに表示する場合、特に冗長性が「通知」より高いレベルに設定されている場合は、「無効」を選択します。
「Include Request Details」で、Oracle Web CacheがOracle-ECID
リクエスト・ヘッダーの情報をイベント・ログに書き込む場合は「Yes」を選択し、リクエスト情報をイベント・ログに書き込まない場合は「No」を選択します。リクエスト詳細のロギング方法の詳細は、第9.1.1.2項を参照してください。
次の条件のどちらかに当てはまる場合は、「No」を選択します。
リクエスト詳細のイベント・ログ・エントリによるパフォーマンス上の影響が心配な場合。
Oracle HTTP Serverを使用せずにスタンドアロン環境でOracle Web Cacheが稼働している場合。
ロールオーバー・ポリシーを指定します。
「時間別にロールオーバー」セクションで、「編集」をクリックします。
「ロールオーバー・ポリシーの編集」ダイアログ・ボックスが表示されます。
ロールオーバー・オプションは組み合せて使用できます。たとえば、「時間別にロールオーバー」と「サイズ別にロールオーバー」の両方を使用したり、「サイズ別に保存」と「時間別に保存」の両方を使用できます。Oracle Web Cacheでは、先に使用できるオプションでロールオーバーが実行されます。
「Rollover by Time」リストから、「Never」、「Hourly」、「Daily」または「Weekly」を選択して、Oracle Web Cacheが現在のログ情報をevent_log_file.yyyymmddhhmm
に保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込む頻度を指定します。
ボリュームの大きいサイトでは、「日次」または「時間」を選択します。
「スケジュール時間」フィールドで、「毎時」、「毎日」および「毎週」について、左側のフィールドとメニューを使用して新しい頻度を指定し、「追加」をクリックしてスケジュールに追加します。表9-10に、「Hourly」、「Daily」および「Weekly」の構成方法を具体的に示します。
表9-10 時間別のロールオーバーの構成
ポリシー | 構成手順 |
---|---|
毎時 |
|
毎日 |
|
毎週 |
|
スケジュール・リストから時間を削除するには、目的の時間を選択して「Remove」をクリックします。選択した値が左側のリストへ移動し、変更できるようになります。
ログ・ファイルを即時にロールオーバーする方法は、第9.8項を参照してください。
「Rollover by Size」フィールドに、ロールオーバーを実行するログ・ファイルの最大サイズを入力します。0を指定すると、サイズが無制限になります。
「Retention by Time」フィールドに、最も古いログ・ファイルを消去するまでの期間を指定します。
「毎」フィールドに値を入力し、「時間」、「日」、「週」、「月」、「年」のリストから期間を選択します。値0は無期限を意味し、Oracle Web Cacheは時間に基づいてファイルを保持しません。
「Retention by Size」フィールドに、最も古いログ・ファイルを消去する条件として、すべてのログ・ファイルの合計サイズを入力します。0を指定すると、サイズが無制限になります。
ここには、「Rollover Size」フィールドに指定した値より大きい値を入力する必要があります。
「Retention by Time」と「Retention by Size」を両方とも設定しない場合は、ログ・ファイルのサイズが無制限に大きくなります。その結果、ログ・ファイルを保存しているディスクの空き容量をすべて消費してしまう可能性があります。
「OK」をクリックします。
「適用」をクリックし、Oracle Web Cacheを再起動します。第2.13項を参照してください。
アクセス・ログの設定を構成するには、次のようにします。
Fusion Middleware Controlで「Webキャッシュ・メンバー」ページにナビゲートします。第2.6.2項を参照してください。
「Webキャッシュ」メニューで、「管理」、次に「アクセス・ログ」を選択します。
「アクセス・ログの構成」ページが表示されます。
「キャッシュ固有の設定」表内の各キャッシュに対して、次の設定を指定します。
「Directory」フィールドに、アクセス・ログを書き込むディレクトリを入力します。
デフォルトでは、イベント・ログは次のディレクトリに格納されます。
(UNIX) ORACLE_INSTANCE/diagnostics/logs/WebCache/<webcache_name> (Windows) ORACLE_INSTANCE\diagnostics\logs\WebCache\<webcache_name>
ロギングを有効にするには「ロギングを有効化?」をクリックし、ロギングを無効にするには選択解除します。
バッファ・ロギングを有効にするには「バッファリングを有効化?」をクリックし、バッファ・ロギングを無効にするにはこのチェック・ボックスを選択解除します。
バッファ・ロギングでは、Oracle Web Cacheはログ・メッセージをメモリーに格納します。バッファ・サイズまたはフラッシュ間隔に達すると、Oracle Web Cacheはメモリー内のログ・メッセージをまとめてアクセス・ログに書き込みます。バッファ・サイズは2048バイトに設定されています。バッファ・ロギングを使用すると、ディスクI/O操作が減るのでパフォーマンスが向上します。
Oracle Web Cacheサーバーが予期せずシャットダウンすると、バッファされているログ・メッセージが失われる場合があります。
アクセス・ログの結果を即時に参照する場合は、バッファリングを無効にすることをお薦めします。
バッファリングが有効になっている場合は、「フラッシュ間隔」フィールドに、Oracle Web Cacheがバッファの内容をアクセス・ログ・ファイルに書き込む間隔を秒単位で指定します。
デフォルトは10秒です。間隔が経過すると、Oracle Web Cacheはバッファに格納されている情報をアクセス・ログ・ファイルに書き込みます。バッファがいっぱいになっていなくても、Oracle Web Cacheはアクセス・ログを更新します。時間を短くして結果を頻繁に表示する必要がある場合以外は、デフォルト値を変更しないことをお薦めします。
0を指定すると、Oracle Web Cacheは指定したバッファ・サイズを超えたときにのみバッファのアクセス・ログをフラッシュします。
「サイト固有の設定」表内の各サイトに対して、次の設定を指定します。
「デフォルト設定」行の設定をこのサイトに適用するには、すべてのサイト設定にデフォルトを使用をクリックします。他のフィールドでサイト固有のオーバーライドを行う場合は、このチェック・ボックスを選択解除します。
「File Name」フィールドに、アクセス・ログ・ファイルの名前を入力します。
デフォルトのファイル名は、access_log
です。
サイトのロギングを有効にする場合は「ロギングの有効化」を選択し、サイトのロギングを無効にする場合は選択解除します。
サイト固有のロギングは、キャッシュのロギングが有効な場合にのみ、有効になります。このオプションを有効にする場合は、ステップ3bでキャッシュについてもこのオプションが選択されていることを確認してください。
<esi:environment>
または<esi:include>
のlog
要素からESIフラグメント・ログ・メッセージをaccess_log_file
.fragment
ファイルに記録するには、「ESIフラグメント・リクエストをログしますか。」を選択します。
x-esi-info
フィールドが選択済の場合は、イベントをaccess_log_file
.fragment
ファイルに記録することを選択します。「Format Style
」がエンド・ユーザー・パフォーマンス監視の形式の場合、x-esi-infoフィールドは自動的に選択されます。x-esi-info
フィールドが選択されていない場合は、「Don't Log」を選択します。
「Format Style」リストから、アクセス・ログの形式を選択します。
デフォルト形式の詳細は、第9.2.1項を参照してください。環境に合わせてカスタマイズされた形式の作成方法は、第9.5項を参照してください。
「Rollover Policy」リストから、ロールオーバー・ポリシーを選択して書込み先のログ・ファイルの変更頻度を指定します。Oracle Web Cacheでは、現在のログ情報をaccess_log_file.
yyyymmddhhmm
に保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込みます。
大規模サイトの場合は、頻度の高いポリシーを選択します。
既存のポリシーの変更方法または新しいロールオーバー・ポリシーの作成方法は、第9.6項を参照してください。
「適用」をクリックし、Oracle Web Cacheを再起動します。第2.13項を参照してください。
第9.2.1項に示されているデフォルトの形式が使用環境に適していない場合は、新しいログ形式を作成します。
Fusion Middleware Controlで「Webキャッシュ・メンバー」ページにナビゲートします。第2.6.2項を参照してください。
「Webキャッシュ」メニューで、「管理」、次に「アクセス・ログ」を選択します。
「アクセス・ログの構成」ページが表示されます。
「ログ・フォーマット」タブをクリックし、「作成」をクリックします。
ログ形式の作成ダイアログ・ボックスが表示されます。
「Format Name」フィールドに、一意の形式名を入力します。このとき、次の制限事項に注意してください。
形式名には、空白や、アンダースコア(_
)以外の特殊文字を含めることはできません。
名前は、他の形式名、ロールオーバー・ポリシー名およびセッション名の中で一意である必要があります。
「Separator」リストから、アクセス・ログ・フィールドを区切るセパレータを選択します。
「Print XLF Directives」フィールドで、アクセス・ログの先頭にXLFディレクティブ情報を挿入する場合は「Yes」を、挿入しない場合は「No」を選択します。
通常、ディレクティブ情報には、バージョン、日付およびフィールド情報が含まれています。次に例を示します。
#Version: 1.0 #Date: 12-Jul-2008 00:00:00 #Fields: c-ip x-auth-id x-clf-date cs(Host x-req-line sc-status bytes
XLFディレクティブの詳細は、http://www.w3.org/TR/WD-logfile.html
を参照してください。
「XLFフィールド」セクションで、「フィールド名」リストからアクセス・ログ・フィールド名を選択します。
サポートされるアクセス・ログ・フィールドのリストは、表9-5を参照してください。
cs(header_nameまたはsc cs(
header_name
)
、sc(
header_name
)
またはx-cookie(
cookie_name
)
を選択した場合は、「ヘッダー/Cookie名」フィールドにヘッダーまたはCookie名を入力します。
cs(
header_name
)
およびsc(
header_name
)
で使用できるヘッダーの詳細は、表9-6、表9-7および表9-8を参照してください。
「Add」をクリックします。
アクセス・ログに必要な形式ごとにステップ7と9を実行し、「Move Up」ボタンと「Move Down」ボタンを使用して、フィールドの順序を並べ替えます。フィールドの入力順序により、フィールドがログに記録される順序が決定されます。
変更を適用して「アクセス・ログの構成」ページに戻るには、「OK」をクリックします。
変更を適用するには、「アクセス・ログの構成」ページで「適用」をクリックします。
既存のロールオーバー・ポリシーを変更するか新しいロールオーバー・ポリシーを作成するには、次の手順を実行します。
Fusion Middleware Controlで「Webキャッシュ・メンバー」ページにナビゲートします。第2.6.2項を参照してください。
「Webキャッシュ」メニューで、「管理」、次に「アクセス・ログ」を選択します。
「アクセス・ログの構成」ページが表示されます。
「ロールオーバー・ポリシー」タブをクリックし、「作成」をクリックします。
「ロールオーバー・ポリシーの作成」ダイアログ・ボックスが表示されます。
ロールオーバー・オプションは組み合せて使用できます。たとえば、「時間別にロールオーバー」と「サイズ別にロールオーバー」の両方を使用したり、「サイズ別に保存」と「時間別に保存」の両方を使用できます。Oracle Web Cacheでは、先に使用できるオプションでロールオーバーが実行されます。
「Policy Name」フィールドに、一意のロールオーバー・ポリシー名を入力します。このとき、次の制限事項に注意してください。
ポリシー名には、空白や、アンダースコア(_
)以外の特殊文字を含めることはできません。
名前は、他のポリシー名、ログ形式名およびセッション名の中で一意である必要があります。
「Rollover by Time」セクションで、「Never」、「Hourly」、「Daily」または「Weekly」、を選択して、Oracle Web Cacheが現在のログ情報をaccess_log_file.
yyyymmddhhmm
に保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込む頻度を指定します。
ボリュームの大きいサイトでは、「日次」または「時間」を選択します。
「Rollover by Time」セクションで、「Never」、「Hourly」、「Daily」または「Weekly」、を選択して、Oracle Web Cacheが現在のログ情報をaccess_log_file.
yyyymmddhhmm
に保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込む頻度を指定します。
ボリュームの大きいサイトでは、「日次」または「時間」を選択します。
「毎時」、「毎日」および「毎週」について、左側のフィールドおよびメニューに新しい頻度を入力し、「追加」をクリックしてスケジュールに追加します。表9-11に、「Hourly」、「Daily」および「Weekly」の構成方法を具体的に示します。
表9-11 時間別のロールオーバーの構成
ポリシー | 構成手順 |
---|---|
毎時 |
|
毎日 |
|
毎週 |
|
スケジュール・リストから時間を削除するには、目的の時間を選択して「Remove」をクリックします。選択した値が左側のリストへ移動し、変更できるようになります。
ログ・ファイルを即時にロールオーバーする方法は、第9.8項を参照してください。
「Rollover by Size」フィールドに、ロールオーバーを実行するログ・ファイルの最大サイズを入力します。0を指定すると、サイズが無制限になります。
「Retention by Time」フィールドに、最も古いログ・ファイルを消去するまでの期間を指定します。
「毎」フィールドに値を入力し、「時間」、「日」、「週」、「月」、「年」のリストから期間を選択します。値0は無期限を意味し、Oracle Web Cacheは時間に基づいてファイルを保持しません。
「Retention by Size」フィールドに、最も古いログ・ファイルを消去する条件として、すべてのログ・ファイルの合計サイズを入力します。0を指定すると、サイズが無制限になります。
ここには、「Rollover Size」フィールドに指定した値より大きい値を入力する必要があります。
「Retention by Time」と「Retention by Size」を両方とも設定しない場合は、ログ・ファイルのサイズが無制限に大きくなります。その結果、ログ・ファイルを保存しているディスクの空き容量をすべて消費してしまう可能性があります。
変更を適用して「アクセス・ログの構成」ページに戻るには、「OK」をクリックします。
変更を適用するには、「アクセス・ログの構成」ページで「適用」をクリックします。
イベント・ログを表示するには、Fusion Middleware ControlまたはWLSTのlistLogs
コマンドを使用します。詳細は、次のドキュメントを参照してください。
イベント・ログを表示するための様々なツールの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。
イベント・ログ・メッセージの詳細は、Oracle Fusion Middlewareのエラー・メッセージ・リファレンスを参照してください。
アクセス・ログを表示するには、任意のテキスト・エディタを使用します。
イベント・ログとアクセス・ログのロールオーバー頻度を構成する以外に、イベント・ログとアクセス・ログを即時にロールオーバーすることができます。ロールオーバー・プロセスでは、Oracle Web Cacheが現在の情報をログ・ファイルに保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込みます。
ログ・ファイルを即時にロールオーバーするには、次の手順を実行します。
Fusion Middleware Controlで「Webキャッシュ・メンバー」ページにナビゲートします。第2.6.2項を参照してください。
「Webキャッシュ」メニューから、「操作」→「オンデマンド・ロールオーバー」を選択します。
Oracle Web Cacheは、Oracle Fusion Middlewareコンポーネント全体の監査を管理する統一したシステムを提供するために、共通監査フレームワークをサポートしています。Oracle Web Cacheの各プロセスで生成される監査ログ・ファイルには、セキュリティ・パフォーマンスおよび構成上の問題を特定して診断する際に役立つ重要な情報が記録されます。
Oracle Web Cacheは、次のイベントを監査ログに記録します。
起動イベントとシャットダウン・イベント
次のキャッシュ間通信イベント
認証イベントまたはチャレンジ・イベント
サブスクライバ・リストへのサブスクライバ・キャッシュの挿入(成功または失敗)
サブスクライバからの無効なアドレス情報
リモートまたはサブスクライバ・キャッシュ認証イベント
クラスタ・キャッシュ・メンバーの追加または削除
次のリクエスト認証イベント
Oracle Web Cacheポートへのログイン
アクセス制御設定またはリクエスト・フィルタリング・ルールが原因で拒否されたリクエスト
キャッシュされているオブジェクトへのアクセスが拒否されたID
間違ったWebサイト情報を含んでいるレスポンスでの無効化
クライアント証明書の失敗
クライアント証明書が提示されなかったために拒否されたSSL接続
提示されたクライアント証明書がCRLにあったために拒否されたSSL接続
次の構成サービス
動的構成変更の適用
オリジン・サーバーによるSSLハンドシェイクの失敗
プロキシ・サーバーによる認証の失敗
監査ログの使用方法の詳細は、Oracle Fusion Middlewareセキュリティ・ガイドを参照してください。