プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Traffic Directorの管理
12c (12.2.1)
E70065-01
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次
前
前 		 次
次		  

11 ログの管理

Oracle Traffic Directorのログ・ファイルには、構成の変更、インスタンスの起動および停止、リクエスト処理中のエラーなどのサーバー・イベントに関するデータが記録されます。ログを使用すると、サーバーの問題の診断、サーバーの使用パターンの評価、およびシステムのパフォーマンス向上のためのチューニングを行えます。

この章には次の項が含まれます:

11.1 Oracle Traffic Directorのログについて

管理サーバーを含む各Oracle Traffic Directorインスタンスには、アクセス・ログとサーバー・ログの2つのログがあります。インスタンス・ログはデフォルトで有効化されており、最初にインスタンスが起動されるときに初期化されます。インスタンス・ログに加えて、インスタンス内の各仮想サーバーのアクセス・ログおよびサーバー・ログを有効化できます。

  • Oracle Traffic Directorインスタンスのアクセス・ログおよびサーバー・ログのデフォルトの場所は、DOMAIN_HOME/servers/instance-name/logsディレクトリです。

この項では、アクセス・ログおよびサーバー・ログの概要を説明します。ログ・ファイルの名前および場所などのログ設定の変更の詳細は、11.3項「ログ・プリファレンスの構成」を参照してください。

11.1.1 アクセス・ログ

アクセス・ログには、サーバーへのリクエストおよびサーバーからのレスポンスについての情報が含まれます。アクセス・ログ・ファイルのデフォルト名は、access.logです。

次の例は、典型的なアクセス・ログの最初の3行を示しています。

format=%Ses->client.ip% - %Req->vars.auth-user% [%SYSDATE%] "%Req->reqpb.clf-request%" %Req->srvhdrs.clf-status% %Req->srvhdrs.content-length% %Req->vars.ecid%
10.177.243.207 - - [28/Aug/2011:23:28:30 -0700] "GET / HTTP/1.1" 200 4826 -
10.177.243.207 - - [28/Aug/2011:23:28:31 -0700] "GET / HTTP/1.1" 200 916 -

1行目は、アクセス・ログの形式を示しています。2行目および3行目は、実際のエントリです。

アクセス・ログの形式、ファイル名および場所を変更できます。アクセス・ログを無効化することもできます。詳細は、11.3項「ログ・プリファレンスの構成」を参照してください。

11.1.2 サーバー・ログ

サーバー・ログには、ライフサイクル・イベント(サーバーの起動、シャット・ダウンおよび再起動)、構成の更新などに関するデータが含まれます。また、サーバーで発生したエラーおよび警告も含まれます。サーバー・ログ・ファイルのデフォルト名は、server.logです。

次の行は、サーバー・ログ内のエントリの例です。

[2011-10-03T02:04:59.000-07:00] [net-soa] [NOTIFICATION] [OTD-10358] []
 [pid: 11722] http-listener-1: http://example.com:1904 ready to accept requests

デフォルトのサーバー・ログ・レベルはNOTIFICATION:1であり、主要なライフサイクル・イベント、警告およびエラーのみが記録されます。

ログ・レベル、ログ・ファイル名およびログ・ファイルの場所を変更できます。詳細は、11.3項「ログ・プリファレンスの構成」を参照してください。

表11-1は、サーバー・ログに指定できるログ・レベルを示しています。

表11-1 サーバー・ログ・レベル

ログ・レベル 説明

INCIDENT_ERROR:1

原因不明の重大な問題です。Oracleサポートに連絡する必要があります。

ERROR:1

ERROR:16

ERROR:32

迅速な対処が必要な深刻な問題です。

WARNING:1

確認する必要がある潜在的な問題です。

NOTIFICATION:1 (デフォルト)

サーバーの起動中または再起動中など主要なライフサイクル・イベントです。

TRACE:1

TRACE:16

TRACE:32

ユーザーまたはOracleサポートが特定のサブシステムでの問題を診断するのに役立つトレースまたはデバッグ情報です。

各ログ・レベルの後の番号は、記録されたイベントの重大度を1-32の段階で示したものです。ERROR:1メッセージは、ERROR:16メッセージより重大度が高くなります。

