配置tomcat访问日志

 tomcat  配置tomcat访问日志已关闭评论
12月 162013
 

记录下,备用

打开tomcat 的conf目录下server.xml文件,在 <Host> </Host>间添加


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

className

实现的Java类名。必须被设置成org.apache.catalina.valves.AccessLogValve。

directory

存放日志文件的目录,可以是相对路径或者绝对路径。如果使用相对路径,是指相对于 $CATALINA_HOME的路径。如果不指定directory属性,缺省值是“logs”(相对于 $CATALINA_HOME)

pattern

需要记录的请求/响应不同信息域的格式布局。如果是“common”或者“combine”,说明选择标准格式。下面会有关于配置这个属性的更多信息。

common的值:%h %l %u %t %r %s %b
combined的值:%h %l %u %t %r %s %b %{Referer}i %{User-Agent}i 

prefix

日志文件名的前缀。如果没有指定,缺省值是“access_log.”。如果不想使用前缀,使用长度为0的字符串。

resolveHosts

将远端主机的IP地址通过DNS查询转换成主机名,设为true。如果为false,忽略DNS查询,报告远端的IP地址。

suffix

日志文件名的后缀。如果没有指定,缺省值是“”。如果不想使用后缀,使用长度为0的字符串。

rotatable

缺省值为true,用来决定日志是否翻转的标志。如果为false,日志文件永远不翻转,并且忽略fileDataFormat。要谨慎使用。

condition

打开条件日志。如果设置了这个属性,只有在ServletRequest.getAttribute()是null的时候,才会为请求创建日志。比如,如果condition设为junk,则只有在Servlet.getAttribute(“junk”)==null的时候,才会记录这个请求。使用过滤器,可以很容易设置(或者取消设置)不同请求的属性。

fileDateFormat

允许在日志文件名称中使用定制的日期格式。日志的格式也决定了日志文件翻转的频率。如果想每个小时翻转一次,将这个值设为yyyy-MM-dd.HH


pattern属性值由字符串常量和pattern标识符加上前缀”%”组合而成。pattern标识符加上前缀”%”,用来代替当前请求/响应中的对应的变量值。目前支持如下的pattern:

·        %a – 远端IP地址

·        %A – 本地IP地址

·        %b – 发送的字节数,不包括HTTP头,如果为0,使用”-”

·        %B – 发送的字节数,不包括HTTP头

·        %h – 远端主机名(如果resolveHost=false,远端的IP地址)

·        %H – 请求协议

·        %l – 从identd返回的远端逻辑用户名(总是返回 ‘-‘)

·        %m – 请求的方法(GET,POST,等)

·        %p – 收到请求的本地端口号

·        %q – 查询字符串(如果存在,以 ‘?’开始)

·        %r – 请求的第一行,包含了请求的方法和URI

·        %s – 响应的状态码

·        %S – 用户的session ID

·        %t – 日志和时间,使用通常的Log格式

·        %u – 认证以后的远端用户(如果存在的话,否则为’-‘)

·        %U – 请求的URI路径

·        %v – 本地服务器的名称

·        %D – 处理请求的时间,以毫秒为单位

·        %T – 处理请求的时间,以秒为单位

其它关于各个参数的资料,供参考:
className 官方文档上说了This MUST be set to org.apache.catalina.valves.AccessLogValve to use the default access log valve. 想配置访问日志?这就必须得写成这样。 


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
使用这个需要谨慎,因为你将其设置为false的话,tomcat会忽略时间,不会新生成文件,最后导致你的文件超级大,这样生成的文件名就是:localhost_access_log.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