hsperf a Munin Plugin

USAGE

1. unzip the archive content to /opt/hsperf
2. adjust the folders, graphs and properties in the file plugins/hsperf
3. copy the files from plugin-conf.d and plugins to the corresponding folders in /etc/munin
4. restart munin-node (systemctl restart munin-node)

EXAMPLE CONFIG

JVM Memory graph

• used size of the old generation
• used size of ede
• used size of survivors 0
• used size of survivors 1

JVM Thread graph

• count of live threads
• max of live threads
• count of started thread in the last interval

PREPARATION

1. Ensure that each JVM is running with an own user. This avoids appearing process id's in the graph legends.
2. Identify all /tmp/hsperfdata_<username> folders to appear in the graph and add these paths to the observed folders. Edit plugins/hsperf, e.g.:

   FOLDERS="  /tmp/hsperfdata_domain01"
   FOLDERS+=" /tmp/hsperfdata_domain02"
   FOLDERS+=" /tmp/hsperfdata_bejy"
   FOLDERS+=" /tmp/hsperfdata_bebbo"
   

3. Define the graphs and properties to display. Edit plugins/hsperf, e.g.:

   GRAPHS="threads|JVM Threads|number of threads|threadCount,threadMax,threadsStarted"
   GRAPHS+='" "'
   GRAPHS+="memory|JVM Memory|bytes|old,eden,s0,s1"
   
   PROPS="  threadCount=java.threads.live"
   PROPS+=" threadMax=java.threads.livePeak"
   PROPS+=" threadsStarted+=java.threads.started"
   PROPS+=" old=sun.gc.generation.1.space.0.used"
   PROPS+=" eden=sun.gc.generation.0.space.0.used"
   PROPS+=" s0=sun.gc.generation.0.space.1.used"
   PROPS+=" s1=sun.gc.generation.0.space.2.used"
   

 /opt/hsperf/plugins/hsperf --showprops 

VERSION

• V2 changed type from COUNTER to DERIVED V2 added
• ".min 0" to each counter to avoid spikes

• V1 initial commit

LICENSE