Varnish

Varnish日志条目排名

手册部分:

1

SYNOPSIS

Varnish [-1] [-b] [-c] [-C] [-d] [-E] [-f] [-g <session|request|vxid|raw>] [-h] [-i <taglist>] [-I <[taglist:]regex>] [-L <limit>] [-n <dir>] [-p <period>] [-Q <file>] [-q <query>] [-r <filename>] [-t <seconds|off>] [-T <seconds>] [-x <taglist>] [-X <[taglist:]regex>] [-V]

DESCRIPTION

Varnishtop实用程序显示为 华而不实 共享内存记录并显示最常出现的日志条目的持续更新列表。使用适当的过滤 -I ， -i ， -X 和 -x 选项，它可用于显示请求的文档、客户端、用户代理或日志中记录的任何其他信息的排名。

以下选项可用：

-1

不是不断更新显示，而是打印一次统计数据并退出。暗示 -d 。

-b

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

-c

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

-C

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

-d

在日志头处理日志记录。

-E

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

-f

仅对每个日志条目的第一个字段进行排序和分组。对于表单中的日志条目 prefix: value 对不带冒号的前缀进行排序和分组。这在显示ReqStart条目时非常有用，其中第一个字段是客户端IP地址。

-g <session|request|vxid|raw>

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

-h

打印程序使用和退出

-i <taglist>

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

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

-I <[taglist:]regex>

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

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

-L <limit>

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

-n <dir>

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

-p <period>

指定要测量的秒数，默认为60秒。列表中的第一个数字是在此时间段内看到的平均请求数。如果还使用了选项，则该选项不起作用。

-Q <file>

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

-q <query>

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

-r <filename>

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

-t <seconds|off>

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

-T <seconds>

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

-x <taglist>

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

-X <[taglist:]regex>

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

-V

打印版本信息并退出。

--optstring

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

EXAMPLES

以下示例显示最常请求的URL的持续更新列表：

varnishtop -i ReqURL

以下示例显示不断更新的最常用用户代理列表：

varnishtop -C -I ReqHeader:User-Agent

另请参阅

HISTORY

Varnishtop实用程序最初是由Pul-Henning Kamp与Verden Gang AS和Varnish Software AS合作开发的，后来由Dag-Erling Smørgrav重写。本手册页面由Dag-Erling Smørgrav撰写，随后由Martin Blix Grydeland更新。