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. When you start JConsole, the MBeans tab will show the MBeans generated for your product. While some of these MBeans (ServerAdmin and DataSource) are common to all WSO2 products, some MBeans are specific to WSO2 DSS.
Go to the WSO2 administration guide for detailed instructions on how to configure JMX for a WSO2 product, how to use JConsole for monitoring a product and for descriptions of the common MBeans used by all WSO2 products.
Listed below are the MBeans that are specific to WSO2 DSS.
ServiceAdmin MBean
This MBean is used for administering services deployed in DSS. Its attributes are as follows:
| Attribute | Description |
|---|---|
| NumberOfActiveServices | The number of services which can currently serve requests. |
| NumberOfInactiveServices | The number of services which have been disabled by an administrator. |
NumberOfFaultyServices | The number of services which are faulty. |
The operations available in the ServiceAdmin MBean:
| Operation | Description |
|---|---|
| startService(p1:string) | The p1 parameter is the service name. You can activate a service using this operation. |
| stopService(p1:string) | The p1 parameter is the service name. You can deactivate/disable a service using this operation. |
Statistics MBean
This MBean is used for monitoring system and server statistics. Its attributes are as follows:
| Attributes | Description |
|---|---|
| AvgSystemResponseTime | The average response time for all the services deployed in the system. The beginning of the measurement is the time at which the server started. |
| MaxSystemResponseTime | The maximum response time for all the services deployed in the system. The beginning of the measurement is the time at which the server started. |
| MinSystemResponseTime | The minimum time for all the services deployed in the system. The beginning of the measurement is the time at which the server started. |
| SystemFaultCount | The total number of faults that occurred in the system since the server was started. |
| SystemRequestCount | The total number of requests that has been served by the system since the server was started. |
| SystemResponseCount | The total number of response that has been sent by the system since the server was started. |
Operations available in the Statistics MBean:
| Operation | Description |
|---|---|
| getServiceRequestCount(p1:string) | The p1 parameter is the service name. You can get the total number of requests received by this service since the time it was deployed, using this operation. |
| getServiceResponseCount(p1:string) | The p1 parameter is the service name. You can get the total number of responses sent by this service since the time it was deployed, using this operation. |
| getServiceFaultCount(p1:string) | The p1 parameter is the service name. You can get the total number of fault responses sent by this service since the time it was deployed, using this operation. |
| getMaxServiceResponseTime(p1:string) | The p1 parameter is the service name. You can get the maximum response time of this service since deployment. |
| getMinServiceResponseTime(p1:string) | The p1 parameter is the service name. You can get the minimum response time of this service since deployment. |
| getAvgServiceResponseTime(p1:string) | The p1 parameter is the service name. You can get the average response time of this service since deployment. |
| getOperationRequestCount(p1:string, p2:string) | The p1 parameter is the service name. The p2 parameter is the operation name. You can get the total number of requests received by this operation since the time its service was deployed, using this operation. |
| getOperationResponseCount(p1:string, p2:string) | The p1 parameter is the service name. The p2 parameter is the operation name. You can get the total number of responses sent by this operation since the time its service was deployed, using this operation. |
| getOperationFaultCount(p1:string, p2:string) | The p1 parameter is the service name. The p2 parameter is the operation name. You can get the total number of fault responses sent by this operation since the time its service was deployed, using this operation. |
| getMaxOperationResponseTime(p1:string, p2:string) | The p1 parameter is the service name. The p2 parameter is the operation name. You can get the maximum response time of this operation since deployment. |
| getMinOperationResponseTime(p1:string, p2:string) | The p1 parameter is the service name. The p2 parameter is the operation name. You can get the minimum response time of this operation since deployment. |
| getAvgOperationResponseTime(p1:string, p2:string) | The p1 parameter is the service name. The p2 parameter is the operation name. You can get the average response time of this operation since deployment. |
