You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by bc...@apache.org on 2014/05/22 01:44:24 UTC
git commit: TS-2636: Enhance ATS custom logging to support
WIPE_FIELD_VALUE filter action Adding documentation
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 <su...@yahoo-inc.com>
Authored: Wed May 21 16:43:04 2014 -0700
Committer: Bryan Call <bc...@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