
# DBCP连接池监控
介绍APM采集的DBCP连接池监控指标的类别、名称、含义等信息。
表1DBCP连接池监控采集参数 
| 参数名                    | 数据类型    | 应用类型 | 默认值   | Agent支持的起始版本 | Agent支持的终止版本 | 描述                                |
|:---|:---|:---|:---|:---|:---|:---|
| 获取连接调用链上报时间阈值(ms)      | integer | JAVA | 1     | 2.1.3        | -            | getConnection方法调用链上报阈值，不超过该阈值不上报。 |
| getConnection时是否获取池内信息 | radio   | JAVA | false | 2.1.3        | -            | getConnection时是否获取池内信息。           |
   
表2DBCP连接池监控指标说明 
| 指标类别                          | 指标                            | 指标名称          | 指标说明                                                                                                              | 单位 | 数据类型   | 默认聚合方式 |
|:---|:---|:---|:---|:---|:---|:---|
| 数据源(dataSource，数据源。 )         | url                           | url           | url                                                                                                               | -  | ENUM   | LAST   |
| 数据源(dataSource，数据源。 )         | driverClassName               | 驱动            | 驱动                                                                                                                | -  | STRING | LAST   |
| 数据源(dataSource，数据源。 )         | initialSize                   | 初始化连接数        | 初始化连接数                                                                                                            | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | minIdle                       | 连接池最小空闲数      | 连接池最小空闲数                                                                                                          | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | maxIdle                       | 连接池最大空闲数      | 连接池最大空闲数                                                                                                          | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | maxTotal                      | 最大响应时间        | 最大响应时间                                                                                                            | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | numIdle                       | 空闲连接数         | 空闲连接数                                                                                                             | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | numActive                     | 活跃连接数         | 活跃连接数                                                                                                             | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | maxWaitMillis                 | 池等待连接被回收的最长时间 | 在抛出异常之前，池等待连接被回收的最长时间（当没有可用连接时）。                                                                                  | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | testOnCreate                  | 连接创建有效性校验     | 创建完连接后校验该连接是否有效                                                                                                   | -  | STRING | LAST   |
| 数据源(dataSource，数据源。 )         | testOnBorrow                  | 获取连接有效性校验     | 在连接池中取连接前校验连接是否有效                                                                                                 | -  | STRING | LAST   |
| 数据源(dataSource，数据源。 )         | testWhileIdle                 | 空闲连接有效性校验     | 当应用向连接池申请连接且该连接被判断为空闲连接时是否校验其有效性                                                                                  | -  | STRING | LAST   |
| 数据源(dataSource，数据源。 )         | timeBetweenEvictionRunsMillis | 验证连接是否有效的时间周期 | 如果testOnBorrow==false并且testWhileIdle==true,则在应用获取连接的时候会判断连接的空闲时间是否大于timeBetweenEvictionRunsMillis，如果大于则会验证该连接是否有效 | -  | INT    | LAST   |
| 数据源(dataSource，数据源。 )         | removeAbandonedOnBorrow       | 获取连接时是否移除废弃连接 | 获取连接时是否移除废弃连接（需满足条件getNumActive() \> getMaxTotal() - 3 and getNumIdle() \< 2）                                     | -  | STRING | LAST   |
| 数据源(dataSource，数据源。 )         | removeAbandonedOnMaintenance  | 维护阶段是否移除废弃连接  | maintenance cycle（eviction结束时）是否移除废弃连接                                                                            | -  | STRING | LAST   |
| 数据源(dataSource，数据源。 )         | removeAbandonedTimeout        | 废弃连接被移除的超时时间  | 连接在超过该时长未被使用，则视为废弃且可以被移除                                                                                          | -  | INT    | LAST   |
| 获取连接详情（connection，获取连接详情。）    | url                           | 连接地址          | 连接地址                                                                                                              | -  | ENUM   | LAST   |
| 获取连接详情（connection，获取连接详情。）    | invokeCount                   | 调用次数          | 调用次数                                                                                                              | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | totalTime                     | 总时间           | 总时间                                                                                                               | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | errorCount                    | 错误次数          | 错误次数                                                                                                              | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | maxTime                       | 最慢调用          | 最慢调用                                                                                                              | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | range1                        | 0-10ms        | 响应时间在0-10ms范围请求数                                                                                                  | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | range2                        | 10-100ms      | 响应时间在10-100ms范围请求数                                                                                                | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | range3                        | 100-500ms     | 响应时间在100-500ms范围请求数                                                                                               | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | range4                        | 500-1000ms    | 响应时间在500-1000ms范围请求数                                                                                              | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | range5                        | 1-10s         | 响应时间在1-10s范围请求数                                                                                                   | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | range6                        | 10s以上         | 响应时间在10s以上请求数                                                                                                     | -  | INT    | SUM    |
| 获取连接详情（connection，获取连接详情。）    | concurrentMax                 | 最大并发          | 最大并发                                                                                                              | -  | INT    | MAX    |
| 版本(version，版本。)               | version                       | 版本            | 版本                                                                                                                | -  | STRING | LAST   |
| 异常 (exception，DBCP调用的异常信息统计。) | exceptionType                 | 异常类型          | 异常类型                                                                                                              | -  | ENUM   | LAST   |
| 异常 (exception，DBCP调用的异常信息统计。) | causeType                     | 异常类           | 发生异常的类                                                                                                            | -  | ENUM   | LAST   |
| 异常 (exception，DBCP调用的异常信息统计。) | count                         | 次数            | 该异常的发生次数                                                                                                          | -  | INT    | SUM    |
| 异常 (exception，DBCP调用的异常信息统计。) | message                       | 异常消息          | 该异常产生的异常消息                                                                                                        | -  | STRING | LAST   |
| 异常 (exception，DBCP调用的异常信息统计。) | stackTrace                    | 异常堆栈          | 该异常产生的堆栈信息                                                                                                        | -  | CLOB   | LAST   |
   
