Skip to technology filters Skip to main content
Dynatrace Hub

Extend the platform,
empower your team.

Popular searches:
Home hero bg
Tomcat (JMX)Tomcat (JMX)
Tomcat (JMX)

Tomcat (JMX)

JMX monitoring of Tomcat connection and thread pools, and web request activity.

Extension
Free trial
A connection pool entity screen.Data for thread pools and web request activity available in the process group instance Unified Analysis screen.
  • Product information
  • Release notes

Overview

Apache Tomcat is an open-source web server developed by the Apache Software Foundation (ASF) and one of the most popular servlet containers available today. It’s an incredibly lightweight, flexible and extremely stable platform to build on. The OneAgent will allow you to trace activity on and through your Tomcat applications. Using this JMX extension you'll be able to collect additional key performance data to identify issues and optimize your Tomcat configurations.

Use cases

  • Identify issues with connection pool utilization and activity that could impact your web applications
  • Optimize your thread and connection pool configurations to increase efficiency while not impacting your application clients
  • Monitor your web application by viewing web request activity and performance data from Tomcat's perspective in context with other key metrics

Get started

This extension collects connection pool, thread pool, and web request activity and performance for Tomcat.

Prerequisites:

  • Tomcat process that runs on a supported Linux or Windows operating system.
  • OneAgent version 1.273+
  • Dynatrace version 1.273+

To get metric insight:

  1. Install OneAgent on the virtual machine or server of your Tomcat process.
  2. Activate the OneAgent feature Java Metric Extensions 2.0 (JMX).
    • When enabling for the first time each process will need to be restarted for this feature to become active
  3. Select in this same tile Add to environment to configure the extension

Details

Metrics are organized into feature sets you can enable/disable as desired.

Additionally, there is one calculated metric included:

  • Average request processing time (func:tomcat.processingTimePerRequest): Request processing time divided by request count

Compatibility information

The following Mbeans are used for collecting data. If you not seeing metrics check that the following Mbeans exist using the tool of your choice (e.g. JConsole).

  • Connection pools:
    • Catalina:type=DataSource,name=*,class=*,context=*,host=* or Catalina:type=DataSource,name=*,class=*
  • Thread pools:
    • Catalina:type=ThreadPool,name=*
  • Web request activity
    • Catalina:type=GlobalRequestProcessor,name=*

For connection pools specifically, this extension only supports the standard Tomcat connection pooling implementation with Mbeans under the Catalina domain. It is not uncommon for a different pooling implementation to be used and in these cases you may need to create your own custom JMX extension to collect similar data (if it is available via JMX). You should consult your implementation's documentation or review available Mbeans in your Tomcat process to get started with this.

Licensing

There is no charge for obtaining the extension, only for the data that the extension ingests. The details of license consumption will depend on which licensing model you are using. This will either be Dynatrace classic licensing or the Dynatrace Platform Subscription (DPS) model.

Metrics

License consumption is based on the number of metric data points ingested. The following formula will provide approximate annual data points ingested assuming all feature sets are enabled.

((16 * <number_of_connection_pools) + (5 * <number_of_web_apps>) + (3 * <number_of_thread_pools>)) * 60 minutes * 24 hours * 365 days data points per year

Classic licensing

In the classic licensing model, metric ingestion will consume Davis Data Units (DDUs) at the rate of .001 DDUs per metric data point.

Multiply the above formula for annual data points by .001 to estimate annual DDU usage.

Dynatrace
More Information
By Dynatrace
Dynatrace support center
Subscribe to new releases
Copy to clipboard

Extension content

Content typeNumber of items included
screen injections
3
screen metric tables
3
screen properties
1
screen chart groups
2
generic relationship
1
metric metadata
32
dashboards
1
metric query
8
screen layout
1
list screen layout
1
generic type
1
screen entities lists
1

Feature sets

Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual feature sets can be activated and deactivated by your administrator during configuration.

Feature setsNumber of metrics included
Metric nameMetric keyDescriptionUnit
Active connectionstomcat.connectionPool.activeConnectionsCurrently used connectionsCount
Created connectionstomcat.connectionPool.createdConnectionsNumber of connections createdCount
Idle connectionstomcat.connectionPool.idleConnectionsNumber of open but unused connectionsCount
Waiting connectionstomcat.connectionPool.numWaitersCurrently waiting connectionsCount
Abandoned connectionstomcat.connectionPool.removeAbandonedNumber of connections that have not been properly releasedCount
Abandoned connection timeouttomcat.connectionPool.removeAbandonedTimeoutTimeout before an abandoned connection can be removedSecond
Waiting connection requeststomcat.connectionPool.waitCountNumber of connection requests currently waitingCount
Metric nameMetric keyDescriptionUnit
Bytes recievedtomcat.bytesReceived.countBytes recievedByte
Bytes senttomcat.bytesSent.countBytes sentByte
Request counttomcat.requestCount.countRequest countCount
Error counttomcat.errorCount.countError countCount
Request processing timetomcat.processingTime.countRequest processing timeMilliSecond
Metric nameMetric keyDescriptionUnit
Borrowed connectionstomcat.connectionPool.borrowedConnections-Count
Reconnected connectionstomcat.connectionPool.reconnectedConnections-Count
Released connectionstomcat.connectionPool.releasedConnections-Count
Returned connectionstomcat.connectionPool.returnedConnections-Count
Metric nameMetric keyDescriptionUnit
Max total connectionstomcat.connectionPool.maxTotalMaximum total amount of connectionsCount
Max active connectionstomcat.connectionPool.maxActiveMaximum amount of active connections allowed concurrentlyCount
Max idle connectionstomcat.connectionPool.maxIdleThe maximum number of connections that should be kept in the pool at all timesCount
Max wait timetomcat.connectionPool.maxWaitThe maximum number of milliseconds that the pool will wait (when there are no available connections) for a connection to be returned before throwing an exceptionMillisecond
Minimum idletomcat.connectionPool.minIdleThe minimum number of established connections that should be kept in the pool at all timesCount
Metric nameMetric keyDescriptionUnit
Current thread counttomcat.threadPool.currentThreadCountCurrent thread countCount
Current threads busytomcat.threadPool.currentThreadsBusyCurrent threads busyCount
Max threads allowedtomcat.threadPool.maxThreadsMax threads allowedCount