TRACE:32は、最も冗長度の高いログ・レベルで、INCIDENT_ERROR:1は最も冗長度の低いログ・レベルです。TRACEログ・レベルを有効化すると、大量のメッセージが記録されるため、パフォーマンスに影響を及ぼす可能性があります。したがって、問題をデバッグするためにより詳細な情報が必要な場合を除き、本番システムで冗長なログ・レベルを有効化しないようにしてください。

11.2 ログの表示

Fusion Middleware ControlまたはWLSTのいずれかを使用して、Oracle Traffic Directorインスタンスおよび仮想サーバーのアクセス・ログおよびサーバー・ログを表示できます。


注意:

  • WLSTまたはFusion Middleware Controlを使用する以外にも、lsやmoreなどの標準のオペレーティング・システム・コマンドを使用して、ログ・ファイルをリストしたり表示したりできます。

  • Fusion Middleware Controlのログ・ビューアおよびWLSTのdisplayLogsコマンドでは、現在、ディスク上のアクセス・ログ・ファイル、TCPのアクセス・ログ、エラー・ログに存在するログ・エントリのみが表示されます。これらでは、アクセス・ログ・バッファにある項目は表示されません(14.9項「アクセス・ログ・バッファ設定の構成」を参照)。

  • WLSTの使用方法の詳細は、1.7.1項「WebLogic Scripting Toolへのアクセス」を参照してください。

Fusion Middleware Controlを使用したログの表示

Fusion Middleware Controlを使用してノード、インスタンス、インスタンス内の仮想サーバーのログ・データを表示するには、次を実行します。

  1. 1.7.2項「Fusion Middleware Controlの表示」の説明に従ってFusion Middleware Controlにログインします。

  2. ページの左上隅にある「WebLogicドメイン」ボタンをクリックします。

  3. 「管理」→「OTD構成」を選択します。

    使用可能な構成のリストが表示されます。

  4. ログを表示する構成を選択します。

  5. 「共通タスク」ペインの「Traffic Director構成」をクリックします。

  6. 「管理」→「ロギング」を選択します。

  7. Oracle Traffic Directorのログ・ビューア・ウィンドウが表示されます。

  8. サーバー・ログ・プリファレンス、アクセス・ログ・プリファレンスおよびTCPアクセス・ログ・プリファレンスをリストするタブが表示されます。

    • サーバー・ログを表示するには、「サーバー・ログ・プリファレンス」タブを選択します。

    • アクセス・ログを表示するには、「アクセス・ログ・プリファレンス」タブを選択します。

    • TCPのアクセス・ログを表示するには、「TCPアクセス・ログ・プリファレンス」タブを選択します。

WLSTを使用したログの表示

  • インスタンスまたは仮想サーバーのアクセス・ログを表示するには、displayLogsコマンドを実行します。

    たとえば、次のコマンドでは、構成fooのインスタンスのアクセス・ログ・レコードが表示されます。

    displayLogs(target="sc:otd_foo_machine1")

displayLogsの詳細は、『Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

11.3 ログ・プリファレンスの構成

構成を作成すると、サーバー・ログおよびアクセス・ログが、特定のデフォルト設定で有効化されます。サーバー・ログのレベル、ファイル名および場所を変更できます。アクセス・ログの形式、ファイル名および場所を変更できます。アクセス・ログを無効化することもできます。サーバー・ログの場所を変更する場合、インスタンスを再起動して変更を有効にする必要があります。

構成内に定義されたログ・プリファレンスは、構成内のすべての仮想サーバーに適用されます。仮想サーバー・レベルで、アクセス・ログの場所や形式、およびサーバー・ログの場所を定義できます。

Fusion Middleware ControlまたはWLSTのいずれかを使用して、Oracle Traffic Directorインスタンスのログ・プリファレンスを構成できます。


注意:

WLSTの起動の詳細は、1.7.1項「WebLogic Scripting Toolへのアクセス」を参照してください。

Fusion Middleware Controlを使用したログ・プリファレンスの構成

