IBM WebSphere JMX

Plugin: ibm.d.plugin Module: websphere_jmx

Overview

Collects JVM, thread pool, and middleware metrics from IBM WebSphere Application Server via the embedded JMX bridge helper.

The collector connects to IBM WebSphere JMX and collects metrics via its monitoring interface.

This collector is supported on all platforms.

This collector supports collecting metrics from multiple instances of this integration, including remote instances.

Default Behavior

Auto-Detection

This integration doesn't support auto-detection.

Limits

The default configuration for this integration does not impose any limits on data collection.

Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.

Metrics

Metrics grouped by scope.

The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.

Per applications

These metrics refer to applications instances.

Labels:

Label	Description
application	Application identifier
module	Module identifier

Metrics:

Metric	Dimensions	Unit
websphere_jmx.app_requests	requests	requests
websphere_jmx.app_response_time	response_time	milliseconds
websphere_jmx.app_sessions_active	active	sessions
websphere_jmx.app_sessions_live	live	sessions
websphere_jmx.app_session_events	creates, invalidates	sessions
websphere_jmx.app_transactions	committed, rolledback	transactions

Per jca

These metrics refer to jca instances.

Labels:

Label	Description
pool	Pool identifier

Metrics:

Metric	Dimensions	Unit
websphere_jmx.jca_pool_size	size	connections
websphere_jmx.jca_pool_usage	active, free	connections
websphere_jmx.jca_pool_wait_time	wait	milliseconds
websphere_jmx.jca_pool_use_time	use	milliseconds
websphere_jmx.jca_pool_connections	created, destroyed	connections
websphere_jmx.jca_pool_waiting_threads	waiting	threads

Per jdbc

These metrics refer to jdbc instances.

Labels:

Label	Description
pool	Pool identifier

Metrics:

Metric	Dimensions	Unit
websphere_jmx.jdbc_pool_size	size	connections
websphere_jmx.jdbc_pool_usage	active, free	connections
websphere_jmx.jdbc_pool_wait_time	wait	milliseconds
websphere_jmx.jdbc_pool_use_time	use	milliseconds
websphere_jmx.jdbc_pool_connections	created, destroyed	connections
websphere_jmx.jdbc_pool_waiting_threads	waiting	threads

Per jms

These metrics refer to jms instances.

Labels:

Label	Description
destination	Destination identifier
destination_type	Destination_type identifier

Metrics:

Metric	Dimensions	Unit
websphere_jmx.jms_messages_current	current	messages
websphere_jmx.jms_messages_pending	pending	messages
websphere_jmx.jms_messages_total	total	messages
websphere_jmx.jms_consumers	consumers	consumers

Per IBM WebSphere JMX instance

These metrics refer to the entire monitored instance.

This scope has no labels.

Metrics:

Metric	Dimensions	Unit
websphere_jmx.jvm_heap_memory	used, committed, max	bytes
websphere_jmx.jvm_heap_usage	usage	percentage
websphere_jmx.jvm_nonheap_memory	used, committed	bytes
websphere_jmx.jvm_gc_count	collections	collections
websphere_jmx.jvm_gc_time	time	milliseconds
websphere_jmx.jvm_threads	total, daemon	threads
websphere_jmx.jvm_thread_states	peak, started	threads
websphere_jmx.jvm_classes	loaded, unloaded	classes
websphere_jmx.jvm_process_cpu_usage	cpu	percentage
websphere_jmx.jvm_uptime	uptime	seconds

Per threadpools

These metrics refer to threadpools instances.

Labels:

Label	Description
pool	Pool identifier

Metrics:

Metric	Dimensions	Unit
websphere_jmx.threadpool_size	size, max	threads
websphere_jmx.threadpool_active	active	threads

Alerts

There are no alerts configured by default for this integration.

Setup

Prerequisites

Enable monitoring interface

Ensure the IBM WebSphere JMX monitoring interface is accessible.

Configuration

Options

Configuration options for the websphere_jmx collector.

Config options

Option	Description	Default	Required
update_every	Data collection frequency.	1	no
endpoint	Connection endpoint.	dummy://localhost	no

via File

The configuration file name for this integration is ibm.d/websphere_jmx.conf.

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config ibm.d/websphere_jmx.conf

Examples

Basic

Basic configuration example.

Config

jobs:
  - name: local
    endpoint: dummy://localhost