3.4 アクセスログの設定

CustomLogディレクティブに、ahsrlog実行文またはログファイル名を指定することにより、アクセスログのログファイル出力内容を設定します。

アクセスログのログファイル出力内容に応じた設定例を以下に示します。

注意

ログローテーションを行わない場合は、ディスク容量を圧迫する可能性があるため、ログローテーションを行うことを推奨します。ログローテーションを行う場合は、ahsrlog実行文で指定したログファイル数の上限値に達した際に、最も古いログファイルを削除して新しいログファイルを作成します。
メインホスト、バーチャルホスト、または異なるディレクティブに、同じログファイルを指定しないでください。複数Webサーバを運用している場合は、他のWebサーバと同じログファイルを指定しないでください。同一のファイル名を指定すると、ログファイルの内容およびログローテーションの動作を保証できません。
本製品のインストール直後は、CustomLogディレクティブに指定したahsrlogにより、以下のログファイルにログメッセージが出力されます。必要に応じて、ログファイルの格納先を変更できますが、ログファイルの格納先を変更すると、一括情報採取ツール（iscollectinfoコマンド）では採取できないため、別途ログファイルを採取してください。
(インストールパスはデフォルト)
```
C:\Interstage\F3FMahs\logs\accesslog
```
(インストールパスはデフォルト)
```
/var/opt/FJSVahs/logs/accesslog
```
以下の設定例に指定しているログファイル「/opt/FJSVahs/logs/accesslog」は、シンボリックリンクファイルです。ログファイルにシンボリックリンクファイル「/opt/FJSVahs/logs/accesslog」を指定すると、/var/opt/FJSVahs/logs配下にaccesslogファイルが格納されます。

ポイント

ahsrlog実行文を指定して出力させるログファイルは、ahsrlogのオプション指定により、それぞれのログローテーションを以下の5とおりの単位で指定できます。
- 時刻単位（-Tオプション指定時）
- 日付単位（-Cオプション指定時）
- 曜日単位（-Wオプション指定時）
- 日数単位（-dオプション指定時）
- ファイルサイズ単位（-sオプション指定時）
フィルタリング機能が使用できます。SetEnvIfディレクティブを使用して、HTTPリクエストの属性に基づいた環境変数を設定することにより、特定のIPアドレスからのリクエスト、または特定のURLへのリクエストなどのアクセスログを出力しないように設定できます。
出力するログの項目については、「4.2.1 アクセスログ」を参照してください。
出力するログの項目をカスタマイズする場合は、「3.27 メッセージのカスタマイズ」を参照してください。
TransferLogディレクティブを使用して設定することもできます。

■ahsrlog実行文を指定して時刻単位で設定する場合

例

アクセスログのログローテーションを以下の条件で行う場合

ローテーション時刻：09時00分、17時00分
ファイル名：C:\Interstage\F3FMahs\logs\accesslog
ファイル数の上限値：5

CustomLog "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -T \"C:/Interstage/F3FMahs/logs/accesslog\" 0900,1700 5" ahs-analysis

アクセスログのログローテーションを以下の条件で行う場合

ローテーション時刻：09時00分、17時00分
ファイル名：/var/opt/FJSVahs/logs/accesslog
ファイル数の上限値：5

CustomLog "|/opt/FJSVahs/bin/ahsrlog -T /opt/FJSVahs/logs/accesslog 0900,1700 5" ahs-analysis

■ahsrlog実行文を指定して日付単位・時刻指定で設定する場合

例

アクセスログのログローテーションを以下の条件で行う場合

日付：毎月1日、11日、21日
ローテーション時刻：00時00分
ファイル名：C:\Interstage\F3FMahs\logs\accesslog
ファイル数の上限値：5

CustomLog "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -C \"C:/Interstage/F3FMahs/logs/accesslog\" 1,11,21 5" ahs-analysis

アクセスログのログローテーションを以下の条件で行う場合

日付：毎月1日、11日、21日
ローテーション時刻：00時00分
ファイル名：/var/opt/FJSVahs/logs/accesslog
ファイル数の上限値：5

CustomLog "|/opt/FJSVahs/bin/ahsrlog -C /opt/FJSVahs/logs/accesslog 1,11,21 5" ahs-analysis

注意

毎月31日にローテーションを行うように設定しても、31日が存在しない月は、ローテーションが行われません。月末にローテーションを行いたい場合は、1日00時00分にローテーションを行うなどの設定を検討してください。

■ahsrlog実行文を指定して曜日単位・時刻指定で設定する場合

例

アクセスログのログローテーションを以下の条件で行う場合

曜日：毎週月曜日、土曜日
ローテーション時刻：00時00分
ファイル名：C:\Interstage\F3FMahs\logs\accesslog
ファイル数の上限値：5

CustomLog "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -W \"C:/Interstage/F3FMahs/logs/accesslog\" Mon,Sat 5" ahs-analysis

アクセスログのログローテーションを以下の条件で行う場合

曜日：毎週月曜日、土曜日
ローテーション時刻：00時00分
ファイル名：/var/opt/FJSVahs/logs/accesslog
ファイル数の上限値：5

