Wiki source code of Monitoring
Version 4.1 by Vincent Massol on 2011/05/06
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | There are 2 solutions you can use to monitor a running XWiki instance: |
 |
3.2 | 2 | * [[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. |
| 3 | * 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 | 4 | ** Monitor the Velocity macro caches |
| |
3.3 | 5 | ** Monitor the JBossCache caches XWiki is using to cache Document data, Users & Groups data and more |
| |
4.1 | 6 | ** Monitor the JGroups channel and protocols (when the XWiki Cluster feature is turned on) |
| |
1.1 | 7 | |
| |
2.3 | 8 | {{info}} |
| |
3.2 | 9 | 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 | 10 | {{/info}} |
| 11 | |||
| |
1.1 | 12 | = JMX Console = |
| 13 | |||
| |
2.2 | 14 | 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 | 15 | |
| |
4.1 | 16 | == Velocity Cache Monitoring == |
| |
1.1 | 17 | |
| |
4.1 | 18 | JConsole examples showing the Velocity Cache monitoring: |
| 19 | |||
| |
1.1 | 20 | image:jconsole1.png |
| 21 | |||
| 22 | image:jconsole2.png | ||
| 23 | |||
| |
4.1 | 24 | == JGroups Monitoring == |
| 25 | |||
| 26 | JConsole example showing the JGroups monitoring: | ||
| 27 | |||
| 28 | image:jgroups.png | ||
| 29 | |||
| 30 | Interesting things to do on JGroups in the JMX console: | ||
| 31 | * Change the log level on the protocols to enable logging | ||
| 32 | * Disconnect a node from the cluster and reconnect it | ||
| 33 |
