[master] 83cbb7f Document vxid VSL queries
Dridi Boukelmoune
dridi.boukelmoune at gmail.com
Thu Feb 23 14:55:06 CET 2017
commit 83cbb7f8c9e68e9fca97d4af7c39fc2a2ceb9db9
Author: Dridi Boukelmoune <dridi.boukelmoune at gmail.com>
Date: Thu Feb 23 14:45:18 2017 +0100
Document vxid VSL queries
diff --git a/doc/sphinx/reference/vsl-query.rst b/doc/sphinx/reference/vsl-query.rst
index 8f47156..a91d404 100644
--- a/doc/sphinx/reference/vsl-query.rst
+++ b/doc/sphinx/reference/vsl-query.rst
@@ -30,6 +30,8 @@ A query is run on a group of transactions. A query expression is true
if there is a log record within the group that satisfies the
condition. It is false only if none of the log records satisfies the
condition. Query expressions can be combined using boolean functions.
+In addition to log records, it is possible to query transaction ids
+(vxid) in query.
GROUPING
========
@@ -119,6 +121,16 @@ records. ::
<record selection criteria> <operator> <operand>
+Additionally, a query expression can occur on the transaction
+itself rather than log records belonging to the transaction. ::
+
+ vxid <numerical operator> <integer>
+
+A ``vxid`` query allows you to directly target a specific transacion,
+whose id can be obtained from an ``X-Varnish`` HTTP header, the
+default "guru meditation" error page, or ``Begin`` and ``Link`` log
+records.
+
Record selection criteria
-------------------------
@@ -273,6 +285,10 @@ QUERY EXPRESSION EXAMPLES
BerespStatus >= 500 or {2+}Timestamp:Process[2] > 1.
+* Log non-transactional errors. (Assumes raw grouping mode). ::
+
+ vxid == 0 and Error
+
HISTORY
=======
More information about the varnish-commit
mailing list