[master] b90b293d0 whats-new: Upgrade considerations for VSL utilities

Dridi Boukelmoune dridi.boukelmoune at gmail.com
Mon Mar 15 09:41:05 UTC 2021


commit b90b293d094f65fc214a244f296e2dc23057dc9a
Author: Dridi Boukelmoune <dridi.boukelmoune at gmail.com>
Date:   Mon Mar 15 10:39:53 2021 +0100

    whats-new: Upgrade considerations for VSL utilities

diff --git a/doc/sphinx/whats-new/upgrading-trunk.rst b/doc/sphinx/whats-new/upgrading-trunk.rst
index 501a8f49c..b820e9469 100644
--- a/doc/sphinx/whats-new/upgrading-trunk.rst
+++ b/doc/sphinx/whats-new/upgrading-trunk.rst
@@ -40,6 +40,18 @@ Accounting Changes
 Accounting statistics and Log records have changed. See
 :ref:`whatsnew_changes_CURRENT_accounting` for details.
 
+VSL changes
+===========
+
+The ``-c`` option of log utilities no longer includes ESI requests. A
+new ``-E`` option is now available for ESI requests and it implies ``-c``
+too. This brings all log utilities on par with ``varnishncsa`` where the
+``-E`` option was initially introduced.
+
+If you use ``-c`` to collect both client and ESI requests, you should
+use ``-E`` instead. If you use ``-c`` and a VSL query to exclude ESI
+requests, the query should no longer be needed.
+
 VMOD ``cookie`` functions
 =========================
 
@@ -47,7 +59,6 @@ The regular expression arguments taken by various functions from the
 ``cookie`` VMOD now need to be literal. See
 :ref:`whatsnew_changes_CURRENT_cookie` for details.
 
-
 Other VCL Changes
 =================
 


More information about the varnish-commit mailing list