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.
The default configuration for this integration is not expected to impose a significant performance impact on the system.
Setup
Prerequisites
Enable monitoring interface
Ensure the IBM WebSphere JMX monitoring interface is accessible.
Configuration
Options
Configuration options for the websphere_jmx collector.
| 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.
jobs:
- name: local
endpoint: dummy://localhost
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.
