Extend the platform,
empower your team.
Application method of pooling and sharing multiple connections to a database.
ExtensionSeveral built-in OneAgent extensions provide insight into connection pool performance and issues such as connection leaks. The extensions cover the following technologies: Apache Tomcat, Oracle WebLogic, IBM WebSphere Application Server, IBM WebSphere Liberty, Red Hat JBoss and Apache Commons.
This extension collects connection pool performance, usage and availability metrics for Apache Commons
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.
Metric name | Metric key | Description | Unit |
---|---|---|---|
Borrowed count | apache.commons.connectionPool.borrowedCount.count | Gets the total number of objects successfully borrowed from the pool | Count |
Created count | apache.commons.connectionPool.createdCount.count | Gets the total number of objects created for this pool | Count |
Destroyed count | apache.commons.connectionPool.destroyedCount.count | Gets the total number of objects destroyed by this pool | Count |
Max total | apache.commons.connectionPool.maxTotal | Gets the maximum number of objects that can be allocated by the pool (checked out to clients, or idle awaiting checkout) at a given time. When negative, there is no limit to the number of objects that can be managed by the pool at one time | Count |
Idle count | apache.commons.connectionPool.numIdle | Gets the number of instances currently idle in this pool | Count |
Active count | apache.commons.connectionPool.numActive | Gets the number of instances currently borrowed from this pool. Returns a negative value if this information is not available | Count |
Waiters count | apache.commons.connectionPool.numWaiters | Gets an estimate of the number of threads currently blocked waiting for an object from the pool | Count |
Returned count | apache.commons.connectionPool.returnedCount.count | Gets the total number of objects returned to this pool over the lifetime of the pool. This excludes attempts to return the same object multiple times | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Max borrow wait duration | apache.commons.connectionPool.maxBorrowWaitDuration | Gets the maximum time a thread has waited to borrow objects from the pool | MilliSecond |
Max wait duration | apache.commons.connectionPool.maxWaitDuration | Gets the maximum duration the borrowObject() method should block before throwing an exception when the pool is exhausted and getBlockWhenExhausted() is true. When less than 0, the borrowObject() method may block indefinitely | MilliSecond |
Mean active duration | apache.commons.connectionPool.meanActiveDuration | Gets the mean time objects are active for based on the last MEAN_TIMING_STATS_CACHE_SIZE objects returned to the pool | MilliSecond |
Mean borrowed wait duration | apache.commons.connectionPool.meanBorrowWaitDuration | Gets the mean time threads wait to borrow an object based on the last MEAN_TIMING_STATS_CACHE_SIZE objects borrowed from the pool | MilliSecond |
Mean idle duration | apache.commons.connectionPool.meanIdleDuration | Gets the mean time objects are idle for based on the last MEAN_TIMING_STATS_CACHE_SIZE objects borrowed from the pool | MilliSecond |
Min evictable idle duration | apache.commons.connectionPool.minEvictableIdleDuration | Gets the minimum amount of time an object may sit idle in the pool before it is eligible for eviction by the idle object evictor. When non-positive, no objects will be evicted from the pool due to idle time alone. | MilliSecond |
First release of the JMX-based extension for monitoring Apache Commons connection pool: