| Oracle® Fusion Middleware Oracle HTTP Serverの管理 12c (12.2.1.3.0) E90311-03 |
|
 前 |
 次 |
Oracle HTTP Serverログの管理には、サーバー・ログの構成、エラーの原因とその修正アクションの表示などが含まれます。
Oracle HTTP Serverでは、すべてのタイプのイベントを記録したメッセージが含まれるログ・ファイルが生成されます。これには、起動と停止の情報、エラー、警告メッセージ、HTTPリクエストに関するアクセス情報、および追加情報が含まれます。
この章の内容は、次のとおりです。
Oracle HTTP Serverには、エラー・ログとアクセス・ログの2つのタイプのサーバー・ログがあります。エラー・ログ・ファイルにはサーバーの問題が記録され、アクセス・ログ・ファイルにはアクセスされているコンポーネントおよびアプリケーションの詳細と誰によるものかが記録されます。
Oracle Fusion Middlewareのログ・ファイルは、Fusion Middleware Controlまたはテキスト・エディタのいずれかを使用して表示できます。Oracle HTTP Serverのログ・ファイルは、次のディレクトリに存在します。
ORACLE_HOME/user_projects/domains/<base_domain>/servers/componentName/logs
この項の内容は次のとおりです。
Oracle HTTP Serverでは、ログ・メッセージを生成する形式を選択できます。レガシーのApache HTTP Serverメッセージ形式でログ・メッセージを生成するか、エラー・ログ・メッセージ生成用のOracle標準に準拠するOracle Diagnostic Logging (ODL)を使用してテキストまたはXML形式のログにログ・メッセージを生成するかを選択できます。
デフォルトでは、Oracle HTTP Serverエラー・ログでは診断メッセージの生成用にODLが使用されます。これにより、すべての診断メッセージおよびログ・ファイルのための共通書式と、Oracle Fusion Middleware全体の様々なコンポーネントからの診断メッセージを相互に関係付ける仕組みが提供されます。
エラー・ログ・ファイルのデフォルト名は、instance_name.logです。
ノート:
ODLエラー・ロギングでは各仮想ホスト用に別個のログ・ファイルを持たせることはできません。グローバルにすべての仮想ホスト用に構成できるのみです。
アクセス・ログには、サーバーによって処理されたすべてのリクエストが記録されます。このログには、サーバーで処理されたすべてのHTTPトランザクションに関する基本情報が含まれます。アクセス・ログに含まれる情報は、次のとおりです。
ホスト名
リモート・ログ名
リモート・ユーザーおよび時間
リクエスト
レスポンス・コード
転送バイト数
アクセス・ログ・ファイルのデフォルト名は、access_logです。
アクセス・ログの形式
管理者は、アクセス・ログに含める情報とその書込み方法を指定できます。デフォルトの形式は共通ログ形式(CLF)です。
LogFormat "%h %l %u %t %E \"%r\" %>s %b" common
CLF形式には、次のフィールドが含まれます。
host ident remote_logname remote_usre date ECID request authuser status bytes
host: クライアントのドメイン名またはIPアドレスログにホスト・フィールドを指定するには、%hを使用します。
ident: IdentityCheckが有効で、クライアント・システムによりidentdが実行されている場合のクライアントのアイデンティティ情報。ログにクライアント・アイデンティティ・フィールドを指定するには、%iを使用します。
remote_logname: リモート・ログ名(提供された場合、identdから)。ログにリモート・ログ名を指定するには、%lを使用します。
remote_user: リクエストが認証された場合のリモート・ユーザー。ログにリモート・ユーザーを指定するには、%uを使用します。
date: day/month/year:hour:minute:second書式のリクエスト日時。ログに日時を指定するには、%tを使用します。
ECID: ECID情報を取得します。ログのECIDを取得するには、%Eを使用します。ECID情報用アクセス・ログの構成も参照してください。
request: 二重引用符で囲まれたクライアントからのリクエスト行ログにリクエストを指定するには、%rを使用します。
authuser: 認可ユーザーのユーザーID。ログに認可ユーザー・フィールドを指定するには、%aを使用します。
status: クライアントに戻される3桁のステータス・コードログにステータスを指定するには、%sを使用します。リクエストが別のサーバーから転送される場合、ログに最後のサーバーを指定するには、%>sを使用します。
bytes: ヘッダーを除き、クライアントに返されるバイト数ログにバイト数を指定するには、%bを使用します。ログにヘッダーを含めるには、%iを使用します。
関連項目:
Apache HTTP Serverドキュメントの「Access Log」
Oracle HTTP Serverでは、サイズベースと時間ベースの2種類のログ・ローテーション・ポリシーをサポートしています。ORACLE_HOME/ohs/binにあるodl_rotatelogsを使用することで、2つのローテーション・ポリシーのいずれかを使用するようにOracle HTTP Serverログを構成することができます。デフォルトでは、Oracle HTTP Serverではエラー・ログとアクセス・ログの両方に対してodl_rotatelogsを使用します。
odl_rotatelogsは、Apache HTTP Serverのrotatelogsのすべての機能と、ログ保存の追加機能をサポートします。
rotatelogsによって提供される機能とオプションに関する情報は、次のURLで参照できます。
http://httpd.apache.org/docs/2.4/programs/rotatelogs.html
odl_rotatelogsの一般構文は次のとおりです。
odl_rotatelogs [-u:offset] logfile {size-|time-based-rotation-options}
odl_rotatelogsは、パイプ化されたログファイル機能で使用されます。この機能により、エラーおよびアクセス・ログ・ファイルが、ファイルに直接ではなく、別のプロセスへのパイプを通じて書き込むことができます。これによりロギングの柔軟性が高まるため、メイン・サーバーにコードを追加する必要はありません。ログをパイプに書き込むには、ファイル名を縦線「|」で置き換え、続けて標準入力でログ入力を受け入れる実行可能ファイルの名前を指定します。パイプ化されたログファイル機能の詳細は、次のURLを参照してください。
http://httpd.apache.org/docs/2.4/logs.html#piped
パイプ化されたログファイル機能とともに使用される、odl_rotatelogsの構文は次のようになります。
CustomLog " |${PRODUCT_HOME}/bin/odl_rotatelogs [-u:offset] logfile {size-|time-based-rotation-options}" log_format
odl_rotatelogsへの入力があるたびに、指定したローテーションの条件に合っているかがチェックされます。合っていれば、ファイルをローテーションします。合っていなければ、単にコンテンツに書き込みます。何も入力されていない場合は、何も起こりません。
表8-1にサイズベースおよび時間ベースのローテーションのオプションを示します。
表8-1 odl_rotatelogsのオプション
| オプション | 説明 |
|---|---|
|
UTCからオフセットする時間(秒)。 |
|
ログ・ファイルのパスと名前、その後にハイフン(-)そしてタイムスタンプ・フォーマットが続きます。 次に一般的なタイムスタンプ・フォーマット文字列を示します。
スラッシュを含むまで拡張されるフォーマットを含むことはできません。 |
|
ログ・ファイルのローテーションの間の時間(秒)。 |
|
ローテーションされたログ・ファイルが保存される最大時間。 |
|
時間ベースのローテーションが開始する時間。 |
|
ログ・ファイルの最大サイズ(MB)。 |
|
保存されたファイルの合計サイズ(MB)。 |
時間ベースのローテーションの場合、odl_rotatelogsを使用したOracle HTTP Serverのログ・ローテーションは、デフォルトではUTC時間に従って計算されます。たとえば、ログ・ローテーションを86400 (24時間)に設定すると、UTCで真夜中の12:00になるたびにログがローテーションされます。Oracle HTTP Serverがインド標準時(IST)で実行されている場合、ISTはUTC+05:30であるので、ログは午前05:30にローテーションされます。
UTCオフセットに対して-uオプションを使用するかわりに、Apacheによって提供される-lオプションを使用することもできます。このオプションの場合、Oracle HTTP Serverでは間隔の基準としてローカル時間が使用されます。UTCオフセットを変更した環境(英国標準時(BST)またはサマータイム(DST)など)で-lオプションを使用すると、予測できない結果につながる可能性があります。
次の例で、時間ベースとサイズベースのログのローテーションを設定するodl_rotatelogsの構文を示します。
時間ベースのローテーション
構文:
odl_rotatelogs u:offsetlogfilefrequencyretentionTimestartTime
例:
CustomLog "| odl_rotatelogs u:-18000/varlog/error.log-%Y-%m-%d216001728002014-03-10T08:30:00" common
これは、UTC-05:00 (18000 秒、ニューヨークなど)の場所に対して実行されるログ・ローテーションを構成します。このローテーションは、2014年3月10日の午前8時30分から21600秒(6時間)ごとに実行され、ローテーションされたログ・ファイルを172800秒(2日)間保存するように指定します。ログの形式はcommonです。
構文:
odl_rotatelogs logfile frequency retentionTime startTime
例:
CustomLog "| odl_rotatelogs /varlog/error.log-%Y-%m-%d 21600 172800 2014-03-10T08:30:00" common
これは、2014年3月10日の午前8時30分から21600秒(6時間)ごとにログ・ローテーションを実行するように構成し、ローテーションされたログ・ファイルを172800秒(2日)間保存するように指定します。ログの形式はcommonです。
サイズベースのローテーション
構文:
odl_rotatelogs logfile maxFileSize allFileSize
例:
これは、ログ・ファイルのサイズが10 MBに達するとログ・ローテーションを実行するように構成し、ローテーションされたすべてのログ・ファイルの最大サイズを70 MBと指定します(最大7個のログ・ファイル(=70/10)が保存されます)。ログの形式はcommonです。
CustomLog "| odl_rotatelogs /var/log/error.log-%Y-%m-%d 10M 70M" common
Fusion Middleware Controlを使用してエラー・ログとアクセス・ログを構成できます。
次の各項では、「ログ構成」ページから設定できるログ・タスクについて説明します。
Fusion Middleware Controlの「ログ構成」ページでエラー・ログを構成します。Fusion Middleware Controlを使用してOracle HTTP Serverのエラー・ログを構成するには、次の手順を実行します。
「ログ構成」ページが表示されます(次の図を参照)。
Fusion Middleware Controlの「ログ構成」ページでエラー・ログの形式および場所を変更できます。デフォルトで、Oracle HTTP Serverはエラー・ログ形式としてODL-Textを使用し、DOMAIN_HOME/servers/component_name/logsディレクトリ内にcomponent_name.logという名前のログ・ファイルを作成します。別の形式またはログ場所を使用するには、次の手順を実行します。
ログ・ファイルに書き込まれる情報の量とタイプは、メッセージのタイプおよびレベルを指定することによって構成できます。Oracle HTTP Serverのエラー・ログ・レベルは、デフォルトで「WARNING:32」に構成されています。別のエラー・ログ・レベルを使用するには、次の手順を実行します。
ノート:
Apache HTTP Serverログ形式用とODL-Text形式用のログ・レベルは異なります。
ODLログ・レベルの詳細は、Oracle Fusion Middlewareの管理のログ・ファイルに書き込まれる情報レベルの設定を参照してください。
Apache HTTP Serverのログ・レベルの詳細は、Apache HTTP ServerドキュメントのLogLevelディレクティブに関する項を参照してください。
Fusion Middleware Controlの「ログ構成」ページから、Oracle HTTP Server用のアクセス・ログの形式および場所を構成できます。
このページからは、次のアクセス・ログ構成タスクを設定できます。
ログ形式は、アクセス・ログに含める情報とその書込み方法を指定するものです。新規のアクセス・ログ形式を追加したり、既存の形式を編集または削除するには、次の手順を実行します。
「カスタム・アクセス・ログ形式の管理」ページが表示されます(次の図を参照)。
Oracle HTTP Serverインスタンスを起動する前に、デフォルトのファイル・モード作成マスク(umask)の値を設定します。umaskに設定する値により、エラー・ログ、アクセス・ログなどの、Oracle HTTP Serverインスタンスにより作成されるファイルのアクセス権が決まります。umaskが明示的に設定されていない場合、デフォルトで0027の値が使用されます。
この項の内容は次のとおりです。
スタンドアロン・ドメインでデフォルトのファイル・モード作成マスクを構成するには、ステージング場所のohs.plugins.nodemanager.propertiesファイルのumaskプロパティを設定します。
DOMAIN_HOME/config/fmwconfig/components/OHS/instanceName/ohs.plugins.nodemanager.properties
WLSTコマンドを使用して、エラー・ログの冗長度を制御する、LogLevelディレクティブを設定できます。
LogLevelディレクティブの詳細は、Apacheのドキュメント(http://httpd.apache.org/docs/current/mod/core.html#loglevel)を参照してください
次のステップに従い、WLSTコマンドを使用してLogLevelディレクティブを設定します。
Oracle HTTP Serverは、診断メッセージを生成するためのOracle Diagnostic Logging (ODL)またはレガシーのApache HTTP Serverメッセージ形式のいずれかを使用するように構成できます。
次の項では、httpd.confファイル内のOracle HTTP Serverのエラー・ログおよびアクセス・ログに関連するディレクティブについて説明します。
Oracle HTTP Serverはデフォルトで、診断メッセージの生成にOracle Diagnostic Logging (ODL)を使用します。ODLを使用したロギングを設定する場合、次のディレクティブを使用します。
これにより、ログ・メッセージを生成する形式を選択できます。レガシーのApache HTTP Server形式またはODLテキスト形式でログ・メッセージを生成するように選択できます。
OraLogMode Apache | ODL-Text
デフォルト値: ODL-Text
たとえば: OraLogMode ODL-Text
ノート:
Apache HTTP Serverログ・ディレクティブのErrorLogおよびLogLevelは、OraLogModeがApacheに設定されている場合のみ有効です。OraLogModeがODL-Textに設定されている場合、ErrorLogおよびLogLevelディレクティブは無視されます。
すべてのログ・ファイルが含まれるディレクトリへのパスを指定します。このディレクトリは存在している必要があります。
このディレクティブは、OraLogModeがODL-Textに設定されている場合にのみ使用されます。OraLogModeがApacheに設定されている場合、OraLogDirは無視され、かわりにErrorLogが使用されます。
OraLogDir <path>
デフォルト値: ORACLE_INSTANCE/servers/componentName/logs
たとえば: OraLogDir /tmp/logs
メッセージ重大度を設定できます。このディレクティブを使用して指定したメッセージ重大度は、必要な最低レベルのメッセージ重大度として解釈され、その重大度以上のメッセージはすべてログに記録されます。
このディレクティブは、OraLogModeがODL-Textに設定されている場合にのみ使用されます。OraLogModeがApacheに設定されている場合、OraLogSeverityは無視され、かわりにLogLevelが使用されます。次の構文で、short_module_identifierNameは末尾の_moduleが省略されたモジュール名です。
OraLogSeverity [short_module_identifierName] <msg_type>[:msg_level]
デフォルト値: WARNING:32
たとえば: OraLogSeverity mime NOTIFICATION:32
msg_type
メッセージ・タイプは大文字でも小文字でも指定できますが、メッセージ出力は大文字で表示されます。このパラメータは、次のいずれかの値にする必要があります。
INCIDENT_ERROR
ERROR
WARNING
NOTIFICATION
TRACE
msg_level
このパラメータは1から32の整数にする必要があります。重大度が最も高いのが1で、最も低いのが32です。レベル1を使用した方が、レベル32を使用した場合よりもメッセージが少なくなります。
エラー・ログ・ファイルのローテーション・ポリシーを選択できます。このディレクティブは、OraLogModeがODL-Textに設定されている場合にのみ使用されます。OraLogModeがApacheに設定されている場合、OraLogRotationParamsは無視されます。
OraLogRotationParams <rotation_type> <rotation_policy>
デフォルト値: S 10:70
たとえば: OraLogRotationParams T 43200:604800 2009-05-08T10:53:29
rotation_type
このパラメータはS(サイズベースのローテーション)またはT(タイムベースのローテーション)のいずれかです。
rotation_policy
rotation_typeがS(サイズベース)に設定されている場合は、rotation_policyパラメータを次のように設定します。
maxFileSize:allFilesSize (MB)
たとえば、10:70として構成した場合、エラー・ログ・ファイルが10MBに達するたびにローテーションが行われます。また、すべてのエラー・ログ・ファイルの合計として70MBが許可されます(最大で70/10=7個のエラー・ログ・ファイルが保存されます)。
rotation_typeがT(タイムベース)に設定されている場合は、rotation_policyパラメータを次のように設定します。
frequency(in sec) retentionTime(in sec) startTime(in YYYY-MM-DDThh:mm:ss)
たとえば、43200:604800 2009-05-08T10:53:29として構成した場合、エラー・ログは43200秒(12時間)ごとにローテーションが行われます。ローテーションされたログ・ファイルは、2009年5月5日の10時53分29秒から最大で604800秒(7日)間保存されます。
Oracle HTTP Serverではデフォルトでエラー・ログにODLが使用されますが、エラー・ログ・メッセージがレガシーのApache HTTP Serverメッセージ形式で生成されるようにOraLogModeディレクティブをApacheに構成することもできます。この項では、次のディレクティブについて説明します。
ErrorLogディレクティブは、サーバーにより検出されたエラーが書き込まれるファイル名を設定します。ファイルパスが絶対パスでない場合は、ServerRootからの相対パスであると想定されます。
このディレクティブは、OraLogModeがApacheに設定されている場合にのみ使用されます。OraLogModeがODL-Textに設定されている場合、ErrorLogは無視され、かわりにOraLogDirが使用されます。
関連項目:
Apache ErrorLogディレクティブの詳細は、次を参照してください。
LogLevelディレクティブは、エラー・ログに記録されるメッセージの冗長性を調整します。
このディレクティブは、OraLogModeがApacheに設定されている場合にのみ使用されます。OraLogModeがODL-Textに設定されている場合、LogLevelは無視され、かわりにOraLogSeverityが使用されます。
関連項目:
Apache HTTP Server LogLevelディレクティブの詳細は、次を参照してください。
LogFormatディレクティブは、アクセス・ログ・ファイルの形式を指定します。デフォルトでは、Oracle HTTP Serverには次の4つのアクセス・ログ形式が定義されています。
LogFormat "%h %l %u %t %E \"%r\" %>s %b" commonLogFormat "%h %l %u %t %E \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combinedLogFormat "%h %l %u %t %E \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
関連項目:
Apache HTTP Server LogFormatディレクティブの詳細は、次を参照してください。
http://httpd.apache.org/docs/current/mod/mod_log_config.html#logformat
CustomLogディレクティブは、サーバーへのリクエストをログに記録する場合に使用します。ログ形式を指定し、オプションで環境変数を使用して、リクエストの特性に基づいてロギングを条件付きで実行することもできます。デフォルトでは、アクセス・ログ・ファイルは共通ログ形式を使用するように構成されています。
関連項目:
Apache CustomLogディレクティブの詳細は、次を参照してください。
http://httpd.apache.org/docs/current/mod/mod_log_config.html#customlog
サーバー・ログは、Fusion Middleware Control、WLSTまたはテキスト・エディタを使用して確認できます。
Oracle HTTP Serverにはエラー・ログとアクセス・ログの主に2種類のログ・ファイルがあります。エラー・ログ・ファイルは、サーバーのパフォーマンスを良好に保つための重要な情報源です。エラー・ログには、システム管理者が問題を簡単に診断して修正できるように、問題の状況に関するすべての情報が記録されます。アクセス・ログ・ファイルには、サーバーが処理するあらゆるHTTPトランザクションの基本情報が含まれます。この情報を使用して、サーバーの使用状況パターンに関する統計レポートを生成できます。
エラー・ログおよびアクセス・ログの詳細は、サーバー・ログの概要を参照してください。
この項では、Oracle HTTP Serverログを表示する方法について説明します。
Oracle HTTP Serverインスタンスのログ・メッセージにアクセスするには:
ログ・ファイルの検索および表示の詳細は、Oracle Fusion Middlewareの管理のFusion Middleware Controlを使用したログ・ファイルとそのメッセージの表示を参照してください。
コマンド行からサーバーのログの取得と表示を行うには、ノード・マネージャに接続して、適切なWebLogic Scripting Tool (WLST)コマンドを発行する必要があります。これらのコマンドを使用して、次のような機能のいずれかを実行できます。
サーバー・ログのリスト表示。
特定のログの内容を表示。
ノート:
WLSTの使用方法の詳細は、『WebLogic Scripting Toolの理解』を参照してください。
この手順を実行してみる前に、次の内容を実行します。
コマンド行からサーバー・メトリックにアクセスを試みる前に、次の内容を確認してください。
ドメインが存在すること。
使用するインスタンスが存在すること。
インスタンスのマシン上でノード・マネージャが実行中であること。
この手順を使用するには、インスタンスと管理サーバーが動作中でも構いませんが、その必要はありません。
WLSTを使用してメトリックを表示するには:
ノート:
管理対象のドメインでは、この手順は、インスタンスが動作状態であるか停止状態であるかによって、管理マシンあるいはリモート・マシンで動作している管理サーバー上で動作します。スタンドアロン・ドメインでは、手順はローカル・マシン上でしか動作しませんが、インスタンスは動作中と停止中のいずれであっても構いません。
Oracle HTTP Serverログを、実行コンテキストID (ECID)の情報が記録されるように構成できます。
次の項では、エラー・ログおよびアクセス・ログに実行コンテキストID (ECID)情報を記録する方法について説明します。
ECIDとは、Oracleコンポーネント間のリクエストにアタッチ可能なグローバルに一意のIDです。ECIDを使用すると、複数のリクエストが並行して処理される場合に同じリクエストに関する複数のログ・メッセージを追跡できます。
Oracle HTTP Serverモジュールmod_contextは、URIまたはCookieの中のECID-ContextキーあるいはECID-Contextヘッダーに対する受信リクエストをそれぞれスキャンします。見つかった場合には、有効であれば値を実行コンテキストとして使用します。見つからなかった場合には、mod_contextはリクエストに対して新たな実行コンテキストを生成し、ECID-Contextヘッダーの値として加算します。
ECID情報は、Oracle Diagnostic Logging (ODL)の一部として記録されます。ODLは、診断メッセージおよびログ・ファイルのための共通書式を示す診断メッセージを生成する方法と、様々なコンポーネントからのすべての診断メッセージを相互に関係付ける方法です。
ECIDが記録されるようにOracle HTTP Serverのエラー・ログを構成するには、httpd.conf内のOraLogModeディレクティブを、デフォルト値であるodlに必ず設定してください。odl値は標準のApacheログ書式で、特に1つのリクエストに関連付けられたログ記録用のECID情報です。
OraLogModeおよびこのディレクティブに対する他に取りうる値の詳細は、OraLogModeを参照してください。
ノート:
モジュール固有のロギング重大度を有効にして初めてモジュールがロギングを実行できるように、これらのディレクティブは、httpd.confファイルでモジュールがロードされる前に(LoadModuleディレクティブの前に)指定することをお薦めします。
デフォルトで、httpd.confファイルのLogFormatディレクティブは、ECID情報を取得するように構成されています。
LogFormat "%h %l %u %t %E \"%r\" %>s %b" common
マイクロ秒単位で測定するレスポンス時間を追加する場合、次のように%Dを追加します。
LogFormat "%h %l %u %t %E %D \"%r\" %>s %b" common
ECID情報の取得を抑制するには、LogFormatディレクティブから%Eを削除します。
LogFormat "%h %l %u %t \"%r\" %>s %b" common
