JMX Monitoring
Java Management Extensions (JMX) is a technology that lets you implement management interfaces for Java applications. JConsole is a JMX-compliant monitoring tool, which comes with the Java Development Kit (JDK) 1.5 or later versions. Therefore, when you use a WSO2 product, JMX is enabled by default, which allows you to monitor the product using JConsole.
Go to the WSO2 Administration Guide for detailed instructions on how to configure JMX for a WSO2 product and how to use JConsole for monitoring a product.
MBeans for WSO2 EI
When JMX is enabled, WSO2 EI exposes a number of management resources as JMX Management Beans (MBeans) that can be used for managing and monitoring the running server. When you start JConsole, you can monitor these MBeans from the MBeans tab. While some of these MBeans (ServerAdmin and DataSource) are common to all WSO2 products, some MBeans are specific to WSO2 EI.
The common MBeans are explained in detail in the WSO2 Administration Guide. Listed below are the MBeans that are specific to WSO2 EI.
For details on using JMX based mediation flow statistics in your EI server and detailed explanation of the relevant MBeans, see Monitoring JMX Based Statistics .
This section summarizes the attributes and operations available for the following WSO2 EI specific MBeans:
Connection MBeans
These MBeans provide connection statistics for the HTTP and HTTPS transports.
You can view the following Connection MBeans:
org.apache.synapse/PassThroughConnections/http-listenerorg.apache.synapse/PassThroughConnections/http-senderorg.apache.synapse/PassThroughConnections/https-listenerorg.apache.synapse/PassThroughConnections/https-sender
Attributes
Attribute Name | Description |
|---|---|
| Number of currently active connections. |
| A map of the number of connections against hosts. |
| The number of connections created during last Xxx time period. |
| A map of the number of requests against their sizes. |
| A map of the number of responses against their sizes. |
| The time when the connection-statistic recordings were last reset. |
Operations
Operation Name | Description |
|---|---|
| Clear recorded connection statistics and restart recording. |
Latency MBeans
This view provides statistics of the latencies from all backend services connected through the HTTP and HTTPS transports. These statistics are provided as an aggregate value.
You can view the following Latency MBeans:
org.apache.synapse/PassthroughLatencyView/nio-http-httporg.apache.synapse/PassthroughLatencyView/nio-https-https
Attributes
Attribute Name | Description |
|---|---|
| Average latency since the latency recording was last reset. |
| Average latency for last xxx time period. For example, LastHourAvgLatency returns the average latency for the last hour. |
| The time when the latency-statistic recordings were last reset. |
Operations
Operation Name | Description |
|---|---|
| Clear recorded latency statistics and restart recording. |
Threading MBeans
These MBeans are only available in the NHTTP transport and not in the default Pass-Through transport.
You can view the following Threading MBeans:
org.apache.synapse/Threading/HttpClientWorkerorg.apache.synapse/Threading/HttpServerWorker
Attributes
Attribute Name | Description |
|---|---|
| Total worker threads related to this server/client. |
| Time-averaged unblocked worker thread percentage. |
| Time-averaged blocked worker thread percentage. |
| Blocked worker thread percentage averaged for last Xxx time period. |
| Number of deadlocked worker threads since last statistics reset. |
| The time the thread statistic recordings were last reset. |