How does eG Enterprise monitor the IBM WebSphere Liberty?

eG Enterprise monitors the IBM WebSphere Liberty server in an agent-based manner only. The eG agent uses the JMX architecture supported by the IBM WebSphere Liberty server to gather the required metrics. The eG agent should be installed on the same host where the target IBM WebSphere Liberty server is installed.

Pre-Requisites for monitoring the IBM WebSphere Liberty installed on Windows environments

The eG agent uses the JMX architecture to collect the required metrics. For the eG agent to collect the metrics, the following pre-requisites need to be fulfilled:

1. The IBM WebSphere Liberty server should be up and running.

2. To monitor the target IBM WebSphere Liberty server and to enable the eG agent to collect metrics from the target IBM WebSphere Liberty server, the following 'Liberty features' should be enabled. Features are the units of functionality by which administrators control the pieces of the runtime environment that are loaded into a particular server.

   • monitor-1.0
   • localconnector-1.0

   To enable the features, do the following:

   • Open the server.xml file that is available in the <liberty_server_install_dir>\ usr\servers\server_name folder using a text editor.

   • Append the following lines within the <featureManager> section of the server.xml file:

     <feature>monitor-1.0</feature>
     <feature>localConnector-1.0</feature>

   • Finally, save the file.

   Once the local connector is enabled, a com.ibm.ws.jmx.local.address file will be created in the ${server.output.dir}/logs/state folder. The eG agent uses the contents of this file to collect the required metrics from the target IBM WebSphere Liberty server. For the eG agent to use this file, it is necessary to specify the exact path to this file against the Service URL Path parameter while configuring the tests applicable to the IBM WebSphere Liberty server.

Pre-Requisites for monitoring the IBM WebSphere Liberty server installed on Linux environments

Apart from the pre-requisites mentioned in Pre-Requisites for monitoring the IBM WebSphere Liberty installed on Windows environmentsthe following pre-requisite needs to be fulfilled if an IBM WebSphere Liberty server is installed on Linux environments:

For the eG agent to collect the required metrics, the eG agent communicates with the target IBM WebSphere Liberty server with the privileges of a user who is able to connect via SSH. The user should be within the user group that is privileged to access the target IBM WebSphere Liberty server.