Monitoring a Server

Tcat Server reached its End of Life in 2017. Contact your Customer Success Manager to determine options for managing, monitoring, or deploying your application.

This page describes how system administrators can use the MuleSoft Tcat Server to monitor the health of a server, see which applications are up and which are down, and determine memory usage. To view server details, click the server name on the Servers tab. The Server Details screen displays the information on several different tabs, which are described in the sections below.

At any time when viewing the server details, you can click Restart Server at the top of the window to restart that server. If you no longer want to monitor the server, click Unregister Server.

Viewing and Editing the Server Summary

The Summary tab provides an overview of the server, including its status (displays a green light if it’s running or a red light if it’s stopped), the groups it belongs to, the packages that have been deployed to it, and its environment variables (see below).

To edit the summary details, click Edit Server Info, make your changes, and then click Save. To add the server to a group, select it from the drop-down list and click Add. To remove the server from a group, click the red X next to the group name.

Working with Server Environment Variables

By default, just the variables that have been set for the server via Tcat Server are displayed on the server’s Summary tab. To display all environment variables on the server, click the more link. The full list of variables appears in a scrolling list below.

To manage the environment variables on the server, click Edit Server Info, and then do one or more of the following:

  • To add an environment variable, type the variable’s name and its value, and click Add. As you type, matching variable names appear, allowing you to select one from the list.

  • To change an existing variable, click its name or value box and edit as needed.

  • To delete a variable, click the red X next to its value.

When you finish making changes, click Save. To revert your changes, click Cancel.

If you change an environment variable, click Restart Server to restart the server and have your changes take effect.

If you make changes to your variables using Tcat Server, we recommend that you do not make further changes to the variables outside of Tcat Server. Otherwise, the variables get out of sync, because they are pulled into Tcat Server from the JVM when Tomcat starts and are combined with any that you have set in the Tcat Server console. Therefore, if you must make changes outside of Tcat Server, also restart Tomcat manually outside of Tcat Server. The variables then update in the JVM and are pulled into Tcat Server, and any that you set explicitly in the Tcat Server console take precedence over those set externally.

Working with Server Configuration Files

The Files tab displays the files and folders on the server. You can view and edit any text-based (non-binary) file, redeploy it, and then restart the server.

To view a file, simply click its name. If you want to edit the file, click Edit, make your changes in the editor that appears, and then click Save at the bottom of the window. If you make a mistake, you can click Reset to reset the editor window to the original text in the file. To cancel your changes without saving and close the editor window, click Cancel.

To add a new file to the server, do the following:

  1. In the Files tab, click New File.

  2. Enter the name you want to display for this file.

  3. Specify the file (you can click Browse to select it from your file system) and click Upload.

To upload a new version of a file, click its name to view it, click Upload New File, specify the updated version of the file, and click Upload.

To delete a file, click its name to view it, and then click Delete.

Viewing Deployed Applications

The Applications tab displays a list of the applications that have been deployed to this server. The Status column displays whether each application is currently running or stopped. You can stop or restart an application just by clicking its status to toggle it between running and down.

You can sort the list of applications by clicking any of the column headings. For example, you can click the Status column heading so that all stopped applications are grouped together at the top of the table.

To view more details about an application, click the application name.

Following is a description of the columns:

Column Description


The name of the application folder.


Whether the application is running or down (stopped).


The description of the application as specified in the WAR file.


The total number of requests processed by each application.


The total number of sessions for each application. A session is a connection between the application and a specific client, such as a user accessing the application through a web browser. Each session can process multiple requests. A session closes when the client terminates the session or when the session times out.


The total number of session attributes. Session attributes store information about the client.


The total number of ServletContext attributes set by this application. ServletContext attributes are shared by all servlets in the same application.

Sess. Timeout

The interval at which a session is automatically closed if there has been no activity within that time period.


Clicking the icon displays a list of all the JSPs in that application. You can click a specific JSP to view its code. You can also compile one or more JSPs.


Displays the maximum connection usage to JDBC resources by each application. You can click the bar in this column to see the JDBC resources for that application.


