Author: Dag-Erling Smørgrav
Author: Per Buer
Date: 2010-05-31
Version: 0.2
Manual section: 1
Display varnish logs
SYNOPSIS
varnishlog [-a] [-b] [-C] [-c] [-D] [-d] [-I regex] [-i tag] [-k keep] [-n varnish_name] [-o] [-P file] [-r file] [-s num] [-u] [-V] [-w file] [-X regex] [-x tag] [tag regex]
DESCRIPTION
varnishlog工具读取和显示共享内存的日志。
下面的选项是可用的:
-a 当把日志写到文件里时,使用附加,而不是覆盖。
-b 只显示varnishd和后端服务器的日志。
-C 匹配正则表达式的时候,忽略大小写差异。
-c 只显示varnishd和客户端的日志。
-D 以进程方式运行
-d 在启动过程中处理旧的日志,一般情况下,varnishhist只会在进程写入日 志后启动。
-I regex 匹配正则表达式的日志,如果没有使用-i或者-I,那么所有的日志都会匹配。
-i tag 匹配指定的tag,如果没有使用-i或者-I,那么所有的日志都会被匹配。
-k num 只显示开始的num个日志记录。
-n 指定varnish实例的名字,用来获取日志,如果没有指定,默认使用主机名。
-o 以请求ID给日志分组,这个功能没多大用。如果要写到一个文件里使用 -w选项。
-P file 记录PID号的文件
-r file 从一个文件读取日志,而不是从共享内存读取。
-s sum 跳过开始的num条日志。
-u 无缓冲的输出。
-V 显示版本,然后退出。
-w file 把日志写到一个文件里代替显示他们,如果不是用-a参数就会发生覆盖,如果varnishlog在写日志时,接收到一个SIGHUP信号,他会创建一个新的文件,老的文件可以移走。
-X regex 排除匹配正则表达式的日志。
-x tag 排除匹配tag的日志。
如果-o选项被指定,需要使用正则表达式和tag来制定需要的日志。
TAGS
下面的日志tag是正确定义的:
* Backend
* BackendClose
* BackendOpen
* BackendReuse
* BackendXID
* CLI
* ClientAddr
* Debug
* Error
* ExpBan
* ExpKill
* ExpPick
* Hit
* HitPass
* HttpError
* HttpGarbage
* Length
* ObjHeader
* ObjLostHeader
* ObjProtocol
* ObjRequest
* ObjResponse
* ObjStatus
* ObjURL
* ReqEnd
* ReqStart
* RxHeader
* RxLostHeader
* RxProtocol
* RxRequest
* RxResponse
* RxStatus
* RxURL
* SessionClose
* SessionOpen
* StatAddr
* StatSess
* TTL
* TxHeader
* TxLostHeader
* TxProtocol
* TxRequest
* TxResponse
* TxStatus
* TxURL
* VCL_acl
* VCL_call
* VCL_return
* VCL_trace
* WorkThread
EXAMPLES
下面的命令简单的打印日志到一个文件:
$ varnishlog -w /var/log/varnish.log
下面这条命令读取一个日志文件,然是请求的首页:
$ varnishlog -r /var/log/varnish.log -c -o RxURL '^/$'
SEE ALSO
* varnishd(1)
* varnishhist(1)
* varnishncsa(1)
* varnishstat(1)
* varnishtop(1)
HISTORY
The varnishlog utility was developed by Poul-Henning Kamp ⟨phk@phk.freebsd.dk⟩ in cooperation with Verdens Gang AS, Linpro AS and Varnish Software. This manual page was initially written by Dag-Erling Smørgrav.
COPYRIGHT
这个文档的版权和varnish自身的版权一样,请看LICENCE。
* Copyright (c) 2006 Verdens Gang AS
* Copyright (c) 2006-2008 Linpro AS
* Copyright (c) 2008-2010 Redpill Linpro AS
* Copyright (c) 2010 Varnish Software AS