References > Template Reference > IBM > IBM WebSphere (JMX)

IBM WebSphere (JMX)

This template monitors IBM WebSphere server statistics by using the JMX protocol. You can use the Orion agent for Linux or SNMP agentless to monitor.

Works with the Orion Agent for Linux.

Prerequisites

Target server configured to allow JMX queries.

This template is configured to send JMX requests on port 8686.

Credentials

Dependent on the JMX configuration.

Configuring WebSphere for Orion agent for Linux

For JMX configurations, you need to install and configure WebSphere per your Linux distribution. For details, see the IBM WebSphere documentation site.

The overall steps include:

  1. Get and install WebSphere. You may require credentials for the installation.
  2. During installation, you can turn off the secure storage option as this is not needed. You may need to create a new package group. Make sure to select the Application Server during installation. You may also need to create an administrator account.
  3. Start and stop the WebSphere AppServer.
  4. Access the WebSphere AppServer console to continue configurations. You can access by pointing a browser to http://<websphere-host>:9060/ibm/console. You may need to open a port to 9060 on the websphere host. Use the credentials for the account created during installation.
  5. You need to expose the JMX platform mbeans in the WebSphere AppServer using the console. Click Servers > Server Types > WebSphere application servers and select the listed application server.
  6. Locate the Java and Process Management > Process definition. In the dialog box titled "Generic JVM arguments" enter the following:

    Djavax.management.builder.initial=

    There is nothing after the = sign.

    Dcom.sun.management.jmxremote=true

    Dcom.sun.management.jmxremote.port=8686

    Dcom.sun.management.jmxremote.ssl=false

    Dcom.sun.management.jmxremote.authenticate=false

  7. Restart the AppServer.

For more information, see Configuring Java Application Servers for JMX.

Monitored Components

For details on monitors, see SAM Component Monitor Types.

All components may vary from a running environment. You can add your own threshold limits as necessary.

Classes Loaded Count

This monitor returns the number of classes that are currently loaded in the Java virtual machine.

Classes Total Loaded Count

This monitor returns the total number of classes that have been loaded since the Java virtual machine has started execution.

Classes Unloaded Count

This monitor returns the total number of classes unloaded since the Java virtual machine has started execution.

Memory Pending Final Count

This monitor returns the approximate number of objects for which finalization is pending.

Memory Heap Init Size (B)

This monitor returns the initial amount of memory in bytes that the Java virtual machine allocates; or -1 if undefined.

Memory Heap Used (B)

This monitor returns the amount of used memory in bytes. The amount of used memory in the returned memory usage is the amount of memory occupied by both live objects and garbage objects that have not been collected, if any.

Memory Heap Committed (B)

This monitor returns the amount of committed memory in bytes.

Memory Heap Max Size (B)

This monitor returns the maximum amount of memory in bytes that can be used; or -1 if undefined.

Memory Non Heap Init Size (B)

This monitor returns the initial amount of memory in bytes that the Java virtual machine allocates; or -1 if undefined.

Memory Non Heap Used (B)

This monitor returns the amount of used memory in bytes.

Memory Non Heap Committed (B)

This monitor returns the amount of committed memory in bytes.

Memory Non Heap Max Size (B)

This monitor returns the maximum amount of memory in bytes that can be used; or -1 if undefined.

Memory Garbage Collections Count

This monitor returns the total number of collections that have occurred.

Memory Garbage Collection Time (ms)

This monitor returns the approximate accumulated collection elapsed time in milliseconds.

Threads Total Started Count

This monitor returns the total number of threads created and also started since the Java virtual machine started.

Current Thread Count

This monitor returns the current number of live threads including both daemon and non-daemon threads.

Current Thread Cpu Time

This monitor returns the total CPU time for the current thread in nanoseconds.

Current Thread User Time

This monitor returns the CPU time that the current thread has executed in user mode in nanoseconds.

Runtime Uptime (ms)

This monitor returns the uptime of the Java virtual machine in milliseconds.

Compiler Time (ms)

This monitor returns the approximate accumulated elapsed time (in milliseconds) spent in compilation.