IBM WebSphere MicroProfile

Plugin: ibm.d.plugin Module: websphere_mp

Overview

Collects JVM, vendor, and REST endpoint metrics from WebSphere Liberty / Open Liberty servers via the MicroProfile Metrics (Prometheus/OpenMetrics) endpoint.

The collector connects to IBM WebSphere MicroProfile 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 IBM WebSphere MicroProfile instance

These metrics refer to the entire monitored instance.

This scope has no labels.

Metrics:

Metric	Dimensions	Unit
websphere_mp.cpu_usage	process, utilization	percentage
websphere_mp.cpu_time	total	seconds

Per IBM WebSphere MicroProfile instance

These metrics refer to the entire monitored instance.

This scope has no labels.

Metrics:

Metric	Dimensions	Unit
websphere_mp.jvm_memory_heap_usage	used, free	bytes
websphere_mp.jvm_memory_heap_committed	committed	bytes
websphere_mp.jvm_memory_heap_max	limit	bytes
websphere_mp.jvm_heap_utilization	utilization	percentage
websphere_mp.jvm_gc_collections	rate	collections/s
websphere_mp.jvm_gc_time	total, per_cycle	milliseconds
websphere_mp.jvm_threads_current	daemon, other	threads
websphere_mp.jvm_threads_peak	peak	threads

Per restendpoint

These metrics refer to restendpoint instances.

Labels:

Label	Description
method	Method identifier
endpoint	Endpoint identifier

Metrics:

Metric	Dimensions	Unit
websphere_mp.rest_requests	requests	requests/s
websphere_mp.rest_response_time	average	milliseconds

Per IBM WebSphere MicroProfile instance

These metrics refer to the entire monitored instance.

This scope has no labels.

Metrics:

Metric	Dimensions	Unit
websphere_mp.threadpool_usage	active, idle	threads
websphere_mp.threadpool_size	size	threads

Alerts

There are no alerts configured by default for this integration.

Setup

Prerequisites

Enable monitoring interface

Ensure the IBM WebSphere MicroProfile monitoring interface is accessible.

Configuration

Options

Configuration options for the websphere_mp 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_mp.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_mp.conf

Examples

Basic

Basic configuration example.

Config

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