This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Logback: the generic, reliable, fast and flexible logging framework.". The branch, master has been updated via 474f6003528b4f84583c148a9f9b98c014aa196c (commit) from f8db9f855682bca4c73856893ace329730ff7b9c (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=474f6003528b4f84583c148a9... http://github.com/ceki/logback/commit/474f6003528b4f84583c148a9f9b98c014aa19... commit 474f6003528b4f84583c148a9f9b98c014aa196c Author: Ceki Gulcu <ceki@qos.ch> Date: Wed Nov 24 16:36:56 2010 +0100 minor edits diff --git a/logback-site/src/site/pages/access.html b/logback-site/src/site/pages/access.html index f81adaa..b0c3de9 100644 --- a/logback-site/src/site/pages/access.html +++ b/logback-site/src/site/pages/access.html @@ -549,9 +549,9 @@ Set-Cookie: JSESSIONID=bgebt99ce9om;path=/logback-demo code for test and production environments, <code>TeeFilter</code> supports <code>includes</code> and <code>excludes</code> parameters. <code>TeeFilter</code> will be active if the current host is listed - in the includes list and absent in the excludes list. An empty - includes list is interpreted as to contain all possible host names - in the universe. + in the includes list and absent in the excludes list. By special + convention, an empty includes list is interpreted as to contain all + possible host names in the universe. </p> <p>To enable <code>TeeFilter</code> only on the hosts named "orion" diff --git a/logback-site/src/site/pages/recipes/captureHttp.html b/logback-site/src/site/pages/recipes/captureHttp.html index 5e53d1b..5e925fb 100644 --- a/logback-site/src/site/pages/recipes/captureHttp.html +++ b/logback-site/src/site/pages/recipes/captureHttp.html @@ -141,15 +141,47 @@ Set-Cookie: JSESSIONID=bgebt99ce9om;path=/logback-demo <p> </p> - <p> + <h3>Disabling <code>TeeFilter</code> in the production + environment</h3> + + <p>Due to its instrusive nature, <code>TeeFilter</code> can slow + down performance. Moreover, altough we have fixed all currently + known bugs, <code>TeeFilter</code> has broken otherwise + correctly behaving applications in the past. Thus, while + extremely useful during problem hunting, we do not recommend + having <code>TeeFilter</code> active in production systems. In + order to avoid shipping different code for test and production + environments, <code>TeeFilter</code> supports includes and + excludes parameters. <code>TeeFilter</code> will be active if + the current host is listed in the includes list and absent in + the excludes list. By special convention, an empty + <em>includes</em> list is interpreted as to contain all possible + host names in the universe. + </p> + + <p>Assume we wish to capture HTTP traffic on all hosts except on + orion and gemini, the hostnames of the the production systems, + we would write:</p> + + <pre class="prettyprint source"><filter> + <filter-name>TeeFilter</filter-name> + <filter-class>ch.qos.logback.access.servlet.TeeFilter</filter-class> + <init-param> + <b><!-- exclude captures on production systems --></b> + <b><param-name>excludes</param-name></b> + <b><param-value>orion, gemini</param-value></b> + </init-param> +</filter> </pre> + + <p>If it is easier, you could also explicitly name the machines + of the integration envrionment in the includes list. </p> - - - <h3>Enabling only in the integration environment</h3> <h3>Filtering captured requests</h3> + + <script src="../templates/footer.js" type="text/javascript"></script> </div> </body> ----------------------------------------------------------------------- Summary of changes: logback-site/src/site/pages/access.html | 6 +- .../src/site/pages/recipes/captureHttp.html | 40 ++++++++++++++++++-- 2 files changed, 39 insertions(+), 7 deletions(-) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.