Fusion Middleware Controlを使用して構成または仮想サーバーのログ・プリファレンスを構成するには、次を実行します。

  1. 1.7.2項「Fusion Middleware Controlの表示」の説明に従ってFusion Middleware Controlにログインします。

  2. ページの左上隅にある「WebLogicドメイン」ボタンをクリックします。

  3. 「管理」→「OTD構成」を選択します。

    使用可能な構成のリストが表示されます。

  4. ログ・プリファレンスを構成する構成を選択します。

  5. 「共通タスク」ペインの「Traffic Director構成」をクリックします。

  6. 「管理」→「ロギング」を選択します。

  7. Oracle Traffic Directorのログ・ビューア・ウィンドウが表示されます。

  8. サーバー・ログ・プリファレンス、アクセス・ログ・プリファレンスおよびTCPアクセス・ログ・プリファレンスをリストするタブが表示されます。

    • サーバー・ログを表示するには、「サーバー・ログ・プリファレンス」タブを選択します。

    • アクセス・ログを表示するには、「アクセス・ログ・プリファレンス」タブを選択します。

    • TCPのアクセス・ログを表示するには、「TCPアクセス・ログ・プリファレンス」タブを選択します。

  9. 各タブ内で、変更するパラメータを指定します。

    画面上のヘルプおよびプロンプトがすべてのパラメータに提供されています。

    カスタムのアクセス・ログ形式指定の詳細は、『Oracle Traffic Director構成ファイル・リファレンス』 のカスタムのアクセス・ログ形式の使用に関する項を参照してください。

    フィールドの値を変更する、または変更したテキスト・フィールドからタブアウトすると、ページの右上隅にある「適用」ボタンが有効になります。

    「元に戻す」ボタンをクリックすることで、いつでも変更を破棄できます。

  10. 必要な変更を行った後、「適用」をクリックします。

    • 更新された構成が保存されたことを確認するメッセージが、「コンソール・メッセージ」ペインに表示されます。

WLSTを使用したログ・プリファレンスの構成

  • 構成または仮想サーバーの現在のアクセス・ログ・プリファレンスを表示するには、getConfigurationAccessLogPropertiesまたはotd_getVirtualServerAccessLogPropertiesコマンドを実行します。

    たとえば、次のコマンドでは、構成fooのアクセス・ログ・プリファレンスが表示されます。

    props = {}
props['configuration'] = 'foo'
otd_getConfigurationAccessLogProperties(props)

log-file=$DOMAIN_HOME/servers/$INSTANCE_NAME/logs/access.log
format=%Ses->client.ip% - %Req->vars.auth-user% %SYSDATE% "%Req->reqpb.clf-request%" %Req->srvhdrs.clf-status% %Req->srvhdrs.content-length% %Req->vars.ecid% %Req->vars.origin-server%
default-access-log-format=%Ses->client.ip% - %Req->vars.auth-user% %SYSDATE% "%Req->reqpb.clf-request%" %Req->srvhdrs.clf-status% %Req->srvhdrs.content-length% %Req->vars.ecid% %Req->vars.origin-server%

  • 構成または仮想サーバーの現在のアクセス・ログ・プリファレンスを設定または変更するには、setConfigurationAccessLogPropertiesまたはotd_setVirtualServerAccessLogPropertiesコマンドを実行します。

    たとえば、次のコマンドでは、構成fooのアクセス・ログの場所がlogs/access.logに変更されます。

    props = {}
props['configuration'] = 'foo'
props['log-file'] = 'logs/access.log'
otd_setConfigurationAccessLogProperties(props)

    カスタムのアクセス・ログ形式指定の詳細は、『Oracle Traffic Director構成ファイル・リファレンス』 のカスタムのアクセス・ログ形式の使用に関する項を参照してください。

  • 仮想サーバーのアクセス・ログを無効にするには、次の例に示すように、otd_disableVirtualServerAccessLogコマンドを実行します。

    props = {}
props['configuration'] = 'foo'
props['virtual-server'] = 'bar'
otd_disableVirtualServerAccessLog(props)

  • 構成の現在のサーバー・ログ・プリファレンスを表示するには、otd_getLogPropertiesコマンドを実行します。

    たとえば、次のコマンドでは、構成soaのサーバー・ログ・プリファレンスが表示されます。

    props = {}
props['configuration'] = 'foo'
otd_getLogProperties(props)

