Previous Topic  Next Topic

Monitoring the Server Performance

This topic describes how you can monitor the server performance in two ways: using Report Server Monitor or using an external method - JMX MBean API.

This topic contains the following sections:

• Monitoring the Server Performance on Server Monitor
• Monitoring the Server Performance Using JMX MBean API

Monitoring the Server Performance on Server Monitor

Server Monitor can show performance counters in graph (Line chart and Bar chart) and text mode.

To monitor the performance of Server on Server Monitor:

1. In the left panel of the Server Monitor home page, select any server node.
2. Select the Performance tab. Monitor displays the performance chart of the server.
3. If you want to configure the performance chart, select the Graph Options button on the toolbar. Monitor displays the Graph Options dialog box.
4. Type the number of tick marks you want to display on the X axis in the Keep Last N Records text box.
5. In the Y Axis Limit text box, type the maximum value on the left Y axis.
6. In the Y2 Axis Limit text box, type the maximum value on the right Y axis.
7. In the Interval text box, type the time interval in seconds the performance chart will use to get data and refresh itself.
8. Select OK to apply your changes.
9. Select the Clear Display button if you want to clear the current display of the performance counters in the performance chart.
10. To stop the current display of the performance counters, select the Stop button on the toolbar.

See the following information about the available counters:

Performance Counter	Description
Waiting Reports	The number of the currently waiting reports.
Running Reports	The number of the currently running reports.
Finished Reports	The number of the finished reports.
Finished Report Pages	The number of pages of the finished reports.
Average Submitted Tasks per User	The average number of tasks that each user has submitted since Server started.
Valid User Sessions	The number of valid user sessions.
Database Connections	The number of database connections.
Report Average Waiting Time	The average waiting time of each report.
Report Average Processing Time	The average processing time of each report.

Back to top

Monitoring the Server Performance Using JMX MBean API

1. Make your application environment consistent with the JMX specification.
2. In server.properties, set both properties server.rmiserver.enable and server.profiling.enable to true.
3. Run your code. See the following example:

   ObjectName profilingName = new ObjectName("jinfonet:name=profileCounter");
   ProfilingFactory ft = new ProfilingFactory("127.0.0.1",1129, "d:\\monitor");
   ProfilingCounter profilingCounter = new ProfilingCounter(ft);
   MBeanServer server = MBeanServerFactory.createMBeanServer();
   server.registerMBean(profilingCounter, profilingName);
   ProfileNotifyListener notifyListener = new ProfileNotifyListener();
   profilingCounter.addNotificationListener(notifyListener, null,null);
   // Create an RMI connector and start it 
   JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://localhost:9999/server");
   JMXConnectorServer cs = JMXConnectorServerFactory.newJMXConnectorServer(url, null, server);
   cs.start();

   In code part ProfilingFactory ft = new ProfilingFactory("127.0.0.1",1129, "d:\\monitor"), the parameters serverHost and serverRMIPort get server's ProfilingService remote object, and the parameter homepath is the path of the rmi.auth file for RMI authority checking public ProfilingFactory(String serverHost, int serverRMIPort, String homepath).

4. Check the monitoring result.

See the available counters that you can use in JMX MBean API:

Performance Counter	Counter Name	Counter Type	Description
Total Completed Tasks	TotalCompletedTasks	int	The total tasks that completed.
Number of Reports per Minute	NumberofReportsPerMinute	float	The number of the reports running per minute.
Total Number of Pages Exported	TotalNumberofPageExported	long	The total number of the exported report pages.
Exported Pages per Minute	ExportPagesPerMinute	float	The number of exported report pages per minute.
Successful Tasks	SuccessfulTasks	int	The tasks that have run successfully.
On-demand Tasks	OnDemandTasks	int	The tasks that have run on-demand.
Average Number of Pages	TaskAveragePages	float	The average number of report pages for each task.
Maximum Number of Pages	TaskMaximumPages	long	The maximum number of report pages for all tasks.
Average Running Time per Task	TaskAverageRunTime	float	The average running time of each task.
Maximum Running Time	TaskMaximumRunTime	float	The maximum running time of the tasks.
Average Waiting Time per Task	TaskAverageWaitTime	float	The average waiting time of each task.
Maximum Waiting Time	TaskMaxWaitTime	float	The maximum waiting time of the tasks.
Average Engine Time per Task	TaskAverageEngineTime	float	The average running time of each task on engine.
Maximum Engine Time	TimeTaskMaximumEngine	float	The maximum running time of all tasks on engine.
Average Concurrent Engines	AverageConcurrentEngines	float	The average number of concurrent engines for each task.
Maximum Concurrent	MaximumConcurrent	long	The maximum number of concurrent engines for all tasks.

In JMX MBean API, the data type of the profiling counters must be Decimal. See a figure of built-in data type hierarchy that you can refer for the return value:

Back to top

Previous Topic  Next Topic