trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [trafficserver] branch master updated: Document undocumented LogFilter feature
Date Fri, 05 May 2017 15:34:38 GMT
This is an automated email from the ASF dual-hosted git repository.

amc pushed a commit to branch master
in repository

The following commit(s) were added to refs/heads/master by this push:
       new  b7a1c74   Document undocumented LogFilter feature
b7a1c74 is described below

commit b7a1c74519be480da1cc8dc0a7003bc0e3529076
Author: Daniel Xu <>
AuthorDate: Thu May 4 14:43:26 2017 -0500

    Document undocumented LogFilter feature
    This fixes github issue #1671.
 doc/admin-guide/files/logging.config.en.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/doc/admin-guide/files/logging.config.en.rst b/doc/admin-guide/files/logging.config.en.rst
index df0b87b..77a5b96 100644
--- a/doc/admin-guide/files/logging.config.en.rst
+++ b/doc/admin-guide/files/logging.config.en.rst
@@ -217,13 +217,33 @@ Filter Values
 The final component of a filter string specifies the value against which the
-name field will be compared. For integer matches, all of the operators are
-effectively equivalent and require the field to be equal to the given integer.
+name field will be compared.
+For integer matches, all of the operators are effectively equivalent and require
+the field to be equal to the given integer. If you wish to match multiple
+integers, provide a comma separated list like this::
+    <field> <operator> 4,5,6,7
+String matches work similarly to integer matches. Multiple matches are also
+supported via a comma separated list. For example::
+    <field> <operator> e1host,host2,hostz
 For IP addresses, ranges may be specified by separating the first address and
 the last of the range with a single ``-`` dash, as ````
 which gives the ranges for the 10/8 network. Other network notations are not
 supported at this time.
+.. note::
+    It may be tempting to attach multiple Filters to a log object to accept or
+    reject multiple log fields (in lieu of providing a single comma separated list
+    to a single Filter). Avoid this temptation and use a comma separated list
+    instead. Attaching multiple filters does the opposite of what you'd
+    expect. If, for example, we had 2 accept log filters, each disjoint from the other,
+    nothing will ever get logged on the given log object.
 Wiping Filters

To stop receiving notification emails like this one, please contact
['"" <>'].

View raw message