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.
Support information
To make sure that the WebSphere Liberty sensor is compatible with your current setup, check the following support information sections:
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 operating systems for Linux
- Supported operating systems for Unix
- Supported operating systems for Windows
The sensor supports 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 |
| IBM i 7.4 and later | POWER System - Big Endian |
| 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 |
| z/OS 2.4 and later | s390x |
Supported versions and support policy
The following table shows the latest supported version and support policy:
| Technology | Support policy | Latest technology version | Latest supported version |
|---|---|---|---|
| Websphere Liberty | 45 days | 26.0.0.2 | 25.0.0.12 |
For more information about the support policy, see Support strategy for sensors.
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
The agent natively monitors the WebSphere Liberty, and configuration is optional.
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>
Configuring the polling rate
You can configure how often Instana polls WebSphere Liberty to collect data and metrics by using the poll_rate parameter in the agent configuration.yaml file as shown in the following example:
com.instana.plugin.websphereliberty:
poll_rate: 1 # values are in seconds. Default value is 1 second.Viewing metrics
To view the metrics, complete the following steps:
- In the sidebar of the Instana UI, select Infrastructure.
- 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
server.xml configuration to include only specific metrics, some of the metrics in the preceding list might be missing.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>:
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