Author: bleny Date: 2011-12-02 17:23:51 +0100 (Fri, 02 Dec 2011) New Revision: 156 Url: http://nuiton.org/repositories/revision/nuiton-web/156 Log: documentation for MonitoringFilter Added: trunk/nuiton-web/src/site/apt/MonitoringFilter.apt.vm Modified: trunk/nuiton-web/src/site/site_fr.xml Added: trunk/nuiton-web/src/site/apt/MonitoringFilter.apt.vm =================================================================== --- trunk/nuiton-web/src/site/apt/MonitoringFilter.apt.vm (rev 0) +++ trunk/nuiton-web/src/site/apt/MonitoringFilter.apt.vm 2011-12-02 16:23:51 UTC (rev 156) @@ -0,0 +1,44 @@ + +Monitoring Filter + +* Abstract + + It allow you to monitor any application based on the Servlet API. It's + non-intrusive since it only needs you to add a filter in web.xml. + + Statistics are made available as a CSV documents (suitable for spreadsheets) + through JMX and appears when application is stopped (javax.servlet.Filter#destroy() called) + +* Usage + + + * Adds it in our <<web.xml>> : + +------------------------------------------------ + +<filter> + <filter-name>monitoring</filter-name> + <filter-class>org.nuiton.web.filter.MonitoringFilter</filter-class> +</filter> + +... + +<filter-mapping> + <filter-name>monitoring</filter-name> + <url-pattern>/*</url-pattern> +</filter-mapping> + + +------------------------------------------------ + + * Obtain stats though JMX using jconsole + + You can use jconsole, a tool bundled with the JDK. You must had nuiton-web + to the classpath. + +------------------------------------------------ + +jconsole -J-Djava.class.path=/path/to/jdk/lib/tools.jar:/path/to/jdk/lib/jconsole.jar:/path/to/nuiton-web.jar + +------------------------------------------------ + Modified: trunk/nuiton-web/src/site/site_fr.xml =================================================================== --- trunk/nuiton-web/src/site/site_fr.xml 2011-12-02 14:42:28 UTC (rev 155) +++ trunk/nuiton-web/src/site/site_fr.xml 2011-12-02 16:23:51 UTC (rev 156) @@ -42,6 +42,7 @@ <menu name="Utilisateur"> <item name="Accueil" href="index.html"/> <item name="Topia Filter" href="/TopiaFilter.html"/> + <item name="MonitoringFilter" href="/MonitoringFilter.html"/> <item name="War launcher" href="/Warlauncher.html"/> </menu>