[4.1] cfc29b3 Document vxid VSL queries
    Martin Blix Grydeland 
    martin at varnish-software.com
       
    Thu Apr  6 14:56:05 CEST 2017
    
    
  
commit cfc29b32a5c2839734e432a843d7390555c0add7
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