JMX

JMX

Java Management Extensions (JMX) is a Java technology that supplies tools for managing and monitoring applications, system objects, devices and service-oriented networks. Those resources are represented by objects called MBeans. In the API, classes can be dynamically loaded and instantiated.

Available solutions




This template is for Zabbix version: 7.0

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/generic_java_jmx?at=release/7.0

Generic Java JMX

Overview

Official JMX Template from Zabbix distribution. Could be useful for many Java Applications (JMX).

Requirements

Zabbix version: 7.0 and higher.

Tested versions

This template has been tested on:

  • Java Applications

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

Refer to the vendor documentation.

Macros used

Name Description Default
{$JMX.NONHEAP.MEM.USAGE.MAX}

A threshold in percent for Non-heap memory utilization trigger.

 85
{$JMX.NONHEAP.MEM.USAGE.TIME}

The time during which the Non-heap memory utilization may exceed the threshold.

 10m
{$JMX.HEAP.MEM.USAGE.MAX}

A threshold in percent for Heap memory utilization trigger.

 85
{$JMX.HEAP.MEM.USAGE.TIME}

The time during which the Heap memory utilization may exceed the threshold.

 10m
{$JMX.MP.USAGE.MAX}

A threshold in percent for memory pools utilization trigger. Use a context to change the threshold for a specific pool.

 85
{$JMX.MP.USAGE.TIME}

The time during which the memory pools utilization may exceed the threshold.

 10m
{$JMX.FILE.DESCRIPTORS.MAX}

A threshold in percent for file descriptors count trigger.

 85
{$JMX.FILE.DESCRIPTORS.TIME}

The time during which the file descriptors count may exceed the threshold.

 3m
{$JMX.CPU.LOAD.MAX}

A threshold in percent for CPU utilization trigger.

 85
{$JMX.CPU.LOAD.TIME}

The time during which the CPU utilization may exceed the threshold.

 5m
{$JMX.MEM.POOL.NAME.MATCHES}

This macro used in memory pool discovery as a filter.

 Old Gen|G1|Perm Gen|Code Cache|Tenured Gen
{$JMX.USER}

JMX username.
{$JMX.PASSWORD}

JMX password.

Items

Name Description Type Key and additional info
ClassLoading: Loaded class count

