Monitoring WebSphere Liberty

After you install the Instana host agent, WebSphere Liberty sensor is automatically installed, but you need to configure as outlined in this topic. Then, you can view metrics that are related with WebSphere Liberty in the Instana UI.

Supported information

Supported operating systems

See Supported operating systems for WebSphere Liberty sensor.

Supported WebSphere Liberty versions and platforms

Instana supports metrics and configuration data for IBM WebSphere Liberty 18.0.0.3 and later, which are installed in the following platforms:

Operating system Hardware
AIX 7.1 POWER System - Big Endian
macOS Big Sur 11.0 x86-64
Solaris 10 SPARC
Solaris 11 SPARC
Windows Server 2012 Standard Edition x86-64
Amazon Linux 1 x86-64
Amazon Linux 2 x86-64
CentOS 6.0 x86-32
CentOS 6.0 x86-64
CentOS 7 POWER System - Little Endian
CentOS 7 x86-32
CentOS 7 x86-64
CentOS 8 x86-64
Debian 10 x86-32
Debian 10 x86-64
Debian 9.0 x86-32
Debian 9.0 x86-64
Red Hat Enterprise Linux (RHEL) 9 IBM z Systems
Red Hat Enterprise Linux (RHEL) 9 POWER System - Little Endian
Red Hat Enterprise Linux (RHEL) 9 x86-64
Red Hat Enterprise Linux (RHEL) 8 IBM z Systems
Red Hat Enterprise Linux (RHEL) 8 POWER System - Little Endian
Red Hat Enterprise Linux (RHEL) 8 x86-64
Red Hat Enterprise Linux (RHEL) Server 6 IBM z Systems
Red Hat Enterprise Linux (RHEL) Server 6 x86-64
Red Hat Enterprise Linux (RHEL) Server 7 IBM z Systems
Red Hat Enterprise Linux (RHEL) Server 7 x86-64
SUSE Linux Enterprise Server (SLES) 12 IBM z Systems
SUSE Linux Enterprise Server (SLES) 12 POWER System - Little Endian
SUSE Linux Enterprise Server (SLES) 12 x86-64
SUSE Linux Enterprise Server (SLES) 15 IBM z Systems
SUSE Linux Enterprise Server (SLES) 15 POWER System - Little Endian
SUSE Linux Enterprise Server (SLES) 15 x86-64
Ubuntu 14.04 LTS POWER System - Little Endian
Ubuntu 14.04 LTS x86-32
Ubuntu 14.04 LTS x86-64
Ubuntu 16.04 LTS IBM z Systems
Ubuntu 16.04 LTS POWER System - Little Endian
Ubuntu 16.04 LTS x86-32
Ubuntu 16.04 LTS x86-64
Ubuntu 18.04 LTS IBM z Systems
Ubuntu 18.04 LTS POWER System - Little Endian
Ubuntu 18.04 LTS x86-32
Ubuntu 18.04 LTS x86-64
Ubuntu 20.04 LTS IBM z Systems
Ubuntu 20.04 LTS POWER System - Little Endian
Ubuntu 20.04 LTS x86-64

Supported tracing

For this technology, Instana supports tracing. For more information, see Instrumented frameworks and libraries.

To enable tracing for Liberty on z/OS, complete the steps in the Instana on z/OS Tracing requirement.

Configuring

Enabling JMX

If JMX is not enabled, the following message will be shown in the UI:

It seems that monitor feature is not enabled. Please add monitor-1.0 feature in server.xml

You can enable JMX access by adding the following line to the server.xml file that is located in the <websphere-liberty_install_dir/usr/servers/<specific_server>/ directory.

<feature>monitor-1.0</feature>

Viewing metrics

To view the metrics, complete the following steps:

  1. In the sidebar of the Instana UI, select Infrastructure.
  2. Click a specific monitored host.

Then, you can see a host dashboard with all the collected metrics and monitored processes.

Configuration data

  • Name
  • Version
  • Install Dir
  • Ports
  • Application States

Performance metrics

  • Thread Pool
  • Servlets
    • Name
    • Requests
    • Average Response Time
  • Database Connections Pools
  • Sessions
  • Queues
    • Queue Name
    • State
    • Depth

Viewing JMS metrics

The Java Message Service (JMS) metrics are collected from Tracing. These metrics are shown on the "Analytics" dashboard with the filtering Call > Type = MESSAGING AND Dest > Endpoint > Name = <Your destination>:

JMS Query

For more information, see Unbounded analytics.

Tracing

Instana provides tracing support for WebSphere Liberty, and more information can be found here: Monitoring Java Virtual Machine.

Disabling the WebSphere Liberty sensor

To disable this sensor, add the following settings to your agent configuration.yaml file:

com.instana.plugin.websphereliberty
  enabled: false