Nginx - ログフォーマット、アクセスログについて!
Updated:
軽量 Web サーバ Nginx の設定の中のアクセスログについてです。
(Debian, Ubuntu 等 GNU 系ディストリビューションは同様だと思う)
0. 前提条件Permalink
- Linux Mint 14 Nadia (64bit) での作業を想定。
- Nginx 1.2.6 がソースビルドによりインストール済み。
- パッケージを利用してインストールした Nginx とはディレクトリ構成等が若干異なるが、アクセスログの設定については同じ。
1. ログフォーマットについてPermalink
まず、ログフォーマット(log_format
)とは、アクセスログにログを出力する際に使用するフォーマットのことで、設定ファイル(今回の場合 /usr/local/nginx/conf/nginx.conf
) に記述して設定する。
log_format
を設定しない場合は、以下のようなフォーマットを設定したことになる。(フォーマット名は combined
)
log_format combined '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';
# $remote_addr : クライアントのIPアドレス
# $remote_user : クライアントのユーザ名
# $time_local : アクセス日時
# $request : httpの要求URI
# $status : httpのステータス
# $body_bytes_sent: 送信バイト数
# $http_referer : リファラーURL(遷移元URL)
# $http_user_agent: ユーザエージェント情報(ブラウザ名・バージョン等)
その他、変数については参考サイトを参照。
デフォルト以外のフォーマットを使用する場合は、フォーマット名を変更して変数を編集する。(Gzip 圧縮率を出力するようにする際など)
2. アクセスログについてPermalink
アクセスログを出力するには、設定ファイル(今回の場合 /usr/local/nginx/conf/nginx.conf
)に以下のようなフォーマットで記述する。
access_log path [format [buffer=size [flush=time]]];
access_log path format gzip[=level] [buffer=size] [flush=time];
access_log off;
設定しない場合は、以下の設定をしたことになる。
但し、Nginx をビルドしてインストールした場合で、ビルド時のオプションでログファイルパス(--http-log-path
)を指定した場合は、そのログファイルパスがデフォルトとなる。
access_log logs/access.log combined;
3. 設定Permalink
取り急ぎ、以下のような設定にしてみた。
当方は http ディレクティブで設定したが、バーチャルホスト別に設定したいなら server ディレクティブ内に記述する。
File: /usr/local/nginx/conf/nginx.conf
1
2
3
4
5
6
7
8
9
10
11
12
13
http {
:
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
:
}
4. Nginx リロードPermalink
設定を有効化させるために Nginx をリロードする。(未起動なら起動する)
$ sudo service nginx reload
5. 確認Permalink
何か作業(サーバへアクセス)してみて、アクセスログファイルを確認してみる。
File: /var/log/nginx/access.log
1
2
3
$ cat /var/log/nginx/access.log
127.0.0.1 - - [02/Jan/2013:23:46:57 +0900] "GET / HTTP/1.1" 200 177 "-" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:17.0) Gecko/20100101 Firefox/17.0" "-"
127.0.0.1 - - [02/Jan/2013:23:46:58 +0900] "GET /favicon.ico HTTP/1.1" 200 318 "-" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:17.0) Gecko/20100101 Firefox/17.0" "-"
設定した通りのフォーマットで記録されている。
6. 参考サイトPermalink
Nginx のアクセスログについての大筋は理解できました。
以上。
Comments