Varnishlog

显示Varnish日志

手册部分:

1

SYNOPSIS

Varnishlog [-a] [-A] [-b] [-c] [-C] [-d] [-D] [-E] [-g <session|request|vxid|raw>] [-h] [-i <taglist>] [-I <[taglist:]regex>] [-k <num>] [-L <limit>] [-n <dir>] [-P <file>] [-Q <file>] [-q <query>] [-r <filename>] [-R <limit[/duration]>] [-t <seconds|off>] [-T <seconds>] [-u] [-v] [-V] [-w <filename>] [-x <taglist>] [-X <[taglist:]regex>]

OPTIONS

以下选项可用：

-a

在使用-w选项将输出写入文件时，请追加而不是覆盖它。如果没有-w选项，此选项将不起作用。

-A

使用-w选项将输出写入文件时，以ASCII格式输出数据。如果没有-w选项，此选项将不起作用。

-b

仅显示来自后端通信的事务和日志记录。

-c

仅显示来自客户端通信的事务和日志记录。

-C

做所有正则表达式和字符串匹配，不区分大小写。

-d

处理日志开头的日志记录并退出。

-D

守护神。

-E

显示ESI交易记录和其他类型的子请求。这暗示了-c选项，并包括其他客户端事务。

-g <session|request|vxid|raw>

日志记录的分组。默认情况下，按vxid分组。

-h

打印程序使用和退出

-i <taglist>

在输出中包括这些标记的日志记录。Taglist是一个逗号分隔的标记GLOB列表。可以提供多个i选项。

如果标签包含选项是所有标签选择选项中的第一个，则所有标签将首先标记为排除。

-I <[taglist:]regex>

包括通过正则表达式匹配。仅输出与标记列表和正则表达式匹配的记录。如果没有标记列表，则应用于任何标记。可以提供多个i选项。

如果标签包含选项是所有标签选择选项中的第一个，则所有标签将首先标记为排除。

-k <num>

在退出之前处理此数量的匹配日志事务。

-L <limit>

设置在强制完成最早的事务之前保留的未完成事务的上限。当发生这种情况时，将合成警告记录。此设置对运行查询的内存使用量保持上限。默认为1000笔交易记录。

-n <dir>

指定从中获取日志的varnishd工作目录(也称为实例名称)。如果未指定-n，则使用主机名。

-P <file>

将进程的ID写入指定的文件。

-Q <file>

指定包含要使用的VSL查询的文件。当指定了多个-q或-q选项时，所有查询都被视为使用‘or’运算符组合它们。

-q <query>

指定要使用的VSL查询。当指定了多个-q或-q选项时，所有查询都被视为使用‘or’运算符组合它们。

-r <filename>

从此文件中读取二进制文件格式的日志。可以使用以下命令创建该文件 varnishlog -w filename 。如果文件名为-，则从标准输入中读取日志。并且不能作为守护程序工作。

-R <limit[/duration]>

将输出限制在指定的限制内。超过限制的交易将被抑制。该限制被指定为最大事务数(相对于所选的分组方法)和一个可选的时间段。如果未指定持续时间，则默认为 s 使用的是。持续时间字段可以格式化为VCL中的格式(例如 -R 10/2m )或作为不带前缀的简单时间段(例如 -R 5/m )。当进入时 -g raw 分组模式，此设置不能与 -i ， -I ， -x 或 -X ，我们建议使用 -q 取而代之的是。

-t <seconds|off>

在初始VSM连接上返回错误之前超时。如果设置，则VSM连接每0.5秒重试一次，持续此时间。如果为零，则只尝试连接一次，如果连接不成功，将立即失败。如果设置为“off”，则连接不会失败，从而允许实用程序无限期地启动并等待Varnish实例出现。默认为5秒。

-T <seconds>

设置事务超时(以秒为单位)。这定义了开始标记和结束标记之间经过的最大秒数。如果超时到期，则合成警告记录并强制完成事务。默认为120秒。

-u

使用-w选项将输出写入文件时，不会缓冲输出数据。如果没有-w选项，此选项将不起作用。

-v

在记录集打印上使用详细输出，在每个日志行上提供VXID。如果没有此选项，VXID将仅显示在该交易的标题上。

-V

打印版本信息并退出。

-w <filename>

将输出重定向到文件。除非指定了-a选项，否则该文件将被覆盖。如果应用程序在守护程序模式下收到SIGHUP，文件将重新打开，允许旧文件旋转离开。除非指定了-A选项，否则varnishlog和其他带有-r选项的工具可以读取该文件。在守护程序模式下运行时，此选项是必需的。如果文件名为-，varnishlog将写入标准输出，并且不能作为守护进程工作。

-x <taglist>

在输出中排除这些标记的日志记录。Taglist是一个逗号分隔的标记GLOB列表。可以提供多个-x选项。

-X <[taglist:]regex>

通过正则表达式匹配排除。不输出与标记列表和正则表达式匹配的记录。如果没有标记列表，则应用于任何标记。可以提供多个-X选项。

--optstring

将optstring参数打印到 getopt(3) 以帮助编写包装器脚本。

SIGNALS

  • SIGHUP

    在守护程序模式下旋转日志文件(请参见-w选项)，中止循环并在前台运行时优雅地退出。

  • 标志1

    刷新所有未完成的交易记录

另请参阅

HISTORY

Varnishlog实用程序由Pul-Henning Kamp<phk@phk.frebsd.dk>与Verdens Gang AS和Varnish Software AS合作开发。本手册最初由Dag-Erling Smørgrav撰写，后来由Per Buer和Martin Blix Grydeland更新。