svn commit: r1566326 - /incubator/sirona/site-content/trunk/src/site/markdown/web.md

[rm...@apache.org]

Author: rmannibucau
Date: Sun Feb  9 17:37:48 2014
New Revision: 1566326

URL: http://svn.apache.org/r1566326
Log:
adding sirona jsp monitoring doc

Modified:
    incubator/sirona/site-content/trunk/src/site/markdown/web.md

Modified: incubator/sirona/site-content/trunk/src/site/markdown/web.md
URL: http://svn.apache.org/viewvc/incubator/sirona/site-content/trunk/src/site/markdown/web.md?rev=1566326&r1=1566325&r2=1566326&view=diff
==============================================================================
--- incubator/sirona/site-content/trunk/src/site/markdown/web.md (original)
+++ incubator/sirona/site-content/trunk/src/site/markdown/web.md Sun Feb  9 17:37:48 2014
@@ -55,6 +55,44 @@ Simply add the listener `org.apache.siro
 
 Note: in a servlet 3 container and if `org.apache.sirona.web.activated` is not set to false it is added by default.
 
+## Monitor JSP
+
+JSP can be monitored through standard web monitoring but this includes more than only the JSP.
+To be more specific you can use JSP monitoring.
+
+For Servlet 3.0 containers just add the init parameter or sirona property:
+
+<pre class="prettyprint linenums"><![CDATA[
+org.apache.sirona.web.jsp.activated = true
+]]></pre>
+
+or in web.xml
+
+<pre class="prettyprint linenums"><![CDATA[
+<context-param>
+    <param-name>org.apache.sirona.web.jsp.activated</param-name>
+    <param-value>true</param-value>
+</context-param>
+]]></pre>
+
+This will use `PageContext` to monitor the JSP rendering (so from the JSP servlet and not from a filter).
+
+For Servlet 2.5 containers just declare the `Filter` `org.apache.sirona.web.lifecycle.LazyJspMonitoringFilterActivator`:
+
+<pre class="prettyprint linenums"><![CDATA[
+<filter>
+    <filter-name>sirona-jsp-activator</filter-name>
+    <filter-class>org.apache.sirona.web.lifecycle.LazyJspMonitoringFilterActivator</filter-class>
+</filter>
+<filter-mapping>
+    <filter-name>sirona-jsp-activator</filter-name>
+    <url-pattern>*.jsp</url-pattern>
+</filter-mapping>
+]]></pre>
+
+Note: this monitoring wraps default `javax.servlet.jsp.JspFactory` and therefore
+sirona needs to be shared accross webapps using `JspFactory` (if you have a single webapp or an ear no issue).
+
 ## Accessing results
 
 If you installed the reporting webapp you should be able to get the result under the report tab.
\ No newline at end of file