17 Apache Tomcat Metrics

Oracle Enterprise Manager can be used to manage Apache Tomcat. You can use the All Metrics page for an Apache Tomcat target to view the metrics that are being monitored for that target by Oracle Management Agent.

The Apache Tomcat metrics provide for each metric the following information:

  • Description

  • Metric summary— The metric summary can include some or all of the following: target version, evaluation frequency, collection frequency, upload frequency, operator, default warning threshold, default critical threshold, consecutive number of occurrences preceding notification, and alert text.

  • Multiple Thresholds (where applicable).

To download and monitor the Apache Tomcat plug-in, see Enterprise Manager System Monitoring Plug-in Installation Guide for Apache Tomcat.

17.1 All Applications

This metric category contains aggregated performance metrics spanning all the applications deloyed to the Apache Tomcat container.

17.1.1 All Applications - Rejected Sessions

This metric shows the number of sessions rejected by all the applications running on the Apache Tomcat container since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.1.2 All Applications - Sessions Created

This metric shows the number of sessions created by all the applications running on the Apache Tomcat container since the last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.1.3 All Applications - Total Active Sessions

This metric shows the number of active sessions of all the applications running on the Apache Tomcat container.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.2 All Applications JSP Monitor Metrics

This metric category contains aggregated performance metrics spanning all the JavaServer Pages (JSPs) deployed to the Apache Tomcat container.

17.2.1 All Applications - JSP Access

This metric shows the number of times JSPs were accessed on all the applications since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.2.2 All Applications - JSP Reload

This metric shows the number of times JSPs were reloaded on all the applications since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.3 All Global Request Processors Metrics

This metric category contains aggregated performance metrics spanning all the Global Request Processors deployed to the Apache Tomcat container.

17.3.1 All Global Request Processors - Total Bytes Received

This metric shows the bytes received by all the request processors running on the Apache Tomcat container since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.3.2 All Global Request Processors - Total Errors

This metric shows the error count on all the request processors running on the Apache Tomcat container since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.3.3 All Global Request Processors - Total Requests

This metric shows the request count on all the request processors running on the Apache Tomcat container since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.3.4 All Global Request Processors -Total Bytes Sent

This metric shows the bytes sent by all the request processors running on the Apache Tomcat container since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.4 Application Cache Metrics

This metric category contains the usage details of the application cache of the Apache Tomcat container.

17.4.1 Cache Access Count

This metric shows the number of times the cache was accessed since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.4.2 Cache Hit Count

This metric shows the number of times the cache was hit since last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.5 Applications Metrics

This metric category contains the metrics for each application deployed to the container.

17.5.1 Application Name

This metric shows the deployed application names.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.5.2  Active Sessions

This metric shows the number of Active Sessions.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.5.3 Processing Time (sec)

This metric shows the average time taken (in seconds) for processing a request.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.5.4 Rejected Sessions (per min)

This metric shows the number of sessions rejected by all applications per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.5.5 Sessions Created (per min)

This metric shows the number of sessions created by all applications per minute .

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.5.6 Requests Processed (per min)

This metric shows the number of requests processed per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.6 DataSource Metrics

This metric category contains the attributes of all the data sources configured for the Apache Tomcat container.

17.6.1 Active Datasource Connections

This metric shows the number of active connections to the data source.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.6.2 Idle Datasource Connections

This metric shows the number of idle connections to the data source.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.7 Global Request Processor Metrics

This metric category contains the attributes of each Global Request Processor configured on the Apache Tomcat container.

17.7.1 Average Request Processing Time (sec)

This metric shows the average time taken (in seconds) for processing a request by the global request processor.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.7.2 Bytes received (per min)

This metric shows the number of bytes received by each request processor per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.7.3 Bytes Sent (per min)

This metric shows the number of bytes sent by each request processor per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.7.4 Errors (per min)

This metric shows the error count of each request processor per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.7.5  Requests (per min)

This metric shows the number of requests served by each request processor per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

17.8 JSP Monitor Metrics

This metric category contains the usage details of JSPs.

17.8.1 JSP Access (per min)

This metric shows the number of times JSPs were accessed since during the last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.8.2 JSP Reload (per min)

This metric shows the number of times JSPs were reloaded since the last collection.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.9 JVM

This metric category provides information about Java Virtual Machine (JVM) usage.

17.9.1 Server CPU Usage (%)

