DBCP Connection Pool Monitoring
This section describes the types, names, and meanings of DBCP connection pool metrics collected by APM.
Parameter | Data Type | Application Type | Default | Supported Start Agent Version | Supported End Agent Version | Description |
---|---|---|---|---|---|---|
Threshold (ms) for Reporting Connection Trace | integer | JAVA | 1 | 2.1.3 | - | Threshold for reporting getConnection method traces. If the threshold is not exceeded, such traces will not be reported. |
Obtain Pool Info or Not | radio | JAVA | false | 2.1.3 | - | Whether to obtain pool information when getting connections |
Category | Metric | Name | Description | Unit | Data Type | Default Aggregation Mode |
---|---|---|---|---|---|---|
Data source (dataSource) | url | url | url | - | ENUM | LAST |
driverClassName | Driver | Driver | - | STRING | LAST | |
initialSize | Initialized Connections | Number of initialized connections | - | INT | LAST | |
minIdle | Min. Idle Connections | Minimum number of idle connections in the pool | - | INT | LAST | |
maxIdle | Max. Idle Connections | Maximum number of idle connections in the pool | - | INT | LAST | |
maxTotal | Max. RT | Maximum response time | - | INT | LAST | |
numIdle | Idle Connections | Number of idle connections | - | INT | LAST | |
numActive | Active Connections | Number of active connections | - | INT | LAST | |
maxWaitMillis | Max. Time for Waiting Connection to Be Reclaimed | Maximum time for a waiting connection to be reclaimed (when no connection is available) before an exception is thrown | - | INT | LAST | |
testOnCreate | Validity Check Upon Connection Creation | Whether to check the validity of a connection after it is created | - | STRING | LAST | |
testOnBorrow | Validity Check Before Obtaining Connection | Check whether a connection is valid before obtaining it from the connection pool. | - | STRING | LAST | |
testWhileIdle | Idle Connection Validity Check | Whether to verify the validity of an idle connection when an application applies for it from the pool | - | STRING | LAST | |
timeBetweenEvictionRunsMillis | Interval for Checking Connection Validity | If testOnBorrow is set to false and testWhileIdle is set to true, the application checks whether the idle time of a connection is greater than timeBetweenEvictionRunsMillis before obtaining the connection. If it is greater than that value, the application checks whether the connection is valid. | - | INT | LAST | |
removeAbandonedOnBorrow | Remove Discarded Connections When Obtaining Connections | Whether to remove discarded connections when obtaining connections. (The following conditions must be met: "getNumActive() > getMaxTotal() – 3" and "getNumIdle() < 2") | - | STRING | LAST | |
removeAbandonedOnMaintenance | Remove Discarded Connections During Maintenance | Whether to remove discarded connections in the maintenance cycle (when the eviction ends) | - | STRING | LAST | |
removeAbandonedTimeout | Connection Removal Timeout | If a connection is not used within the specified timeout, it is regarded as a discarded connection and can be removed. | - | INT | LAST | |
Connection details (connection) | url | Connection Address | Connection address | - | ENUM | LAST |
invokeCount | Calls | Number of calls | - | INT | SUM | |
totalTime | Total Time | Total time | - | INT | SUM | |
errorCount | Errors | Number of errors | - | INT | SUM | |
maxTime | Max. RT | Maximum response time | - | INT | SUM | |
range1 | 0–10 ms | Number of requests with 0–10 ms response time | - | INT | SUM | |
range2 | 10–100 ms | Number of requests with 10–100 ms response time | - | INT | SUM | |
range3 | 100–500 ms | Number of requests with 100–500 ms response time | - | INT | SUM | |
range4 | 500–1000 ms | Number of requests with 500–1000 ms response time | - | INT | SUM | |
range5 | 1–10s | Number of requests with 1–10s response time | - | INT | SUM | |
range6 | > 10s | Number of requests with response time longer than 10s | - | INT | SUM | |
concurrentMax | Max. Concurrency | Maximum concurrency | - | INT | MAX | |
Version (version) | version | Version | Version | - | STRING | LAST |
Exception (exception: exception statistics of DBCP calls) | exceptionType | Exception Type | Exception type | - | ENUM | LAST |
causeType | Exception Class | Exception class | - | ENUM | LAST | |
count | Count | Number of times the exception has occurred | - | INT | SUM | |
message | Exception Message | Message returned when the exception occurred | - | STRING | LAST | |
stackTrace | Exception Stack | Exception stack information | - | CLOB | LAST |