如何調試/記錄Tomcat JDBC連接池的連接？

Question

我正在使用Tomcat JDBC連接池以及Spring啟動，JDBC模板和SQL Server。 當應用程序等待數據庫連接時，我需要知道連接池內部的內容。 如....

• 沒有活動連接
• 沒有空閑連接
• 沒有被阻止的連接，其他信息阻止此連接的原因
• 沒有可用的連接
• 和......

有沒有辦法通過調試或使用log4j等日志框架來獲取這些信息？

任何想法將不勝感激。

Answer 1

經過大量的研究，我能夠找到3種方法來記錄和監控數據庫連接池。

https://tomcat.apache.org/tomcat-8.0-doc/jdbc-pool.html

1. 使用Spring Boot 屬性進行監視。

2. 使用JMX （Java Management Extensions）進行監控（如@nitin建議的那樣）

3. 使用Spring Aspects進行監控。

第一種方式：使用Spring Boot屬性進行監控。

我發現下面的Spring引導屬性對於記錄和監視數據庫連接池非常有用。

這些屬性（以及更多屬性） 沒有記錄 。 有關詳細信息，請參閱下面的github問題。 https://github.com/spring-projects/spring-boot/issues/1829

#Maximum no.of active connections
spring.datasource.max-active=10

#Log the stack trace of abandoned connection
spring.datasource.log-abandoned=true

#Remove abandoned connection,So, new connection will be created and made available to threads which are waiting for DB connection
spring.datasource.remove-abandoned=true

#If any connection is not used for 10 seconds, consider that connection as "abandoned"
spring.datasource.remove-abandoned-timeout=10 

#Number of ms to wait before throwing an exception if no connection is available.
spring.datasource.max-wait=1000

此列表包含更多僅與數據源相關的屬性。（取自上面的鏈接）

spring.datasource.abandon-when-percentage-full
spring.datasource.access-to-underlying-connection-allowed
spring.datasource.alternate-username-allowed
spring.datasource.auto-commit
spring.datasource.catalog
spring.datasource.commit-on-return
spring.datasource.connection-customizer
spring.datasource.connection-customizer-class-name
spring.datasource.connection-init-sql
spring.datasource.connection-init-sqls
spring.datasource.connection-properties
spring.datasource.connection-test-query
spring.datasource.connection-timeout
spring.datasource.data-source
spring.datasource.data-source-class-name
spring.datasource.data-source-j-n-d-i
spring.datasource.data-source-properties
spring.datasource.db-properties
spring.datasource.default-auto-commit
spring.datasource.default-catalog
spring.datasource.default-read-only
spring.datasource.default-transaction-isolation
spring.datasource.driver-class-loader
spring.datasource.fair-queue
spring.datasource.idle-timeout
spring.datasource.ignore-exception-on-pre-load
spring.datasource.init-s-q-l
spring.datasource.initialization-fail-fast
spring.datasource.isolate-internal-queries
spring.datasource.jdbc-interceptors
spring.datasource.jdbc-url
spring.datasource.jdbc4-connection-test
spring.datasource.leak-detection-threshold
spring.datasource.log-abandoned
spring.datasource.log-validation-errors
spring.datasource.log-writer
spring.datasource.login-timeout
spring.datasource.max-age
spring.datasource.max-lifetime
spring.datasource.max-open-prepared-statements
spring.datasource.maximum-pool-size
spring.datasource.metrics-tracker-class-name
spring.datasource.minimum-idle
spring.datasource.num-tests-per-eviction-run
spring.datasource.pool-name
spring.datasource.pool-prepared-statements
spring.datasource.pool-properties
spring.datasource.propagate-interrupt-state
spring.datasource.read-only
spring.datasource.record-metrics
spring.datasource.register-mbeans
spring.datasource.remove-abandoned
spring.datasource.remove-abandoned-timeout
spring.datasource.rollback-on-return
spring.datasource.suspect-timeout
spring.datasource.test-on-connect
spring.datasource.thread-factory
spring.datasource.transaction-isolation
spring.datasource.use-disposable-connection-facade
spring.datasource.use-equals
spring.datasource.use-lock
spring.datasource.validation-interval
spring.datasource.validation-query-timeout
spring.datasource.validator
spring.datasource.validator-class-name
spring.datasource.xa
spring.datasource.xa.data-source-class-name
spring.datasource.xa.properties

第二種方式：使用JMX進行監控（Java Management Extensions）

Tomcat JDBC池提供了一個MBean，即ConnectionPoolMBean。

https://tomcat.apache.org/tomcat-7.0-doc/api/org/apache/tomcat/jdbc/pool/jmx/ConnectionPoolMBean.html

Spring Boot自動注冊JMX MBean。因此，無需將此MBean注冊/導出到MBean服務器。 只需打開JDK附帶的JConsole，打開，在Windows->命令提示符 - > jconsole，就是這樣。 有關詳情，請參閱下面的屏幕截

每當連接被放棄，連接失敗，查詢花費很長時間等時，此MBean也會通知 。請參閱下面的屏幕截圖。

第三種方式：使用Spring方面進行監控（僅適用於開發/ QA環境）。

我使用此方面來記錄TomcatJdbc連接池。

我創建了一個Spring Aspect，它將攔截每個數據庫調用。這肯定會影響性能 。

因此，在開發/ QA環境中使用此方面，在不需要時注釋掉此方法 （例如：在生產部署期間）。