Full version history

To have more information on how to install the downloaded package, please follow the instructions on this page.
ReleaseDate

Full version history

Update that makes this a more general Tomcat extension

  • Includes feature sets and changes for App Server metrics
    • Thread pools
    • Web requests

Full version history

  • Added metrics:
    • tomcat.connectionPool.numWaiters
    • tomcat.connectionPool.maxTotal
    • func:tomcat.connectionPool.currentUsage
  • Added new charts in UA screens for these metrics

Full version history

  • Fix a bug which prevented the extension from being imported in some environments.

Full version history

  • Includes support for 'global' data source resources (i.e. Mbeans with no 'host' or 'context' attribute)

Full version history

Solved a bug where the name dimension was not being ingested correctly, which prevented custom topology entities from being created.

Full version history

EF1 to EF2 Tomcat Connection Pool conversion:

  • Add Tomcat connection pool entity and its relation to the tomcat process
  • Custom unified analysis screen for Tomcat connection pools
  • Metric chart injection into Process Group Instance screen
  • Overview dashboard for Tomcat connection pools
  • Add feature sets to control included metrics
  • New metric func:tomcat.connectionPool.availableConnections that shows the current available connections
  • All metrics have changed key from the EF1 version. The prefix builtin:tech.tomcat has been removed. This is a breaking change for any configuration you had which used the metric key, such as metric events.
Dynatrace Hub
Get data into DynatraceBuild your own app
All (773)Log Management and AnalyticsKubernetesAI and LLM ObservabilityInfrastructure ObservabilitySoftware DeliveryApplication ObservabilityApplication SecurityDigital ExperienceBusiness Analytics
Filter
Type
Built and maintained by
Deployment model
SaaS
  • SaaS
  • Managed
Partner FinderBecome a partnerDynatrace Developer

Discover recent additions to Dynatrace

Problems logo

Problems

Analyze abnormal system behavior and performance problems detected by Davis AI.

Logs logo

Logs

Explore all your logs without writing a single query.

Security Investigator logo

Security Investigator

Fast and precise forensics for security and logs on Grail data with DQL queries.

Business Flow logo

Business Flow

Track, analyze, and optimize your critical business processes.

Cost & Carbon Optimization logo

Cost & Carbon Optimization

Track, analyze, and optimize your IT carbon footprint and public cloud costs.

Davis Anomaly Detection logo

Davis Anomaly Detection

Detect anomalies in timeseries using the Davis AI

Analyze your data

Understand your data better with deep insights and clear visualizations.

Notebooks logo

Notebooks

Create powerful, data-driven documents for custom analytics and collaboration.

Dashboards logo

Dashboards

Transform complex data into clear visualizations with custom dashboards.

Automate your processes

Turn data and answers into actions, securely, and at scale.

Workflows logo

Workflows

Automate tasks in your IT landscape, remediate problems, and visualize processes

Jira logo

Jira

Create, query, comment, transition, and resolve Jira tickets within workflows.

Slack logo

Slack

Automate Slack messaging for security incidents, attacks, remediation, and more.

Secure your cloud application

See vulnerabilities and attacks in your environment.

Security Overview logo

Security Overview

Get a comprehensive overview of the security of your applications.

Code-Level Vulnerabilities logo

Code-Level Vulnerabilities

Detect vulnerabilities in your code in real time.

Threats & Exploits logo

Threats & Exploits

Understand, triage, and investigate application security findings and alerts.

Are you looking for something different?

We have hundreds of apps, extensions, and other technologies to customize your environment

Leverage our newest innovations of Dynatrace Saas

Kick-start your app creation

Kick-start your app creation

Whether you’re a beginner or a pro, Dynatrace Developer has the tools and support you need to create incredible apps with minimal effort.
Go to Dynatrace Developer
Upgrading from Dynatrace Managed to SaaS

Upgrading from Dynatrace Managed to SaaS

Drive innovation, speed, and agility in your organization by seamlessly and securely upgrading.
Learn More
Log Management and Analytics

Log Management and Analytics

Innovate faster and more efficiently with unified log management and log analytics for actionable insights and automation.
Learn more