Nginx - ログフォーマット、アクセスログについて!

Updated:


※この記事は11年以上前に投稿されたもので、情報が古い可能性があります。

軽量 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 のアクセスログについての大筋は理解できました。

以上。





 

Sponsored Link

 

Comments