CustomLog "|/opt/FJSVahs/bin/ahsrlog -W /opt/FJSVahs/logs/accesslog Mon,Sat 5" ahs-analysis

■ahsrlog実行文を指定して日数単位で設定する場合

例

アクセスログのログローテーションを以下の条件で行う場合

日数：1日
ローテーション時刻：「Webサーバ起動日の00時00分から日数(1日)×24時間」経過後の次のログ出力時
ファイル名：C:\Interstage\F3FMahs\logs\accesslog
ファイル数の上限値：5

CustomLog "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -d \"C:/Interstage/F3FMahs/logs/accesslog\" 1 5" ahs-analysis

アクセスログのログローテーションを以下の条件で行う場合

日数：1日
ローテーション時刻：「Webサーバ起動日の00時00分から日数(1日)×24時間」経過後の次のログ出力時
ファイル名：/var/opt/FJSVahs/logs/accesslog
ファイル数の上限値：5

CustomLog "|/opt/FJSVahs/bin/ahsrlog -d /opt/FJSVahs/logs/accesslog 1 5" ahs-analysis

■ahsrlog実行文を指定してファイルサイズ単位で設定する場合

例

アクセスログのログローテーションを以下の条件で行う場合

ファイルサイズ：1Mバイト
ファイル名：C:\Interstage\F3FMahs\logs\accesslog
ファイル数の上限値：5

CustomLog "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -s \"C:/Interstage/F3FMahs/logs/accesslog\" 1 5" ahs-analysis

アクセスログのログローテーションを以下の条件で行う場合

ファイルサイズ：1Mバイト
ファイル名：/var/opt/FJSVahs/logs/accesslog
ファイル数の上限値：5

CustomLog "|/opt/FJSVahs/bin/ahsrlog -s /opt/FJSVahs/logs/accesslog 1 5" ahs-analysis

■フィルタリング機能を使用して特定のリクエストを出力しない場合

例

アクセスログを以下の条件で出力する場合

IPアドレス「192.168.1.1」からのリクエストをアクセスログに出力しない
ファイルサイズ単位でログローテーションを行う

LoadModule setenvif_module "C:/Interstage/F3FMahs/modules/mod_setenvif.so"
SetEnvIf   Remote_Addr 192\.168\.1\.1 nolog_remote_addr
CustomLog  "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -s \"C:/Interstage/F3FMahs/logs/accesslog\" 1 5" ahs-analysis env=!nolog_remote_addr

アクセスログを以下の条件で出力する場合

URL「/abc/」配下へのリクエストをアクセスログに出力しない
ファイルサイズ単位でログローテーションを行う

LoadModule setenvif_module "C:/Interstage/F3FMahs/modules/mod_setenvif.so"
SetEnvIf   Request_URI "^/abc/" nolog_request_uri
CustomLog  "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -s \"C:/Interstage/F3FMahs/logs/accesslog\" 1 5" ahs-analysis env=!nolog_request_uri

アクセスログを以下の条件で出力する場合

メソッド「HEAD」のリクエストをアクセスログに出力しない
ファイルサイズ単位でログローテーションを行う

LoadModule setenvif_module "C:/Interstage/F3FMahs/modules/mod_setenvif.so"
SetEnvIf   Request_Method HEAD nolog_request_method
CustomLog  "||\"C:/Interstage/F3FMahs/bin/ahsrlog.exe\" -s \"C:/Interstage/F3FMahs/logs/accesslog\" 1 5" ahs-analysis env=!nolog_request_method

アクセスログを以下の条件で出力する場合

IPアドレス「192.168.1.1」からのリクエストをアクセスログに出力しない
ファイルサイズ単位でログローテーションを行う

LoadModule setenvif_module /opt/FJSVahs/modules/mod_setenvif.so
SetEnvIf   Remote_Addr 192\.168\.1\.1 nolog_remote_addr
CustomLog  "|/opt/FJSVahs/bin/ahsrlog -s /opt/FJSVahs/logs/accesslog 1 5" ahs-analysis env=!nolog_remote_addr

アクセスログを以下の条件で出力する場合

URL「/abc/」配下へのリクエストをアクセスログに出力しない
ファイルサイズ単位でログローテーションを行う

LoadModule setenvif_module /opt/FJSVahs/modules/mod_setenvif.so
SetEnvIf   Request_URI "^/abc/" nolog_request_uri
CustomLog  "|/opt/FJSVahs/bin/ahsrlog -s /opt/FJSVahs/logs/accesslog 1 5" ahs-analysis env=!nolog_request_uri

アクセスログを以下の条件で出力する場合

メソッド「HEAD」のリクエストをアクセスログに出力しない
ファイルサイズ単位でログローテーションを行う

LoadModule setenvif_module /opt/FJSVahs/modules/mod_setenvif.so
SetEnvIf   Request_Method HEAD nolog_request_method
CustomLog  "|/opt/FJSVahs/bin/ahsrlog -s /opt/FJSVahs/logs/accesslog 1 5" ahs-analysis env=!nolog_request_method

参考