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) 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 |
Tracing requirements
Instana provides tracing support for WebSphere AS. For more information about tracing requirements, refer to the Monitoring Java Virtual Machine - System requirements topic.
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:
- 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
Tracing
Instana provides tracing support for WebSphere Liberty, and more information can be found here: Monitoring Java Virtual Machine.