Oracle Web Cacheのロギング機能を使用すると、Oracle Web Cacheおよび関連プロセスの実行中および使用中に発生した問題をトラブルシューティングすることができます。
この章の項目は次のとおりです。
Oracle Web Cacheは、イベントとエラーの情報をイベント・ログに記録します。イベント・ログ・エントリは、キャッシュに格納されたオブジェクトの判別に役立つとともに、キャッシュに関するすべての問題を通知します。Oracle Web Cacheではすべてのリクエストを内部に格納した後、これをリクエストの後に一括して書き出します。リクエストベースのロギングでは、すべてのリクエストがグループ化されます。
イベント・ログのデフォルトのファイル名は、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-1に、ODL Text形式の各フィールドを示します。
表9-1 ODL Textのメッセージ・フィールド
フィールド | 説明 |
---|---|
|
メッセージが生成された日付と時刻。時間は、ローカル・タイムまたはグリニッジ標準時のいずれかで表示されます。 |
|
メッセージのタイプ。可能な値はNOTIFICATION、WARNING、TRACEおよびDEBUGです。 |
|
メッセージ・レベル。メッセージ・タイプを修飾する整数値で表されます。可能な値は、1(最も高い重大度)〜32(最も低い重大度)です。 |
|
コンポーネント内でメッセージを一意に識別するID。コンポーネントを表す接頭辞、ダッシュおよび5桁の数字で構成されます。例: |
|
メッセージを送信したモジュールの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文字。この文字は次のいずれかになります。
|
|
クライアント・リクエストのプロトコルおよびバージョン。次の書式で表示されます。
|
|
リクエスト行。次の書式で表示されます。
例: "GET /cache.htm HTTP/1.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
イベント・ログ設定を構成するには、次の手順を実行します。
Oracle Web Cache Managerのナビゲータ・フレームで、「Logging and Diagnostics」→「Event Logs」を選択します。第2.7.2項を参照してください。
「Event Logs」ページが表示されます。
キャッシュ固有のイベント・ログの設定値を次のように指定します。
「Cache-Specific Event Log Configuration」表でキャッシュを選択し、「Edit Selected」をクリックします。
「Edit Cache-Specific Event Log Configuration」ダイアログ・ボックスが表示されます。
「Directory」フィールドに、イベント・ログを作成するディレクトリを入力します。
デフォルトでは、イベント・ログは次のディレクトリに格納されます。
(UNIX) ORACLE_INSTANCE/diagnostics/logs/WebCache/<webcache_name> (Windows) ORACLE_INSTANCE\diagnostics\logs\WebCache\<webcache_name>
「Verbosity」リストから、イベント・ログに必要な詳細レベルを選択します。表9-9にレベルを示します。
「Submit」をクリックします。
一般イベント・ログの設定値を次のように設定します。
「Global Event Log Configuration」表で、「Edit」をクリックします。
「Edit Global Event Log Configuration」ダイアログ・ボックスが表示されます。
「File Name」フィールドに、イベント・ログ・ファイルの名前を入力します。
デフォルトのファイル名は、event_log
です。
「File Format」リストからログ形式を選択します。
形式の詳細は、第9.1.1項を参照してください。
「Time Style」リストから、「Local」または「GMT」(グリニッジ標準時)のいずれかを選択して、イベント・ログ・ファイル内のエントリに関連付けられたタイムスタンプの書式を変更します。
「Include Request Details」で、Oracle Web CacheがOracle-ECID
リクエスト・ヘッダーの情報をイベント・ログに書き込む場合は「Yes」を選択し、リクエスト情報をイベント・ログに書き込まない場合は「No」を選択します。リクエスト詳細のロギング方法の詳細は、第9.1.1.2項を参照してください。
次の条件のどちらかに当てはまる場合は、「No」を選択します。
リクエスト詳細のイベント・ログ・エントリによるパフォーマンス上の影響が心配な場合。
Oracle HTTP Serverを使用せずにスタンドアロン環境でOracle Web Cacheが稼働している場合。
「Rollover by Time」リストから、「Never」、「Hourly」、「Daily」または「Weekly」を選択して、Oracle Web Cacheが現在のログ情報をevent_log_file.yyyymmddhhmm
に保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込む頻度を指定します。
「Hourly」、「Daily」および「Weekly」については、左側のフィールドとメニューを使用して新しい頻度を指定し、「Add」をクリックしてスケジュールに追加します。表9-10に、「Hourly」、「Daily」および「Weekly」の構成方法を具体的に示します。
表9-10 時間別のロールオーバーの構成
ポリシー | 構成手順 |
---|---|
Hourly |
|
Daily |
|
Weekly |
|
大規模サイトの場合は、日次または毎時ポリシーを作成します。
スケジュール・リストから時間を削除するには、目的の時間を選択して「Remove」をクリックします。選択した値が左側のリストへ移動し、変更できるようになります。
ログ・ファイルを即時にロールオーバーする方法は、第9.8項を参照してください。
「Rollover by Size」フィールドに、ロールオーバーを実行するログ・ファイルの最大サイズを入力します。0を指定すると、サイズが無制限になります。
「Retention by Time」フィールドに、最も古いログ・ファイルを消去するまでの期間を指定します。
「Every」フィールドにログ量を入力し、「Hours」、「Days」、「Weeks」、「Months」、「Years」の各リストから期間を選択します。ログ量として0を指定した場合は、時間が無制限になります。つまり、時間に基づいてファイルが保持されません。
「Retention by Size」フィールドに、最も古いログ・ファイルを消去する条件として、すべてのログ・ファイルの合計サイズを入力します。0を指定すると、サイズが無制限になります。
ここには、「Rollover Size」フィールドに指定した値より大きい値を入力する必要があります。
「Retention by Time」と「Retention by Size」を両方とも設定しない場合は、ログ・ファイルのサイズが無制限に大きくなります。その結果、ログ・ファイルを保存しているディスクの空き容量をすべて消費してしまう可能性があります。
「Submit」をクリックします。
変更を適用し、Oracle Web Cacheを再起動します。第2.13項を参照してください。
Oracle Web Cache Managerのナビゲータ・フレームで、「Logging and Diagnostics」→「Access Logs」を選択します。第2.7.2項を参照してください。
「Access Logs」ページが表示されます。
キャッシュ固有のアクセス・ログの設定値を次のように指定します。
「Cache-Specific Access Log Configuration」表でキャッシュを選択し、「Edit selected」をクリックします。
「Edit Cache-Specific Access Log Configuration」ダイアログ・ボックスが表示されます。
「Directory」フィールドに、アクセス・ログを書き込むディレクトリを入力します。
デフォルトでは、イベント・ログは次のディレクトリに格納されます。
(UNIX) ORACLE_INSTANCE/diagnostics/logs/WebCache/<webcache_name> (Windows) ORACLE_INSTANCE\diagnostics\logs\WebCache\<webcache_name>
「Enabled」フィールドで、ロギングを有効にする場合は「Yes」、無効にする場合は「No」を選択します。
「Buffering」フィールドで、バッファ・ロギングを有効にする場合は「Enabled」、無効にする場合は「Disabled」を選択します。
バッファ・ロギングを使用する場合は、バッファが満杯になるとアクセス・ログへの書込みが行われます。バッファ・サイズは2048バイトに設定されています。「Flush Interval」値の上限に達すると、バッファされたイベントがアクセス・ログ・ファイルに書き込まれます。
アクセス・ログの結果を即時に表示する場合は、バッファリングを無効にすることをお薦めします。
バッファリングを有効にした場合は、「Flush Interval」フィールドに、バッファのコンテンツがアクセス・ログ・ファイルに書き込まれる最大しきい値(秒単位)を入力します。
デフォルトは10秒です。最大しきい値に達すると、バッファされたイベントがアクセス・ログ・ファイルに書き込まれます。バッファが満杯にならない場合でも、アクセス・ログは最低10秒ごとに更新されます。時間間隔を短くして結果を頻繁に表示する必要がある場合以外は、デフォルト値を変更しないことをお薦めします。
「Submit」をクリックします。
サイト固有のログの設定値を次のように指定します。
「Site-Specific Access Log Configuration」表で、「Add」をクリックします。
「Edit/Add Site Specific Access Log Configuration」ダイアログ・ボックスが表示されます。
「For Site」リストから、アクセス・ログの設定値を指定するWebサイトを選択します。
「File Name」フィールドに、アクセス・ログ・ファイルの名前を入力します。
デフォルトのファイル名は、access_log
です。
「Enabled」フィールドで、サイトのロギングを有効にする場合は「Yes」、無効にする場合は「No」を選択します。
サイト固有のロギングは、キャッシュのロギングが有効な場合にのみ、有効になります。「Yes」を選択する場合は、ステップ2cでキャッシュに対して「Yes」が選択されていることを確認してください。
access_log_file
.fragment
ファイル内の<esi:environment>
または<esi:include>
のlog
要素からESIフラグメントのログ・メッセージを記録する場合は、「ESI Fragment Requests」フィールドで「Log」を選択します。
x-esi-info
フィールドが選択済の場合は、「Log」を選択してイベントを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項を参照してください。
「Submit」をクリックします。
変更を適用し、Oracle Web Cacheを再起動します。第2.13項を参照してください。
第9.2.1項に示されているデフォルトの形式が使用環境に適していない場合は、新しいログ形式を作成します。
Oracle Web Cache Managerのナビゲータ・フレームで、「Logging and Diagnostics」→「Access Logs」を選択します。第2.7.2項を参照してください。
「Access Logs」ページが表示されます。
「User-Defined Log Formats」表で、「Add」をクリックします。
「Edit/Add User-Defined Access Log Format」ダイアログ・ボックスが表示されます。
「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 Fields」セクションで、「Field Name」リストからアクセス・ログ・フィールド名を選択します。
サポートされるアクセス・ログ・フィールドのリストは、表9-5を参照してください。
cs(
header_name
)
、sc(
header_name
)
またはx-cookie(
cookie_name
)
の各フィールドを選択済の場合は、「Header/Cookie name」フィールドにヘッダー名またはCookie名を入力します。
cs(
header_name
)
およびsc(
header_name
)
で使用できるヘッダーの詳細は、表9-6、表9-7および表9-8を参照してください。
「Add」をクリックします。
アクセス・ログに必要な形式ごとにステップ6と8を実行し、「Move Up」ボタンと「Move Down」ボタンを使用して、フィールドの順序を並べ替えます。フィールドの入力順序により、フィールドがログに記録される順序が決定されます。
「Submit」をクリックします。
既存のロールオーバー・ポリシーを変更または新しいロールオーバー・ポリシーを作成するには、次の手順を実行します。
Oracle Web Cache Managerのナビゲータ・フレームで、「Logging and Diagnostics」→「Access Logs」を選択します。第2.7.2項を参照してください。
「Access Logs」ページが表示されます。
「User-Defined Log Rollover Policies」表から、既存のロールオーバー・ポリシーを変更する場合は、既存のポリシーを選択して「Edit selected」をクリックします。ポリシーを作成する場合は、「Add」をクリックします。
「Edit/Add Access Log Rollover Policy」ダイアログ・ボックスが表示されます。
「Policy Name」フィールドに、一意のロールオーバー・ポリシー名を入力します。このとき、次の制限事項に注意してください。
ポリシー名には、空白や、アンダースコア(_
)以外の特殊文字を含めることはできません。
名前は、他のポリシー名、ログ形式名およびセッション名の中で一意である必要があります。
「Rollover by Time」セクションで、「Never」、「Hourly」、「Daily」または「Weekly」、を選択して、Oracle Web Cacheが現在のログ情報をaccess_log_file.
yyyymmddhhmm
に保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込む頻度を指定します。
「Hourly」、「Daily」および「Weekly」については、左側のフィールドとメニューを使用して新しい頻度を指定し、「Add」をクリックしてスケジュールに追加します。表9-11に、「Hourly」、「Daily」および「Weekly」の構成方法を具体的に示します。
表9-11 時間別のロールオーバーの構成
ポリシー | 構成手順 |
---|---|
Hourly |
|
Daily |
|
Weekly |
|
大規模サイトの場合は、日次または毎時ポリシーを作成します。
スケジュール・リストから時間を削除するには、目的の時間を選択して「Remove」をクリックします。選択した値が左側のリストへ移動し、変更できるようになります。
ログ・ファイルを即時にロールオーバーする方法は、第9.8項を参照してください。
「Rollover by Size」フィールドに、ロールオーバーを実行するログ・ファイルの最大サイズを入力します。0を指定すると、サイズが無制限になります。
「Retention by Time」フィールドに、最も古いログ・ファイルを消去するまでの期間を指定します。
「Every」フィールドにログ量を入力し、「Hours」、「Days」、「Weeks」、「Months」、「Years」の各リストから期間を選択します。ログ量として0を指定した場合は、時間が無制限になります。つまり、時間に基づいてファイルが保持されません。
「Retention by Size」フィールドに、最も古いログ・ファイルを消去する条件として、すべてのログ・ファイルの合計サイズを入力します。0を指定すると、サイズが無制限になります。
ここには、「Rollover Size」フィールドに指定した値より大きい値を入力する必要があります。
「Retention by Time」と「Retention by Size」を両方とも設定しない場合は、ログ・ファイルのサイズが無制限に大きくなります。その結果、ログ・ファイルを保存しているディスクの空き容量をすべて消費してしまう可能性があります。
「Submit」をクリックします。
イベント・ログを表示するには、Fusion Middleware ControlコンソールまたはWLSTのlistLogs
コマンドを使用します。イベント・ログを表示する各種ツールの詳細は、Oracle Fusion Middlewareの管理者ガイドを参照してください。
アクセス・ログを表示するには、任意のテキスト・エディタを使用します。
イベント・ログとアクセス・ログのロールオーバー頻度を構成する以外に、イベント・ログとアクセス・ログを即時にロールオーバーすることができます。ロールオーバー・プロセスでは、Oracle Web Cacheが現在の情報をログ・ファイルに保存し、設定されているログ・ファイル名を使用して今後のログ情報を新しいログ・ファイルに書き込みます。
ログ・ファイルを即時にロールオーバーするには、次の手順を実行します。
「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セキュリティ・ガイド』を参照してください。