Tomcat访问日志浅析

Tomcat的访问日志是靠org.apache.catalina.valves.AccessLogValve来控制的，你可以修改$tomcat/conf/server.xml来启用它 ($tomcat是Tomcat安装的目录)。AccessLogValve默认应该是注释掉的，简单的将其注释去掉，然后重启Tomcat就可以了。

以下是Tomcat默认的配置：

className=“org.apache.catalina.valves.AccessLogValve”
directory=“logs” prefix=“localhost_access_log.” suffix=“.txt”
pattern=“common” resolveHosts=“false”/>

你可以设置日志保存的目录(directory)，日志的文件名的前缀(prefix)，后缀(suffix)和日志的具体格式。保存目录，文件名的前缀、后缀都很简单，一般默认设置也就可以了。resolveHost出于性能的考虑，一般也设为false. 但访问日志的格式(pattern)却有很多的选项供你选择。以下列出了一些基本的日志格式项：

• %a – 远程主机的IP (Remote IP address)

• %A – 本机IP (Local IP address)

• %b – 发送字节数，不包含HTTP头，0字节则显示 ‘-’ (Bytes sent, excluding HTTP headers, or ‘-’ if no bytes
  were sent)

• %B – 发送字节数，不包含HTTP头 (Bytes sent, excluding HTTP headers)

• %h – 远程主机名 (Remote host name)

• %H – 请求的具体协议，HTTP/1.0 或 HTTP/1.1 (Request protocol)

• %l – 远程用户名，始终为 ‘-’ (Remote logical username from identd (always returns ‘-’))

• %m – 请求方式，GET, POST, PUT (Request method)

• %p – 本机端口 (Local port)

• %q – 查询串 (Query string (prepended with a ‘?’ if it exists, otherwise
  an empty string)

• %r – HTTP请求中的第一行 (First line of the request)

• %s – HTTP状态码 (HTTP status code of the response)

• %S – 用户会话ID (User session ID)

• %t – 访问日期和时间 (Date and time, in Common Log Format format)

• %u – 已经验证的远程用户 (Remote user that was authenticated

• %U – 请求的URL路径 (Requested URL path)

• %v – 本地服务器名 (Local server name)

• %D – 处理请求所耗费的毫秒数 (Time taken to process the request, in millis)

• %T – 处理请求所耗费的秒数 (Time taken to process the request, in seconds)

你可以用以上的任意组合来定制你的访问日志格式，也可以用下面两个别名common和combined来指定常用的日志格式：

• common – %h %l %u %t "%r" %s %b

• combined -
  %h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"

另外你还可以将cookie, 客户端请求中带的HTTP头(incoming header), 会话(session)或是ServletRequest中的数据都写到Tomcat的访问日志中，你可以用下面的语法来引用。

• %{xxx}i – 记录客户端请求中带的HTTP头xxx(incoming headers)

• %{xxx}c – 记录特定的cookie xxx

• %{xxx}r – 记录ServletRequest中的xxx属性(attribute)

• %{xxx}s – 记录HttpSession中的xxx属性(attribute)

比如下面是实际的一个访问日志格式的配置：

className=“org.apache.catalina.valves.AccessLogValve”
directory=“logs” prefix=“phone_access_log.” suffix=“.txt”
pattern=“%h %l %T %t %r %s %b %{Referer}i %{User-Agent}i MSISDN=%{x-up-calling-line-id}i”resolveHosts=“false”/>

其中日志格式(pattern)指定为”%h %l %T %t %r %s %b %{Referer}i %{User-Agent}i MSISDN=%{x-up-calling-line-id}i“，则实际的访问日志中将会包括：

• %h – 远程主机名

• %l - 远程用户名，始终为 ‘-’

• %T - 处理请求所耗费的秒数

• %t – 访问日期和时间

• %r – HTTP请求中的第一行

• %s – HTTP状态码

• %b – 发送字节数，不包含HTTP头(0字节则显示 ‘-’)

• %{Referer}i – Referer URL

• %{User-Agent}i – User agent

• MSISDN=%{x-up-calling-line-id}i – 手机号

实际的访问日志如下：

xxx.xxx.xx.xxx – 0.270 [14/Jul/2008:13:10:53 +0800] POST /phone/xxx/gprs HTTP/1.1 200 91812 – SonyEricssonW890i/R1EA Profile/MIDP-2.1 Configuration/CLDC-1.1 MSISDN=11111111111

… …

xxx.xxx.xx.xxx – 0.083 [14/Jul/2008:21:20:55 +0800] POST /phone/xxx/gprs HTTP/1.1 200 404 – SonyEricssonW910i/R1FA Profile/MIDP-2.1 Configuration/CLDC-1.1 MSISDN=11111111111