In order to monitor a Tomcat server, the JMX Remote Agent must be enabled. If you are not sure how to enable this, consult the "Monitoring and Management" section of the Tomcat documentation.
In addition, SOASTA CloudTest must be able to establish a TCP/IP connection to the JMX Remote Agent port on the server.
If a firewall prevents TCP/IP access, see the topic Monitoring a Server Behind a Firewall.
SOASTA CloudTest can currently monitor Apache Tomcat 5.5, 6.0, and 7.0.
- In the Central list, select Monitoring Server Groups.
- Click the New Monitoring Server Group icon.
The Monitoring Server / Monitor wizard appears.
- Select Monitoring Server Group and click Next.
- Enter a name and description for the Monitor Server Group.
- Check App Servers and then click Next.
- The Hosts/Device Agents screen appears. Add one or more servers where a Tomcat server resides using hostname or IP Address.
- Select Tomcat, then enter the JMX port number, the user name, and password. The user name and password are not always required. Check with your network administrator. Note that Tomcat does not have a default port. It is chosen when you set up the JMX Remote Agent.
- Click the Test Connection button to test the connection. If the connection is successful, the connection success is indicated in green text. If the connection fails, you will see an error message in red text.
- Click Next and review the Monitor Server setup.
- Check the "Create a new Monitor for this Monitor Server" box and click Finish.
- Enter a name for the Monitor and an optional description, then click Next.
Now, choose which statistics to monitor. For each statistic, you can choose a "sample rate" that determines how often that statistic will be collected.
- In addition to the standard statistics that are offered (for example, "JVM Heap Size"), you can track the value of any JMX MBean attribute. For example, to track the current number of sessions in the web application
/mywebapp, check the "JMX Attribute" box, and in the "Arguments" column enter:
You can use the "Add Custom Object" button to add as many JMX MBean attributes as you like. Some more examples:
- To track the total amount of time spent processing HTTP requests since Tomcat started, in the "Arguments" column enter:
- To track the current number of threads in the HTTP thread pool, in the "Arguments" column enter:
When you are finished, click Next.
- Review the information to be sure it is correct, then click Finish.
- To start or stop monitoring, see the topic "Starting and Stopping a Monitor".
- To automatically monitor the Tomcat server every time a certain test starts, see the topic "Starting a Monitor Automatically When a Test Composition Runs"
- You can also combine system, database, and ColdFusion statistics in the same monitor.