Jolokia is a JSON-HTTP adapter for Java Management Extensions (JMX) that facilitates interaction with JMX MBeans for remote operations. It addresses issues such as firewall and security restrictions associated with JSR-160 while supporting various clients and tools for ease of use. The presentation includes setup examples, request types, and highlights the unique features and advantages of using Jolokia over traditional JMX connectors.

1. Jolokia - JMX on Capsaicin
Roland Huß
Chili-Head
ConSol* Software GmbH

2. Me and the Chili
• Development and Operations @ ConSol
– Large Java Projects
– Remote Operations
– Open Source Monitoring (Nagios)
– www.consol.com
• Open Source Author
– roland@cpan.org
– https://github.com/rhuss
• Chili grower since 2005
2

3. JMX
JSR-3
JSR-160
The Problem

4. JMX Refresher
• Java Management Extensions (JMX)
• JSR-3 (2000)
• Available out of the box since JDK 1.5
• JMX-Operations:
– Attribute reading
– Attribute writing
– Execution of operations
– Notifications
4

5. JMX Architecture
5

6. JMX Remote API
• JSR-160 (2003)
• Problems:
– Firewalls
– Security is typically „all-or-nothing“
– Strongly typed
– Java only
6

7. Jolokia
Overview
Features
Clients
Tools

8. How it works
8

9. Agents
JEE
OSGi
Mule
JVM
9

10. Tested on ...
Tomcat 5.5, 6.0, 7.0 Felix 2.0, 3.2, 4.0
3.5, 3.6,
Jetty 5.1, 6.1, 7.5, 8.0 Equinox 3.7, 3.8 M1
9.2.3, 10.0.2,
Weblogic 10.3.5 Knopflerfish 3.2
Websphere 6.1, 7.0, 8.0 Virgo 2.1, 3.0
Glassfish 2.1, 3.0, 3.1 Spring dm Server 2.0
JBoss 4.2, 5.1, 6.1, 7.0 Mule 2.2, 3.1, 3.2
Jonas 4.10, 5.1, 5.2 ActiveMQ 5.5
Geronimo 2.1, 2.2, 3.0 M1 Terracotta 3.2
Camel 2.8 Hadoop 0.20 10

11. Quickstart
11

12. Request
• HTTP GET
http://localhost/jolokia/read/java.lang:type=Memory/HeapMemoryUsage
• HTTP POST
{
"type":"read",
"mbean":"java.lang:type=Memory",
"attribute":"HeapMemoryUsage"
}
12

13. Response
{
"value": {
"init": 134217728,
"max": 532742144,
"committed": 133365760,
"used": 19046472
},
"status": 200,
"timestamp": 1244839118,
"request": {
"mbean": "java.lang:type=Memory",
"type": "read",
"attribute": "HeapMemoryUsage"
}
}
13

14. Request Types
version Version and server information
read Reading of attributes
write Writing of attributes
exec Execution of operations
search Pattern search for MBeans
list MBean meta data
14

15. Bulk Requests
[
{
"type" : "read",
"mbean" : "java.lang:type=Memory",
"attribute" : "HeapMemoryUsage",
"path" : "used",
},
{
"type" : "search",
"mbean" : "*:type=Memory,*"
}
]
15

16. JSR-160 Proxy
16

17. Proxy Request
{
"attribute" : "HeapMemoryUsage",
"mbean" : "java.lang:type=Memory",
"target": {
"url" : "service:jmx:iiop://websphere:2810/jndi/JMXConnector"
"user" : "roland",
"password" : "s!cr!t"
},
"type" : "READ"
}
17

18. Security
• JSR-160 Security
– Java Security and JAAS
• Jolokia Security
– HTTP Security
– Access Control with Policy Files
• Network location
• Command types
• MBean, attribute and operation names
18

19. Clients
Perl Jmx4Perl
Javascript Jolokia
Java Jolokia
Python Jmx4Py Jürgen Herrmann
Node.js jolokia-client Joachim Kainz
Groovy
Scala You ?
.....
19

20. Javascript Demo
20

21. Javascript
var j4p = new Jolokia("/jolokia");
var data = [];
function run() {
j4p.request({
type: "read",
mbean: "java.lang:type=Memory",
attribute: "HeapMemoryUsage"
},
{
success: function(resp) {
data.push([resp.timestamp,resp.value.used]);
$.plot($("#memory"),[data],{ xaxis: { mode: "time" }});
setTimeout(run,1000);
}
});
}
run();
21

22. Tools
jmx4perl CLI Tool
check_jmx4perl Nagios Plugin
cacti_jmx4perl Cacti Plugin
j4psh JMX Shell
AccessJ iPhone Client
Roo Addon Spring Roo Addon
22

23. j4psh
23

24. Wrap up
• JMX is good
• JSR-160 connectors are bad
• Jolokia ...
... is a JSON-HTTP adaptor to JMX
... has unique features
... allows for non-Java clients
... has good tool support
24

25. Resources
• www.jolokia.org
• Reference-Manual: http://www.jolokia.org/reference/html/
• Forum: http://www.jolokia.org/forum.html
• Blog
• ConSol Labs: http://labs.consol.de
• Github
• https://github.com/rhuss/jolokia
• T-Shirts ;-)
• http://jolokia.spreadshirt.de
• Twitter: @jolokia_jmx
25

26. Questions ?