Hitachi

Cosminexus V11 アプリケーションサーバ Cosminexus HTTP Server


4.2.4 ログファイルをラップアラウンドさせて使用する(rotatelogs2プログラム)

アクセスログ,エラーログ,リクエストログをログファイルサイズで分割して,複数のファイルにラップアラウンドして出力できます。rotatelogs2プログラムは次のディレクティブに指定できます。

プログラムの指定方法を次に示します。

〈この項の構成〉

(1) 形式

rotatelogs2 ログファイルプリフィックス名 ログファイルサイズ ログファイル個数

(2) オペランド

(3) 使用方法

ディレクティブに,"|プログラム名"の形式で指定して使用します。

(例)4,096KBごとにエラーログを最大5個採取する場合
ErrorLog "|\"\"<Application Serverのインストールディレクトリ>/httpsd/sbin/rotatelogs2.exe\" \"<Application Serverのインストールディレクトリ>/httpsd/logs/errorlog\" 4096 5\""

errorlog.001〜errorlog.005の順番にログが出力されます。errorlog.005が4,096KBを超えるとerrorlog.001をクリアして続きが出力されます。HTTP Server起動時に,すでにこれらのログファイルがある場合には,更新時刻の最も新しいログファイルが出力対象のログファイルとなります。このログファイルのサイズがすでに4,096KBを超えている場合には,次のログファイルをクリアして続きが出力されます。4,096KBを超えない場合は,このファイルの続きに出力されます。

(4) 注意事項

(a) UNIX版の注意事項

  • rotatelogs2プログラムはSIGTERM,SIGUSR1およびSIGHUPシグナルを受信してもプロセス終了処理を実施しませんが,制御プロセスとサーバプロセスが終了すればプロセス終了します。

(b) Windows版の注意事項

  • Webサーバはサービスとして起動してください。サービスとして起動しない場合,Webサーバの停止または再起動の際に,不当にログファイルがクリアされることがあります。

  • インデクス番号格納用ファイルは,rotatelogs2プログラムが動作中の間は絶対に編集や削除をしないでください。編集するとログが正しく出力されないことがあります。

  • Webサーバの起動時にインデクス番号格納用ファイル「プリフィックス.index」と同名のファイルが存在した場合,ファイルは上書きされます。

  • 起動時に引数誤りなどがあった場合にWebサーバは起動しますが,rotatelogs2プログラムは起動しません。その際,rotatelogs2プログラムではイベントログに次に示す属性を持ったメッセージを出力します。

    • 種類:エラー

    • ソース:CosminexusHTTPServer

    • 分類:なし

    • イベント:3299

    • 説明:rotatelogs2.exe: (メッセージ)

      出力されたメッセージの意味については,マニュアル「アプリケーションサーバ メッセージ(構築/運用/開発用)」の「21.7.5 rotatelogs2プログラム」を参照してください。

    このメッセージが出力されていた場合,メッセージ内容に従って引数を見直したあとにサーバを再起動してください。なお,同じメッセージが複数回出力されることがあります。

(c) 共通の注意事項

  • ログファイルプリフィックス名は絶対パスで指定してください。

  • HTTP Server起動時の出力ログファイルは,更新日時が最新のものを対象とするため,誤ってファイルを更新した場合は正しいファイルへの出力ができなくなります。

  • ログファイルサイズには,同一秒内に複数のファイルが指定サイズを超えるような小さいサイズを指定しないでください。このようなサイズを指定した場合には,最も新しいログファイル以外が出力対象となり正しくローテーションされなくなることがあります。

  • コンフィグファイル内に,同一のログファイルプリフィックス名を複数個所で指定しないでください。複数個所で指定した場合には,最も新しいログファイル以外が出力対象となり正しくローテーションされなくなることがあります。

  • TransferLog,CustomLog,ErrorLog,およびHWSRequestLogディレクティブのrotatelogs2プログラムの引数指定に誤りがある場合,rotatelogs2プログラムの起動に失敗しますが,Webサーバは起動します。この場合はログが出力されません。TransferLog,CustomLog,ErrorLog,およびHWSRequestLogディレクティブにrotatelogs2プログラムを指定した場合は,ログファイルが作成され,意図した分割が実施されることを確認してください。