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 <[email protected]> Authored: Wed May 21 16:43:04 2014 -0700 Committer: Bryan Call <[email protected]> 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