log-stdout=true
log-stderr=true
log-virtual-server-name=false
create-console=false
log-to-console=true
log-to-syslog=false
log-level=NOTIFICATION:1
log-file=../logs/server.log

  • 構成のサーバー・ログ・プリファレンスを設定または変更するには、otd_setLogPropertiesコマンドを実行します。サーバー・ログの場所を変更する場合、インスタンスを再起動して変更を有効にする必要があることに注意してください。

    たとえば、次のコマンドでは、構成fooのサーバー・ログ・レベルがTRACE:32に変更されます。

    props = {}
props['configuration'] = 'foo'
props['log-level'] = 'TRACE:32'
otd_setLogProperties(props)

この項で説明したWLSTコマンドの詳細は、『Oracle Traffic Director WebLogic Scripting Toolコマンドライン・リファレンス』を参照してください。

11.4 ログ・ローテーションについて

指定した間隔でログを自動的にローテーション(アーカイブ)するようにOracle Traffic Directorを構成できます。また、必要な場合はいつでも、ログを手動でローテーションすることもできます。

ログをローテーションすると、古いログ・ファイルは、ローテーション日付(yyyymmdd形式)および24時間(hhmm)を示す接尾辞で名前が変更されます。たとえば、2011年8月25日午後11時にアーカイブされたサーバー・ログのファイル名は、server-201108252300.logとなります。

ログのローテーション後、サーバー・ログおよびアクセス・ログは再初期化されます。

ログのローテーション方法の詳細は、11.5項「手動によるログ・ローテーション」および11.6項「Oracle Traffic Directorの自動ログ・ローテーションの構成」を参照してください。


注意:

アクセス・ログのローテーション・イベントにより、TCPアクセス・ログもローテーションされます。

11.5 手動によるログ・ローテーション

Fusion Middleware ControlまたはWLSTのいずれかを使用して、Oracle Traffic Directorインスタンスのサーバーおよびアクセス・ログを手動でローテーションできます。古いログ・ファイルはサーバーに保存され、保存済ファイルは保存時の日時を含む名前を使用してマークされます。


注意:

WLSTの起動の詳細は、1.7.1項「WebLogic Scripting Toolへのアクセス」を参照してください。

Fusion Middleware Controlを使用したログの手動ローテーション

Fusion Middleware Controlを使用してログをローテーションするには、次を実行します。

  1. 1.7.2項「Fusion Middleware Controlの表示」の説明に従ってFusion Middleware Controlにログインします。

  2. ページの左上隅にある「WebLogicドメイン」ボタンをクリックします。

  3. 「管理」→「OTD構成」を選択します。

    使用可能な構成のリストが表示されます。

  4. ログをローテーションする構成を選択します。

  5. 「共通タスク」ペインの「Traffic Director構成」をクリックします。

  6. 「管理」→「ログ・ローテーション」を選択します。

  7. Oracle Traffic Directorの「ログ・ローテーション」ウィンドウが表示されます。

  8. Oracle Traffic Directorで、ローテーションされたログ・ファイルに対し特定のコマンドを実行するには、「アーカイブ・コマンド」フィールドで、必要なコマンドへの絶対パスを指定します。

    1. たとえば、アーカイブ・コマンドとして/usr/bin/gzipを指定した場合、ログのローテーション後、Oracle Traffic Directorでは、次のコマンドを実行してローテーションされたログ・ファイルを圧縮します。

      $ /usr/bin/gzip access-yyyymmddhhmm.log
$ /usr/bin/gzip server-yyyymmddhhmm.log

    2. 「ログを今すぐローテーション」をクリックします。

      構成のすべてのインスタンスに対して、仮想サーバー固有のログを含むサーバー・ログおよびアクセス・ログがアーカイブされます。

    選択した構成の特定のインスタンスのログをローテーションするには、次の操作を行います。

    1. ナビゲーション・ペインで、「インスタンス」を選択します。

      「インスタンス」ページが表示されます。

    2. 必要なインスタンスの「ログのローテーション」ボタンをクリックします。

      選択したインスタンスに対して、仮想サーバー固有のログを含むサーバー・ログおよびアクセス・ログがアーカイブされます。

    「コンソール・メッセージ」ペイン、にログがローテーションされたことを確認するメッセージが表示されます。

WLSTを使用したログの手動ローテーション

インスタンスのログをローテーションするには、otd_rotateLogコマンドを実行します。たとえば、次のコマンドでは、otd_foo_machine1インスタンスのアクセスおよびサーバー・ログがローテーションされます。

