/usr/share/doc/libjmxetric-java/README.Debian is in libjmxetric-java 1.0.6-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 | Quickstart for Debian users:
- copy /usr/share/doc/libjmxetric-java/jmxetric.xml - for example:
mkdir -p /etc/ganglia
cp /usr/share/doc/libjmxetric-java/jmxetric.xml /etc/ganglia/jmxetric-tomcat7.xml
- edit the file
vi /etc/ganglia/jmxetric-tomcat7.xml
Replace the default metric name prefix "ProcessName" with something
meaningful, e.g:
<jvm process="ProcessName"/>
becomes:
<jvm process="tomcat7"/>
and then your metrics will have names like:
tomcat7_Heap_usage
- edit your JVM launch script or config file to add the necessary JVM
options, for example, if using the tomcat7 package on Debian:
cat >> /etc/default/tomcat7 << EOF
# for JMXetric
JARLIB=/usr/share/java
GANGLIA_ETC=/etc/ganglia
JMXETRIC_CFG=${GANGLIA_ETC}/jmxetric-tomcat7.xml
JMXETRIC_PARAMS="host=239.2.11.71,port=8649,wireformat31x=true,mode=multicast,config=${JMXETRIC_CFG}"
JAVA_OPTS="${JAVA_OPTS} -Xbootclasspath/p:${JARLIB}/oncrpc.jar"
JAVA_OPTS="${JAVA_OPTS} -Xbootclasspath/p:${JARLIB}/gmetric4j.jar"
JAVA_OPTS="${JAVA_OPTS} -javaagent:${JARLIB}/jmxetric.jar=${JMXETRIC_PARAMS}"
EOF
- in the above example, it is using a default multicast config host=239.2.11.71,mode=multicast
You can change those parameters if using unicast or a different multicast IP
- now restart the JVM
|