在 server.xml 里的 <host> 标签下加上
<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs" prefix="localhost_access_log." suffix=".txt"
pattern="common" resolveHosts="false"/>
就可以了,下面咱们逐一分析各个参数。
className | 官方文档上说了 This MUST be set to org.apache.catalina.valves.AccessLogValve to use the default access log valve. &<60; 想配置访问日志?这就必须得写成这样。 |
directory | 这个东西是日志文件放置的目录,在 tomcat 下面有个 logs 文件夹,那里面是专门放置日志文件的,当然你也可以修改,我就给改成了 D:/ |
prefix | 这个是日志文件的名称前缀,我的日志名称为 localhost_access_log.2007-09-22.txt ,前面的前缀就是这个 localhost_access_log |
suffix | 这就是后缀名啦,可以改成别的 |
pattern | 这个是最主要的参数了,具体的咱们下面讲,这个参数的内容比较丰富。 |
resolveHosts | 如果这个值是 true 的话, tomcat 会将这个服务器 IP 地址通过 DNS 转换为主机名,如果是 false ,就直接写服务器 IP 地址啦 |
还有一些参数:
rotatable | 默认为 true ,默认的设置使得你的 tomcat 生成的文件命为 prefix (前缀) +.+ 时间(一般是按天算) +.+suffix (后缀),参照我的日志名就知道了: localhost_access_log.2007-09-22.txt |
condition | 这个参数不太实用,可以设置任何值,比如咱们设置成 condition="tkq" ,那么只有当 ServletRequest.getAttribute ("tkq") 为空的时候,才会被记录下来 |
fileDateFormat | 最后的一个参数,很明白,这就是时间格式嘛,但是这个时间格式是针对日志文件起作用的,还记得咱们生成的日志文件全名么: localhost_access_log.2007-09-22.txt ,这里面的 2007-09-22 就是这么来的,如果你想让 tomcat 每小时生成一个日志文件,也很简单,将这个值设置为: fileDateFormat="yyyy-MM-dd.HH" ,当然也可以按分钟生成什么的,自己改改吧 |
上面是所有的 9 个参数,刚才咱们说了, pattern 这个参数的值比较多,咱们拿下来单独说:
pattern 可以设置成两种方式,第一种是pattern="common" ,第二种是pattern="combined"
这就可以控制日志里面的格式,各位说了,pattern 就这两种?common 和combined 又是什么意
思,具体是什么格式呢?
别着急,咱们一点一点看,其实pattern 是可以设置的,common 和combined 只是集成了一些显
示方式,就是将显示方式给组合了,pattern 的实际值有如下几种,都是后面一个字母,前面
一个% 百分号
咱们先贴出来我的日志里面的一条记录,对应着看
127.0.0.1 192.168.254.108 - -1 127.0.0.1 HTTP/1.1 - GET 80&<60; GET /rightmainima/leftbott4.swf HTTP/1.1 304 5563A67708646B6AA299C33D59BE132A [22/Sep/2007:10:08:52 +0800] - /rightmainima/leftbott4.swf localhost 0 0.000
%a | 这是记录访问者的IP ,在日志里是127.0.0.1 |
%A | 这是记录本地服务器的IP ,在日志里是192.168.254.108 |
%b | 这是发送信息的字节数,不涵括 http 头,如果字节数为 0 的话,显示为 - |
%B | 看 tomcat 的解释,没看出来与 b% 的区别,但我这里显示为 -1 ,没想明白,望知道者告知,我把官方解释贴出来吧 Bytes sent, excluding HTTP headers |
%h | 这个就是服务器名称了,如果 resolveHosts 为 false 的话,这里就是 IP 地址了,我的日志里是 127.0.0.1 |
%H | 访问者使用的协议,这里是 HTTP/1.1 |
%l | 这个也不太清楚,官方也说这个 always return '-' 官方解释: Remote logical username from identd ( 可能这样翻译:记录浏览者进行身份验证时提供的名字 )(always returns '-') |
%m | 访问的方式,是 GET 还是 POST ,我这是 GET |
%p | 本地接收访问的端口,呵呵,我这里是 80 啦 |
%q | 比如你访问的是 aaa.jsp?bbb=ccc ,那么这里就显示 ?bbb=ccc ,明白了吧,这个 q 是 querystring 的意思 |
%r | 官方解释: First line of the request (method and request URI) ,不是很明白 |
%s | 这个是 http 的状态,我这里返回的是 304 ,咱们经常看见访问某个网页报错误 500 什么的,那也会返回 500 |
%S | 用户的 session ID, 这个 session ID 大家可以另外查一下详细的解释,反正每次都会生成不同的 session ID |
%t | 这就是时间啦,好像有一个 Common Log Format 可以改,不过我没找到 |
%u | 得到了验证的访问者,否则就是 "-" |
%U | 访问的 URL 地址,我这里是 /rightmainima/leftbott4.swf |
%v | 服务器名称,可能就是你 url 里面写的那个吧,我这里是 localhost |
%D | 官方解释: Time taken to process the request, in millis ,应该是访问发生的时间,以毫秒记 |
%T | 官方解释: Time taken to process the request, in seconds ,应该是访问发生的时间,以秒记 |
common 的值:%h %l %u %t %r %s %b
combined 的值:%h %l %u %t %r %s %b %{Referer}i %{User-Agent}i
至于 combined 的值的最后两个为什么会这样,我也不太清楚 …
这就是所有的参数了,欢迎交流探讨!
这是官方的解释地址: http://tomcat.apache.org/tomcat-5.5-doc/config/valve.html
这个也可以看一看做参考: http://tomcat.apache.org/tomcat-5.0-doc/config/logger.html
还有这个: http://tomcat.apache.org/tomcat-5.0-doc/config/host.html
Apache 官方对 Tomcat 访问日志的配置介绍的并不详细,大家可以参考 Apache ( web server )的访问日志,两者有相当多相似的地方