props = {}
props['instance'] = 'otd_foo_machine1'
otd_rotateLog(props)

注意:

Oracle Traffic Directorで、ローテーションされたログ・ファイルに対して特定のコマンドを実行するには、次の例に示すように、otd_setLogPropertiesコマンドを実行して、必要なコマンドへの絶対パスを指定するarchive-commandプロパティを指定します。 
props = {}
props['configuration'] = 'foo'
props['archive-command] = '/usr/bin/gzip'
otd_setLogProperties(props)

この例では、ログのローテーション後、次のコマンドにより、ローテーションされたログ・ファイルがOracle Traffic Directorで圧縮されます。

$ /usr/bin/gzip access-yyyymmddhhmm.log
$ /usr/bin/gzip server-yyyymmddhhmm.log

otd_rotateLogおよびotd_setLogPropertiesの詳細は、『Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

11.6 Oracle Traffic Directorにおけるログ・ローテーションの自動化の構成

ログ・ローテーション・イベントを作成し、指定した時間または間隔で、ログを自動的にローテーションするようにOracle Traffic Directorを構成できます。

Fusion Middleware ControlまたはWLSTのいずれかを使用して、ログ・ローテーション・イベントを作成できます。


注意:

WLSTの起動の詳細は、1.7.1項「WebLogic Scripting Toolへのアクセス」を参照してください。

Fusion Middleware Controlを使用したログ・ローテーション・イベントの作成

Fusion Middleware Controlを使用してログ・ローテーション・イベントを作成するには、次を実行します。

  1. 1.7.2項「Fusion Middleware Controlの表示」の説明に従ってFusion Middleware Controlにログインします。

  2. ページの左上隅にある「WebLogicドメイン」ボタンをクリックします。

  3. 「管理」→「OTD構成」を選択します。

    使用可能な構成のリストが表示されます。

  4. ログをローテーションする構成を選択します。

  5. 「共通タスク」ペインの「Traffic Director構成」をクリックします。

  6. 「管理」→「ログ・ローテーション」を選択します。

  7. Oracle Traffic Directorの「ログ・ローテーション」ウィンドウが表示されます。

  8. Oracle Traffic Directorで、ローテーションされたログ・ファイルに対し特定のコマンドを実行するには、「アーカイブ・コマンド」フィールドで、必要なコマンドへの絶対パスを指定します。

    たとえば、アーカイブ・コマンドとして/usr/bin/gzipを指定した場合、ログのローテーション後、Oracle Traffic Directorでは、次のコマンドを実行してローテーションされたログ・ファイルを圧縮します。

    $ /usr/bin/gzip access-yyyymmddhhmm.log
$ /usr/bin/gzip server-yyyymmddhhmm.log

  9. 「作成」をクリックします。

    「新規ログ・ローテーション・イベント」ダイアログ・ボックスが表示されます。

  10. このイベントがサーバー・ログ用かまたはアクセス・ログ用かを指定します。

  11. ログを更新する間隔または時刻を指定し、「OK」をクリックします。

    • イベントの作成を確認するメッセージが、「コンソール・メッセージ」ペインに表示されます。

    • 新規イベントが「ログ・ローテーション・イベント」リストに表示されます。

      • 新しいイベントはデフォルトで有効になっています。ステータスを変更するには、「有効化/無効化」チェック・ボックスを選択します。

      • イベントを削除するには、「削除」ボタンをクリックします。

WLSTを使用したログ・ローテーション・イベントの作成

ログ・ローテーション・イベントを作成するには、otd_createEventコマンドを実行します。

たとえば、次のコマンドでは、構成fooのすべてのインスタンスのアクセス・ログおよびサーバー・ログを午後12時にローテーションするようにOracle Traffic Directorが構成されます。

props = {}
props['configuration'] = 'foo'
props['event'] = 'event-1'
props['command'] = 'rotate-log'
props['time'] = '12:00'
otd_createEvent(props)

props = {}
props['configuration'] = 'foo'
props['event'] = 'event-1'
props['command'] = 'rotate-access-log'
props['time'] = '12:00'
otd_createEvent(props)

otd_createEventの詳細は、『Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

  前
前 		 次
次
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次