Pro plan from £5 per endpoint per month · see pricing
Secronyx
AvailableLinuxWindowsmacOS

Apache Tomcat

See whether Tomcat has run out of request threads, which requests hold them and for how long, and how full each JVM memory pool is, with a status-only manager login.

What it answers

Questions an on-call engineer asks, which an AI client can answer with this integration.

  • Are all of Tomcat's request threads busy, so that new requests queue or time out?
  • Which URIs and clients are holding Tomcat's threads, and for how long?
  • How many requests has each connector served, and how many failed?
  • Is the Tomcat JVM close to running out of heap or metaspace?
  • Does the monitoring login hold only the status role, and nothing that can deploy or stop applications?

What it returns

Each of the integration's read-only tools, described in words.

  • Tomcat JVM memory, one row per memory pool - heap and non-heap, bytes used, committed, maximum and initial
  • Tomcat connectors, one row each - busy, current and maximum request threads, requests and errors since start, total and longest processing time, and bytes received and sent
  • Tomcat request threads on every connector, one row each - stage (S service, P parse, F finishing, K keep-alive, R ready), time on the request, method, URI path without query, host, client and bytes

At a glance

Integration
tomcat 1.0.0
Publisher
levantar
Platforms
Linux, Windows, macOS

Tested on

  • Apache Tomcat 9.0.124 and 10.1.61 on Linux (Ubuntu 24.04, Docker), test lab
  • Apache Tomcat 10.1.61 on macOS 15 (Apache tarball, Intel), test lab; macOS (arm64), CI runner
  • Apache Tomcat 10.1.61 on Windows Server (Apache zip), CI runner

How it logs in

Without an explicit choice, configure tries the methods that need no secret first, in this order.

  • A user name and password

The least-privilege login

The setup file that comes with it. secronyx integration setup tomcat prints it; an administrator applies it by hand.

<!-- The least-privilege login for the tomcat integration: a user with role manager-status only. That role reaches the manager's status pages and nothing else: not the HTML manager (manager-gui), the text interface (manager-script), the JMX proxy (manager-jmx) or the host manager (admin-gui, admin-script), which can deploy, undeploy, stop and reload applications or change the server. The privilege check refuses a login that also holds any of those roles. 1. Add these lines inside <tomcat-users> in $CATALINA_BASE/conf/tomcat-users.xml (or your realm's equivalent), with a long random password. With a digest CredentialHandler, store the digest from bin/digest.sh -a sha-256 -h org.apache.catalina.realm.MessageDigestCredentialHandler PASSWORD 2. The manager app (webapps/manager) must be deployed. Its META-INF/context.xml allows only this host by default (RemoteAddrValve), which suits an agent on the same host. 3. Restart Tomcat, or reload the realm, so the user is read. --> <role rolename="manager-status"/> <user username="{{user}}" password="CHANGE-ME" roles="manager-status"/>

See it run

Terminal recording from the test lab: tomcat-linux-install
A real run on the shared test lab. It predates built-in integrations, so the commands on screen use their older names; this step is now secronyx integration configure tomcat.
Terminal recording from the test lab: tomcat-linux-setup
A real run on the shared test lab. It predates built-in integrations, so the commands on screen use their older names.
Terminal recording from the test lab: tomcat-linux-test
A real run on the shared test lab. It predates built-in integrations, so the commands on screen use their older names.

Read-only, in layers

Every request is a GET or HEAD to the endpoint the operator configured, on a path fixed in the signed pack. Redirects are not followed, and requests known to change state are refused.

These controls narrow what the integration can do; none of them is a guarantee on its own. An administrator can still accept a more powerful login on purpose (audited and shown in status), root or Administrator on the host can replace the agent, and the integration can read whatever its login can see.