@Before("execution(* com.test.app.db.dao.*.*(..))")
    public void logBeforeConnection(JoinPoint jp) throws Throwable {
        String methodName = "";
        methodName += jp.getTarget().getClass().getName();
        methodName += ":";
        methodName += jp.getSignature().getName();
        logger.info("before method call : " + methodName +  " : number of connections in use by the application (active) : "+ tomcatJdbcPoolDataSource.getNumActive());
        logger.info("before method call : " + methodName +  " : the number of established but idle connections : "+ tomcatJdbcPoolDataSource.getNumIdle());
        logger.info("before method call : " + methodName +  " : number of threads waiting for a connection : "+ tomcatJdbcPoolDataSource.getWaitCount());
    }


@After("execution(* com.test.app.db.dao.*.*(..)) ")
public void logAfterConnection(JoinPoint jp) throws Throwable {
    String methodName = "";
    methodName += jp.getTarget().getClass().getName();
    methodName += ":";
    methodName += jp.getSignature().getName();
    logger.info("after method call : " + methodName +  " : number of connections in use by the application (active) : "+ tomcatJdbcPoolDataSource.getNumActive());
    logger.info("after method call : " + methodName +  " : the number of established but idle connections : "+ tomcatJdbcPoolDataSource.getNumIdle());
    logger.info("after method call : " + methodName +  " : number of threads waiting for a connection : "+ tomcatJdbcPoolDataSource.getWaitCount());
    //tomcatJdbcPoolDataSource.checkAbandoned();
}

現在，您可以輕松識別在應用程序中創建連接泄漏的特定數據庫調用。

Answer 2

感謝@Sundararaj Govindasamy給出了很好的答案。 基於它，我在Spring Boot Application中創建了一個組件來調試我的數據庫池信息。

import org.apache.tomcat.jdbc.pool.DataSource;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.After;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class DataSourceAspectLogger {

    protected final Logger logger = LoggerFactory.getLogger(this.getClass());

    @Autowired
    private DataSource ds;

    @Before("execution(* br.com.foo.core.repository.*.*(..))")
    public void logBeforeConnection(JoinPoint jp) throws Throwable {
        logDataSourceInfos("Before", jp);
    }

    @After("execution(* br.com.foo.core.repository.*.*(..)) ")
    public void logAfterConnection(JoinPoint jp) throws Throwable {
        logDataSourceInfos("After", jp);
    }

    public void logDataSourceInfos(final String time, final JoinPoint jp) {
        final String method = String.format("%s:%s", jp.getTarget().getClass().getName(), jp.getSignature().getName());
        logger.info(String.format("%s %s: number of connections in use by the application (active): %d.", time, method, ds.getNumActive()));
        logger.info(String.format("%s %s: the number of established but idle connections: %d.", time, method, ds.getNumIdle()));
        logger.info(String.format("%s %s: number of threads waiting for a connection: %d.", time, method, ds.getWaitCount()));
    }
}

Answer 3

這是一個純JSP頁面MBean調試器，易於在沒有外部依賴性的每個Tomcat發行版中使用。 調用dumpMBean.jsp?name=ConnectionPool列出dbpool或將名稱留空以轉儲所有MBean。

<%@ page contentType="text/plain; charset=UTF-8" pageEncoding="ISO-8859-1"
  session="false"
  import="java.io.*, java.util.*, java.net.*,
  javax.management.*, java.lang.management.ManagementFactory
  "
%><%!

private void dumpMBean(MBeanServer server, ObjectName objName, MBeanInfo mbi, Writer writer) throws Exception {
    writer.write(String.format("MBeanClassName=%s%n", mbi.getClassName()));
    Map<String,String> props=new HashMap<String,String>();
    int idx=0;
    for(MBeanAttributeInfo mf : mbi.getAttributes()) {
        idx++;
        try {
            Object attr = server.getAttribute(objName, mf.getName());
            if (attr!=null)
                props.put(mf.getName(), attr.toString());
        } catch(Exception ex) {
            // sun.management.RuntimeImpl: java.lang.UnsupportedOperationException(Boot class path mechanism is not supported)
            props.put("error_"+idx, ex.getClass().getName()+" "+ex.getMessage());
        }
    }
    // sort by hashmap keys
    for(String sKey : new TreeSet<String>(props.keySet()))
        writer.write(String.format("%s=%s%n", sKey, props.get(sKey)));
}

%><%
// Dump MBean management properties, all beans or named beans
// dumpMBean.jsp?name=ConnectionPool,ContainerMBean
// dumpMBean.jsp?name=

if (request.getCharacterEncoding()==null)
    request.setCharacterEncoding("UTF-8");

String val = request.getParameter("name");
String[] names = val!=null ? val.trim().split(",") : new String[0];
if (names.length==1 && names[0].isEmpty()) names=new String[0];

MBeanServer server = ManagementFactory.getPlatformMBeanServer();
for(ObjectName objName : server.queryNames(null,null)) {
    MBeanInfo mbi = server.getMBeanInfo(objName);
    boolean match = names.length<1;
    String name = mbi.getClassName();
    for(int idx=0; idx<names.length; idx++) {
        if (name.endsWith(names[idx])) {
            match=true;
            break;
        }
    }
    if (match) {
        dumpMBean(server, objName, mbi, out);
        out.println("");
    }
}
out.flush();

%>