Monitoring Apache Tomcat

After you install the Instana host agent, the Apache Tomcat sensor is automatically installed and configured. You can view metrics that are related to Apache Tomcat in the Instana UI.

Supported versions

Instana supports metrics and configuration data for all versions of Apache Tomcat from 5.x to 10.x.

Optional configuration

Naming Tomcat

The Apache Tomcat sensor reads the Tomcat configuration file and extracts the name for the Tomcat instances from it. This name is displayed in the Intana UI.

Optionally, you can change the name of the Tomcat instance within Instana by editing the Tomcat configuration file

To edit the configuration file for renaming the Tomcat instance, complete the following steps:

  1. Go to the following file:
  2. To change the name of the Tomcat instance, modify the value of the field. See the following example: Tomcat/7.0.x

Metrics collection

The Apache Tomcat sensor monitors the Apache Tomcat instance and collects the following metrics from it:

To view these metrics, complete the following steps:

  1. Select Infrastructure in the sidebar of the Instana UI.
  2. Click a specific monitored host. You can see the host dashboard with all the collected metrics and monitored processes.

Configuration data

The Apache Tomcat sensor collects the following configuration data from the Apache Tomcat instance:

  • Version
  • Home
  • Web Apps
  • Application Configuration
  • Connectors
  • Servlets
  • Executors
  • Data sources

Performance metrics

The Apache Tomcat sensor collects the following performance metrics from the Apache Tomcat instance:

  • Sessions
    • Session count
    • Requests
    • Average Response Times
    • Errors
  • Connectors
    • Thread count
    • Busy threads
    • Max threads
    • Connection count
    • Max connections
  • Executors
    • Thread count
    • Queue size
    • Max threads
  • Data sources
    • Active connections
    • Max connections

Health Signatures

Each sensor has a curated knowledgebase of health signatures that are evaluated continuously against the incoming metrics. These health signatures are used to raise issues or incidents that depend on user impact.

Built-in events trigger issues or incidents based on failing health signatures on entities. Custom events trigger issues or incidents based on the thresholds of an individual metric of any entity.

For more information about built-events for the Apache Tomcat sensor, see Built-in events reference.


Instana provides tracing support for Apache Tomcat. For more information, see Monitoring Java Virtual Machine.