trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bc...@apache.org
Subject git commit: TS-2636: Enhance ATS custom logging to support WIPE_FIELD_VALUE filter action Adding documentation
Date Wed, 21 May 2014 23:44:24 GMT
Repository: trafficserver
Updated Branches:
  refs/heads/master cbe14547d -> 5acff2c66


TS-2636: Enhance ATS custom logging to support WIPE_FIELD_VALUE filter action
Adding documentation


Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/5acff2c6
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/5acff2c6
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/5acff2c6

Branch: refs/heads/master
Commit: 5acff2c66d7b9ae795cd6d4bfac196c3acbe3d1a
Parents: cbe1454
Author: Sudheer Vinukonda <sudheerv@yahoo-inc.com>
Authored: Wed May 21 16:43:04 2014 -0700
Committer: Bryan Call <bcall@apache.org>
Committed: Wed May 21 16:44:12 2014 -0700

----------------------------------------------------------------------
 .../configuration/logs_xml.config.en.rst        | 21 +++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/5acff2c6/doc/reference/configuration/logs_xml.config.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/configuration/logs_xml.config.en.rst b/doc/reference/configuration/logs_xml.config.en.rst
index 4599968..ddf4cae 100644
--- a/doc/reference/configuration/logs_xml.config.en.rst
+++ b/doc/reference/configuration/logs_xml.config.en.rst
@@ -145,9 +145,15 @@ The following list shows the ``LogFilter`` specifications.
     ``REJECT`` the record.
 
 ``<Action = "valid_action_field"/>``
-    Required: ``ACCEPT`` or ``REJECT`` .
-    This instructs Traffic Server to either accept or reject records
-    that satisfy the filter condition.
+    Required: ``ACCEPT`` or ``REJECT`` or ``WIPE_FIELD_VALUE``.
+    ACCEPT or REJECT instructs Traffic Server to either accept or reject records
+    that satisfy the filter condition. WIPE_FIELD_VALUE wipes out
+    the values of the query params in the url fields specified in the Condition.
+
+NOTES: 1. WIPE_FIELD_VALUE action is only applied to the parameters in the query part.
+       2. Multiple parameters can be listed in a single WIPE_FIELD_VALUE filter
+       3. If the same parameter appears more than once in the query part , only
+          the value of the first occurance is wiped
 
 .. _LogObject:
 
@@ -331,6 +337,15 @@ The following is an example of a ``LogFilter`` that will cause only
              <Condition = "pssc MATCH REFRESH_HIT"/>
          </LogFilter>
 
+The following is an example of a ``LogFilter`` that will cause the value of
+passwd field be wiped in cquc
+
+<LogFilter>
+    <Name = "wipe_password"/>
+    <Condition = "cquc CONTAIN passwd"/>
+    <Action = "WIPE_FIELD_VALUE"/>
+</LogFilter>
+
 The following is an example of a ``LogObject`` specification that
 creates a local log file for the minimal format defined earlier. The log
 filename will be ``minimal.log`` because this is an ASCII log file (the


Mime
View raw message