This metric shows the server CPU percentage usage during the last collection interval.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.10 JVM Garbage Collector

This metric category provides information about JVM Garbage Collectors.

17.10.1 Garbage Collector - Duration of last Garbage Collection (ms)

This metric indicates the number of milliseconds that the JVM pent on the last garbage collection ended during the last collection interval.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

17.10.2 Garbage Collector - Invocation Time (ms)

This metric indicates the number of milliseconds that the JVM has spent on all garbage collection runs during last collection interval.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.10.3 Garbage Collector - Invocation Rate (per min)

This metric indicates the rate at which the garbage collections happened during the last collection interval.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.10.4 Garbage Collector - Percentage Time spent (elapsed)

This metric indicates the percentage of time that the JVM has spent on all garbage collections during last collection interval.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.11 JVM Heap Memory Pool after GC

This metric category provides information about the JVM Heap Memory Pool memory usage metrics after garbage collection.

17.11.1 Memory usage after GC (MB)

This metric displays the amount of memory used by the memory pool after the garbage collection (MB).

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.11.2 Percentage Memory usage after GC (%)

This metric displays the percentage memory usage of the memory pool after garbage collection (%).

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.12 JVM Memory Pools

This metric provides information about the metrics for memory usage in the JVM memory pools.

17.12.1 Memory Pool - Type

This metric displays the type of the JVM memory pool.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.12.2 Memory Pool - Current Usage (MB)

This metric displays the amount of memory currently used in the JVM memory pool.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.12.3 Memory Pool - Percentage Usage (%)

This metric displays the current memory usage percentage with respect to the maximum memory available in the memory pool (%).

Target Version Collection Frequency
Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.12.4 Memory Pool - Peak Usage (MB)

This metric displays the peak memory usage by the Memory Pool since the JVM started.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.13 JVM Threads

This metric category provides information about the JVM Threads metrics.

17.13.1 JVM Threads - Active Threads

This metric displays the number of active threads running in the JVM.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.13.2 JVM Threads - Peak Threads

This metric displays the maximum number of active threads running at any time in the JVM.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.13.3 JVM Threads - Active Daemon Threads

This metric displays the number of Daemon threads running in the JVM.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.13.4 JVM Threads - Threads created (per min)

This metric displays the number of JVM Threads started during the last collection interval (per minute).

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 15 minutes

Apache Tomcat 8.x

Every 15 minutes

17.14 Memory Usage

This metric category provides information about memory usage metrics.

17.14.1 JVM Heap Memory Usage (MB)

This metric displays the amount of memory (in MB) used in the heap.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.14.2 JVM Total Heap Memory Usage (MB)

This metric displays the maximum amount (in MB) of heap memory available for the JVM.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.14.3 JVM Non-Heap Memory Usage (MB)

This metric displays the amount of memory (in MB) being used in the non-heap.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.14.4 JVM Total Non-Heap Memory Usage (MB)

This metric displays the maximum amount of non-heap memory (in MB) available for the JVM.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.14.5 JVM Heap Memory Usage (%)

This metric displays the current heap memory percentage with respect to the maximum heap memory available.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.14.6 JVM Non-Heap Memory Usage (%)

This metric displays the current non-heap memory percentage with respect to the maximum non-heap memory available.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.14.7 JVM Objects Pending Finalization

This metric displays the number of objects waiting to be finalized in the memory.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.15 Response Metrics

This metric category shows the status of the Apache Tomcat container.

17.15.1 Status

This metric shows the status of the Apache Tomcat container - whether up or down.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.16 Session Manager Metrics

This metric category contains the statistics of the sessions managed by the Apache Tomcat container.

17.16.1 Rejected Sessions (per min)

This metric shows the active number of of sessions rejected per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Real-time only

17.16.2 Sessions Created (per min)

This metric shows the number of sessions created per minute.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Real-time only

17.16.3 Active Sessions

This metric shows the number of number of sessions of each application. .

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Real-time only

17.17 Thread Pools Metrics

This metric category contains statistics on various thread pools used by the Apache Tomcat container.

17.17.1 Busy Threads

This metric shows the number of busy threads on the Apache Tomcat container.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes

17.17.2 Threads

This metric shows the number of threads created on the Apache Tomcat container.

Target Version Collection Frequency

Apache Tomcat 7.x and earlier

Every 5 minutes

Apache Tomcat 8.x

Every 5 minutes