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

The supported operating systems of the WebSphere Liberty sensor are consistent with the host agent requirements. For more information, see the Supported operating systems section of the Windows, Unix, or Linux host agent documentation:

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 and later POWER System - Big Endian
macOS Big Sur 11.0 and later x86-64
Solaris 10 SPARC
Solaris 11 and later SPARC
Windows Server 2012 Standard Edition and later x86-64
Amazon Linux 1 x86-64
Amazon Linux 2 and later 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 and later x86-64
Debian 10 and later x86-32
Debian 10 and later x86-64
Debian 9.0 and later x86-32
Debian 9.0 and later x86-64
Red Hat Enterprise Linux (RHEL) 9 and later IBM z Systems
Red Hat Enterprise Linux (RHEL) 9 and later POWER System - Little Endian
Red Hat Enterprise Linux (RHEL) 9 and later 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 and later IBM z Systems
Red Hat Enterprise Linux (RHEL) Server 7 and later 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 and later IBM z Systems
SUSE Linux Enterprise Server (SLES) 15 and later POWER System - Little Endian
SUSE Linux Enterprise Server (SLES) 15 and later 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 and later POWER System - Little Endian
Ubuntu 20.04 LTS and later 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. For more information, see 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