Displays number of classes that are currently loaded in the Java virtual machine.

 JMX agent jmx["java.lang:type=ClassLoading","LoadedClassCount"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
ClassLoading: Total loaded class count

Displays the total number of classes that have been loaded since the Java virtual machine has started execution.

 JMX agent jmx["java.lang:type=ClassLoading","TotalLoadedClassCount"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
ClassLoading: Unloaded class count

Displays the total number of classes that have been loaded since the Java virtual machine has started execution.

 JMX agent jmx["java.lang:type=ClassLoading","UnloadedClassCount"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Compilation: Name of the current JIT compiler

Displays the total number of classes unloaded since the Java virtual machine has started execution.

 JMX agent jmx["java.lang:type=Compilation","Name"]

Preprocessing

  • Discard unchanged with heartbeat: 30m
Compilation: Accumulated time spent

Displays the approximate accumulated elapsed time spent in compilation, in seconds.

 JMX agent jmx["java.lang:type=Compilation","TotalCompilationTime"]

Preprocessing

  • Custom multiplier: 0.001

  • Discard unchanged with heartbeat: 10m
Memory: Heap memory committed

Current heap memory allocated. This amount of memory is guaranteed for the Java virtual machine to use.

 JMX agent jmx["java.lang:type=Memory","HeapMemoryUsage.committed"]
Memory: Heap memory maximum size

Maximum amount of heap that can be used for memory management. This amount of memory is not guaranteed to be available if it is greater than the amount of committed memory. The Java virtual machine may fail to allocate memory even if the amount of used memory does not exceed this maximum size.

 JMX agent jmx["java.lang:type=Memory","HeapMemoryUsage.max"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Memory: Heap memory used

Current memory usage outside the heap.

 JMX agent jmx["java.lang:type=Memory","HeapMemoryUsage.used"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Memory: Non-Heap memory committed

Current memory allocated outside the heap. This amount of memory is guaranteed for the Java virtual machine to use.

 JMX agent jmx["java.lang:type=Memory","NonHeapMemoryUsage.committed"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Memory: Non-Heap memory maximum size

Maximum amount of non-heap memory that can be used for memory management. This amount of memory is not guaranteed to be available if it is greater than the amount of committed memory. The Java virtual machine may fail to allocate memory even if the amount of used memory does not exceed this maximum size.

 JMX agent jmx["java.lang:type=Memory","NonHeapMemoryUsage.max"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Memory: Non-Heap memory used

Current memory usage outside the heap

 JMX agent jmx["java.lang:type=Memory","NonHeapMemoryUsage.used"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Memory: Object pending finalization count

The approximate number of objects for which finalization is pending.

 JMX agent jmx["java.lang:type=Memory","ObjectPendingFinalizationCount"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
OperatingSystem: File descriptors maximum count

This is the number of file descriptors we can have opened in the same process, as determined by the operating system. You can never have more file descriptors than this number.

 JMX agent jmx["java.lang:type=OperatingSystem","MaxFileDescriptorCount"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
OperatingSystem: File descriptors opened

This is the number of opened file descriptors at the moment, if this reaches the MaxFileDescriptorCount, the application will throw an IOException: Too many open files. This could mean you are opening file descriptors and never closing them.

 JMX agent jmx["java.lang:type=OperatingSystem","OpenFileDescriptorCount"]
OperatingSystem: Process CPU Load

ProcessCpuLoad represents the CPU load in this process.

 JMX agent jmx["java.lang:type=OperatingSystem","ProcessCpuLoad"]

Preprocessing

  • Custom multiplier: 100
Runtime: JVM uptime JMX agent jmx["java.lang:type=Runtime","Uptime"]

Preprocessing

  • Custom multiplier: 0.001
Runtime: JVM name JMX agent jmx["java.lang:type=Runtime","VmName"]

Preprocessing

  • Discard unchanged with heartbeat: 30m
Runtime: JVM version JMX agent jmx["java.lang:type=Runtime","VmVersion"]

Preprocessing

  • Discard unchanged with heartbeat: 30m
Threading: Daemon thread count

Number of daemon threads running.

 JMX agent jmx["java.lang:type=Threading","DaemonThreadCount"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Threading: Peak thread count

Maximum number of threads being executed at the same time since the JVM was started or the peak was reset.

 JMX agent jmx["java.lang:type=Threading","PeakThreadCount"]
Threading: Thread count

The number of threads running at the current moment.

 JMX agent jmx["java.lang:type=Threading","ThreadCount"]
Threading: Total started thread count

The number of threads started since the JVM was launched.

 JMX agent jmx["java.lang:type=Threading","TotalStartedThreadCount"]

Triggers

Name Description Expression Severity Dependencies and additional info
Generic Java JMX: Compilation: {HOST.NAME} uses suboptimal JIT compiler find(/Generic Java JMX/jmx["java.lang:type=Compilation","Name"],,"like","Client")=1 Info Manual close: Yes
Generic Java JMX: Memory: Heap memory usage is high min(/Generic Java JMX/jmx["java.lang:type=Memory","HeapMemoryUsage.used"],{$JMX.HEAP.MEM.USAGE.TIME})>(last(/Generic Java JMX/jmx["java.lang:type=Memory","HeapMemoryUsage.max"])*{$JMX.HEAP.MEM.USAGE.MAX}/100) and last(/Generic Java JMX/jmx["java.lang:type=Memory","HeapMemoryUsage.max"])>0 Warning
Generic Java JMX: Memory: Non-Heap memory usage is high min(/Generic Java JMX/jmx["java.lang:type=Memory","NonHeapMemoryUsage.used"],{$JMX.NONHEAP.MEM.USAGE.TIME})>(last(/Generic Java JMX/jmx["java.lang:type=Memory","NonHeapMemoryUsage.max"])*{$JMX.NONHEAP.MEM.USAGE.MAX}/100) and last(/Generic Java JMX/jmx["java.lang:type=Memory","NonHeapMemoryUsage.max"])>0 Warning
Generic Java JMX: OperatingSystem: Opened file descriptor count is high min(/Generic Java JMX/jmx["java.lang:type=OperatingSystem","OpenFileDescriptorCount"],{$JMX.FILE.DESCRIPTORS.TIME})>(last(/Generic Java JMX/jmx["java.lang:type=OperatingSystem","MaxFileDescriptorCount"])*{$JMX.FILE.DESCRIPTORS.MAX}/100) Warning
Generic Java JMX: OperatingSystem: Process CPU Load is high min(/Generic Java JMX/jmx["java.lang:type=OperatingSystem","ProcessCpuLoad"],{$JMX.CPU.LOAD.TIME})>{$JMX.CPU.LOAD.MAX} Average
Generic Java JMX: Runtime: JVM is not reachable nodata(/Generic Java JMX/jmx["java.lang:type=Runtime","Uptime"],5m)=1 Average Manual close: Yes
Generic Java JMX: Runtime: {HOST.NAME} runs suboptimal VM type find(/Generic Java JMX/jmx["java.lang:type=Runtime","VmName"],,"like","Server")<>1 Info Manual close: Yes

LLD rule Garbage collector discovery

Name Description Type Key and additional info
Garbage collector discovery

Garbage collectors metrics discovery.

 JMX agent jmx.discovery["beans","java.lang:name=*,type=GarbageCollector"]

Item prototypes for Garbage collector discovery

Name Description Type Key and additional info
GarbageCollector: {#JMXNAME} number of collections per second

Displays the total number of collections that have occurred per second.

 JMX agent jmx["java.lang:name={#JMXNAME},type=GarbageCollector","CollectionCount"]

Preprocessing

  • Change per second
GarbageCollector: {#JMXNAME} accumulated time spent in collection

Displays the approximate accumulated collection elapsed time, in seconds.

 JMX agent jmx["java.lang:name={#JMXNAME},type=GarbageCollector","CollectionTime"]

Preprocessing

  • Custom multiplier: 0.001

  • Discard unchanged with heartbeat: 10m

LLD rule Memory pool discovery

Name Description Type Key and additional info
Memory pool discovery

Memory pools metrics discovery.

 JMX agent jmx.discovery["beans","java.lang:name=*,type=MemoryPool"]

Item prototypes for Memory pool discovery

Name Description Type Key and additional info
Memory pool: {#JMXNAME} committed

Current memory allocated.

 JMX agent jmx["java.lang:name={#JMXNAME},type=MemoryPool","Usage.committed"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Memory pool: {#JMXNAME} maximum size

Maximum amount of memory that can be used for memory management. This amount of memory is not guaranteed to be available if it is greater than the amount of committed memory. The Java virtual machine may fail to allocate memory even if the amount of used memory does not exceed this maximum size.

 JMX agent jmx["java.lang:name={#JMXNAME},type=MemoryPool","Usage.max"]

Preprocessing

  • Discard unchanged with heartbeat: 10m
Memory pool: {#JMXNAME} used

Current memory usage.

 JMX agent jmx["java.lang:name={#JMXNAME},type=MemoryPool","Usage.used"]

Trigger prototypes for Memory pool discovery

Name Description Expression Severity Dependencies and additional info
Generic Java JMX: Memory pool: {#JMXNAME} memory usage is high min(/Generic Java JMX/jmx["java.lang:name={#JMXNAME},type=MemoryPool","Usage.used"],{$JMX.MP.USAGE.TIME:"{#JMXNAME}"})>(last(/Generic Java JMX/jmx["java.lang:name={#JMXNAME},type=MemoryPool","Usage.max"])*{$JMX.MP.USAGE.MAX:"{#JMXNAME}"}/100) and last(/Generic Java JMX/jmx["java.lang:name={#JMXNAME},type=MemoryPool","Usage.max"])>0 Warning

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums

Articles and documentation

+ Propose new article

Didn't find what you are looking for?

Request custom integration

Zabbix integration team will develop custom integration based on your requirements and Zabbix best practices.

Request

Propose your integration

Have you already developed high quality integration and want to submit to Zabbix integration repository?

Propose