Whether the application is distributable and deployed in a cluster.


Whether all session attributes implement

Viewing the Log Files

The Logs tab displays the logs generated by Tomcat for each of the applications and for the Tomcat instance itself. Note that all logs are rolled over at midnight daily.

The table displays the log type, such as, JDK or Log4J, the file name, file size, last-modified timestamp, and the class used to create the log. Click a log file name to view its contents, or click the download icon to save the file locally. When viewing the log file contents, you can use the zoom buttons to make the font larger or smaller, you can adjust the line wrapping, and you can clear the log file. The log is updated as it is being written; to pause it, click Pause Tailing. To resume watching it in real time, click Resume Tailing. To return to the list of logs, click Back to log files list.

For details on the logs generated by Tcat Server, see Working with Logs.

Viewing Threads

The Threads tab allows you to view the threads that are running in the JVM. The information displayed depends on whether the server’s JVM has the JMX agent installed or is based on the thread class. The thread class view displays less-detailed information, so if you need more details, you should consider installing a JMX agent. To enable the JMX agent with Tomcat, add the option to your CATALINA_OPTS setting as described in Installation.

JVM Agent Information

Column Description


A unique identifier for this thread. This value is assigned by the JVM whenever the application creates a thread.


The thread name. This value is assigned by the application.


The point in the code where the thread was executed. The class name and line number are displayed if available.


The current state of the thread.


Whether this thread is executing in native code.


Whether this thread is suspended (that is, Thread.suspend() was called on the thread).


The waited count. This is the number of times the thread has been waiting.


The blocked count. This is the number of times the thread has been blocked from entering a monitor. Typically, this happens when the thread has to wait when trying to enter a synchronized() block.

Thread Class Information

Column Description


The thread name. This value is assigned by the application.


The priority of this thread. The higher the number, the higher its priority over other threads, and the more time it gets from the CPU.


The application to which this thread belongs.


The context class loader for this thread. Click the class to see the classpath the thread can access.


The thread group to which this thread belongs.


The class implementation that generated this thread.


The class that is executed by this thread.


Whether the thread is a daemon.


Whether the thread has been interrupted.

Viewing System Information

The System Information tab displays information about the computer on which Tcat Server is installed.

The memory utilization bar shows you at a glance how much memory is being used on the server. To release memory that’s being taken up by objects that are no longer in use by the applications, click Force Garbage Collection. This link runs System.gc(), which advises the JVM to perform the garbage collection. Alternatively, you can click "Advise GC" (also runs System.gc()) or "Advise Finalization" (which runs System.runFinalization() to suggest running finalization methods on objects) on the Memory Utilization page. These options should only be invoked in a development or test environment, because they can cause a short pause in application execution and can possibly make the JVM freeze.

To view more specific information about memory utilization, click Memory Utilization in the vertical menu bar on the right side of the screen. The screen now displays memory usage for different caches and spaces and allows you to display a chart for each.

The rest of this tab displays information about the operating system and Tomcat container installed on this server. To display more specific information about the operating system, including available RAM and historical usage charts, click OS Information in the vertical menu bar on the right side of the screen.

To view system properties, such as the Java home directory and Tomcat’s base and home directories (catalina.base and catalina.home), click System Properties in the vertical menu bar.

Lastly, if your JVM is controlled by a Java Service Wrapper, you can click Wrapper Control to view information about the wrapper, including its Java PID, whether debug is enabled, and the values of all its properties.

Viewing the Connectors

The Status tab allows you to view the status of the connectors used to connect client requests to the applications. The connectors are divided into groups based on the port and protocol they use. Each group displays information such as the total number of available and busy threads in that group. It also displays information for each individual connector, including the remote IP address, current stage, and the URL of the request.

The Connectors tab displays charts that show traffic volume information for all available connectors. The feed is live, and the charts are automatically updated every 30 seconds. You can toggle the visibility of a connector group by clicking that group’s header panel.

Was this article helpful?

💙 Thanks for your feedback!

Edit on GitHub