Wiki source code of Monitoring
Version 6.1 by Vincent Massol on 2011/05/06
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
6.1 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| |
1.1 | 5 | There are 2 solutions you can use to monitor a running XWiki instance: |
 |
3.2 | 6 | * [[Use a Profiler>>http://dev.xwiki.org/xwiki/bin/view/Community/Profiling]]. This has the advantage of providing advanced information, but has the drawback of being resource intensive and thus slowing the XWiki instance. It also requires a special startupscript. |
| 7 | * Starting with XWiki Enterprise 2.4M2 we're now using the [[JMX Technology>>http://en.wikipedia.org/wiki/Java_Management_Extensions]] to provide runtime monitoring of XWiki instances. The following features are currently available: | ||
| |
1.1 | 8 | ** Monitor the Velocity macro caches |
| |
3.3 | 9 | ** Monitor the JBossCache caches XWiki is using to cache Document data, Users & Groups data and more |
| |
4.1 | 10 | ** Monitor the JGroups channel and protocols (when the XWiki Cluster feature is turned on) |
| |
1.1 | 11 | |
| |
2.3 | 12 | {{info}} |
| |
3.2 | 13 | XWiki also has a [[Monitor Plugin>>platform:AdminGuide.Logging#HActivatingtheXWikimonitoringfeature]] that you can use to monitor execution times. However this plugin is going to be deprecated in the future and replaced by the JMX technology. |
| |
2.3 | 14 | {{/info}} |
| 15 | |||
| |
1.1 | 16 | = JMX Console = |
| 17 | |||
| |
2.2 | 18 | Since JMX is a standard you can use [[any JMX-compatible monitoring console>>http://stackoverflow.com/questions/1744900/what-is-the-best-or-most-commonly-used-jmx-console-client]] (most application servers provide a web-based JMX console). There's also such a console called [[JConsole>>http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html]] and which is bundled by default in the Java Runtime you're using. To start it, simply execute the ##jconsole## executable. |
| |
1.1 | 19 | |
| |
4.1 | 20 | == Velocity Cache Monitoring == |
| |
1.1 | 21 | |
| |
4.1 | 22 | JConsole examples showing the Velocity Cache monitoring: |
| 23 | |||
| |
1.1 | 24 | image:jconsole1.png |
| 25 | |||
| 26 | image:jconsole2.png | ||
| 27 | |||
| |
4.1 | 28 | == JGroups Monitoring == |
| 29 | |||
| 30 | JConsole example showing the JGroups monitoring: | ||
| 31 | |||
| 32 | image:jgroups.png | ||
| 33 | |||
| 34 | Interesting things to do on JGroups in the JMX console: | ||
| 35 | * Change the log level on the protocols to enable logging | ||
| 36 | * Disconnect a node from the cluster and reconnect it | ||
| 37 |
