深入Druid监控体系：全方位数据库性能监控实战-优快云博客

深入Druid监控体系：全方位数据库性能监控实战

【免费下载链接】druid 阿里云计算平台DataWorks(https://help.aliyun.com/document_detail/137663.html) 团队出品，为监控而生的数据库连接池项目地址: https://gitcode.com/gh_mirrors/druid/druid

本文全面介绍了阿里巴巴Druid数据库连接池的监控体系，涵盖了StatFilter监控统计功能、StatViewServlet内置监控页面、WebStatFilter Web请求监控以及Spring框架集成与AOP监控配置四个核心模块。通过详细的配置示例、工作原理分析和最佳实践建议，帮助开发者构建完整的数据库性能监控解决方案，提升系统性能和稳定性。

StatFilter监控统计功能的配置与使用

Druid的StatFilter是数据库连接池监控体系中的核心组件，它提供了全面的SQL执行统计、慢SQL检测、连接池状态监控等功能。通过StatFilter，开发者可以深入了解数据库操作的性能表现，及时发现和解决潜在的性能瓶颈。

StatFilter的核心功能特性

StatFilter提供了丰富的监控统计功能，主要包括：

功能类别	具体功能	说明
SQL执行统计	执行次数统计	记录每个SQL语句的执行次数
SQL执行统计	执行时间统计	统计SQL执行的总耗时和平均耗时
SQL执行统计	影响行数统计	记录UPDATE、DELETE等操作的影响行数
慢SQL检测	慢SQL阈值配置	可配置慢SQL的时间阈值
慢SQL检测	慢SQL日志记录	自动记录慢SQL到日志文件
连接池监控	连接建立时间	监控连接建立耗时
连接池监控	连接活跃数量	统计当前活跃连接数
性能分析	SQL合并功能	将相似SQL合并统计，减少统计项

StatFilter的配置方式

1. 基础配置示例

在Druid数据源中启用StatFilter非常简单，只需要在配置文件中添加filter配置：

@Bean
public DataSource druidDataSource() {
    DruidDataSource dataSource = new DruidDataSource();
    dataSource.setUrl("jdbc:mysql://localhost:3306/test");
    dataSource.setUsername("root");
    dataSource.setPassword("password");
    
    // 启用StatFilter监控
    dataSource.setFilters("stat");
    
    // StatFilter相关配置
    dataSource.setConnectionProperties("druid.stat.mergeSql=true;druid.stat.slowSqlMillis=5000");
    
    return dataSource;
}

2. 详细配置参数

StatFilter支持多种配置参数，可以通过Properties或系统属性进行设置：

# 慢SQL检测阈值（毫秒）
druid.stat.slowSqlMillis=3000

# 是否记录慢SQL
druid.stat.logSlowSql=true

# 慢SQL日志级别
druid.stat.slowSqlLogLevel=ERROR

# 是否启用SQL合并
druid.stat.mergeSql=true

# 连接堆栈跟踪（用于诊断连接泄漏）
druid.stat.connectionStackTraceEnable=true

3. Spring Boot配置方式

在Spring Boot应用中，可以通过application.yml进行配置：

spring:
  datasource:
    druid:
      filters: stat
      filter:
        stat:
          enabled: true
          log-slow-sql: true
          slow-sql-millis: 5000
          merge-sql: true

StatFilter的工作原理

StatFilter通过Druid的Filter机制拦截所有数据库操作，其工作流程如下：

mermaid

监控数据访问与使用

1. 通过JMX访问监控数据

StatFilter实现了MBean接口，可以通过JMX工具查看监控数据：

// 获取StatFilter MBean
MBeanServer mbeanServer = ManagementFactory.getPlatformMBeanServer();
ObjectName objectName = new ObjectName("com.alibaba.druid:type=StatFilter");

// 获取慢SQL阈值
Long slowSqlMillis = (Long) mbeanServer.getAttribute(objectName, "SlowSqlMillis");

// 获取SQL合并状态
Boolean mergeSql = (Boolean) mbeanServer.getAttribute(objectName, "MergeSql");

2. 编程方式获取统计信息

// 获取数据源统计信息
DruidDataSource dataSource = (DruidDataSource) applicationContext.getBean("druidDataSource");
JdbcDataSourceStat dataSourceStat = dataSource.getDataSourceStat();

// 获取连接统计
JdbcConnectionStat connectionStat = dataSourceStat.getConnectionStat();
System.out.println("活跃连接数: " + connectionStat.getActiveCount());
System.out.println("连接建立总数: " + connectionStat.getConnectCount());

// 获取SQL统计
Map<String, JdbcSqlStat> sqlStatMap = dataSourceStat.getSqlStatMap();
for (Map.Entry<String, JdbcSqlStat> entry : sqlStatMap.entrySet()) {
    JdbcSqlStat sqlStat = entry.getValue();
    System.out.println("SQL: " + entry.getKey());
    System.out.println("执行次数: " + sqlStat.getExecuteCount());
    System.out.println("总耗时: " + sqlStat.getExecuteMillisTotal() + "ms");
}

高级功能配置

1. 自定义慢SQL处理

public class CustomStatFilter extends StatFilter {
    @Override
    public void statementExecuteAfter(StatementProxy statement, String sql, 
                                    long nanoSpan, Throwable error) {
        super.statementExecuteAfter(statement, sql, nanoSpan, error);
        
        // 自定义慢SQL处理逻辑
        if (nanoSpan / 1000000 > getSlowSqlMillis()) {
            // 发送告警通知
            sendSlowSqlAlert(sql, nanoSpan);
            
            // 记录详细上下文信息
            logSlowSqlWithContext(statement, sql, nanoSpan);
        }
    }
    
    private void sendSlowSqlAlert(String sql, long nanoSpan) {
        // 实现告警逻辑
    }
    
    private void logSlowSqlWithContext(StatementProxy statement, String sql, long nanoSpan) {
        // 记录包含上下文的详细日志
    }
}

2. SQL执行统计可视化

通过StatFilter收集的数据可以生成丰富的统计报表：

mermaid

性能优化建议

合理设置慢SQL阈值：根据业务特点设置合适的慢SQL检测阈值，避免过多无关紧要的告警。
启用SQL合并功能：对于参数化查询，启用mergeSql可以减少统计项数量，提高监控效率。
定期清理统计数据：长时间运行的系统需要定期清理旧的统计信息，避免内存占用过多。
监控数据持久化：重要的监控数据应该持久化到数据库，便于历史查询和趋势分析。
结合其他监控工具：将Druid的监控数据与APM、日志系统等整合，构建完整的监控体系。

StatFilter作为Druid监控体系的核心组件，为数据库性能监控提供了强大的支持。通过合理的配置和使用，可以帮助开发者快速定位和解决数据库性能问题，提升系统整体性能。

内置监控页面StatViewServlet的部署与安全配置

Druid内置的StatViewServlet是数据库连接池监控的核心组件，它提供了一个功能强大的Web界面来实时监控数据库连接池的各项性能指标。正确部署和配置StatViewServlet对于保障生产环境的安全性和稳定性至关重要。

StatViewServlet基础部署

StatViewServlet的部署主要通过web.xml配置文件实现，以下是最基础的配置示例：

<servlet>
    <servlet-name>DruidStatView</servlet-name>
    <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>DruidStatView</servlet-name>
    <url-pattern>/druid/*</url-pattern>
</servlet-mapping>

部署完成后，通过访问 http://your-domain.com/druid/index.html 即可查看监控界面。监控页面提供了丰富的功能模块：

mermaid

安全认证配置

在生产环境中，必须为监控页面配置访问权限控制。Druid提供了灵活的安全认证机制：

<servlet>
    <servlet-name>DruidStatView</servlet-name>
    <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
    <init-param>
        <param-name>loginUsername</param-name>
        <param-value>admin</param-value>
    </init-param>
    <init-param>
        <param-name>loginPassword</param-name>
        <param-value>your_secure_password</param-value>
    </init-param>
</servlet>

配置参数说明：

参数名	类型	必填	默认值	描述
loginUsername	String	否	null	登录用户名
loginPassword	String	否	null	登录密码
resetEnable	Boolean	否	true	是否允许重置统计数据

IP访问控制

除了基本的用户名密码认证，Druid还支持基于IP地址的访问控制，提供更细粒度的安全策略：

<servlet>
    <servlet-name>DruidStatView</servlet-name>
    <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
    <init-param>
        <param-name>allow</param-name>
        <param-value>192.168.1.0/24,127.0.0.1</param-value>
    </init-param>
    <init-param>
        <param-name>deny</param-name>
        <param-value>192.168.2.1</param-value>
    </init-param>
</servlet>

IP控制规则处理流程：

mermaid

JMX远程监控配置

对于分布式环境，Druid支持通过JMX进行远程监控：

<servlet>
    <servlet-name>DruidStatView</servlet-name>
    <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
    <init-param>
        <param-name>jmxUrl</param-name>
        <param-value>service:jmx:rmi:///jndi/rmi://192.168.1.100:1099/jmxrmi</param-value>
    </init-param>
    <init-param>
        <param-name>jmxUsername</param-name>
        <param-value>jmxuser</param-value>
    </init-param>
    <init-param>
        <param-name>jmxPassword</param-name>
        <param-value>jmxpassword</param-value>
    </init-param>
</servlet>

Spring Boot集成配置

在Spring Boot应用中，可以通过配置类的方式集成StatViewServlet：

@Configuration
public class DruidConfig {

    @Bean
    public ServletRegistrationBean<StatViewServlet> statViewServlet() {
        ServletRegistrationBean<StatViewServlet> registration = 
            new ServletRegistrationBean<>(new StatViewServlet(), "/druid/*");
        
        Map<String, String> initParams = new HashMap<>();
        initParams.put("loginUsername", "admin");
        initParams.put("loginPassword", "password123");
        initParams.put("allow", "127.0.0.1");
        initParams.put("resetEnable", "false");
        
        registration.setInitParameters(initParams);
        return registration;
    }
}

安全最佳实践

强制认证：生产环境必须配置loginUsername和loginPassword
IP白名单：限制只允许内网或特定IP段访问监控页面
密码复杂度：使用强密码，避免使用默认密码
HTTPS加密：通过反向代理配置HTTPS访问
定期审计：监控访问日志，及时发现异常访问行为

常见问题处理

Session超时问题：默认Session超时时间为30分钟，可通过配置Web容器调整：

# Tomcat配置
server.servlet.session.timeout=60m

# 或者在web.xml中配置
<session-config>
    <session-timeout>60</session-timeout>
</session-config>

静态资源加载问题：确保Druid的静态资源文件正确打包到应用中，如果使用外部代理，需要配置正确的静态资源路径。

通过合理的部署和安全配置，StatViewServlet能够为企业级应用提供强大而安全的数据库连接池监控能力，帮助运维和开发团队实时掌握数据库性能状态，及时发现和解决潜在问题。

WebStatFilter实现Web请求监控

在现代Web应用中，数据库连接池的性能监控至关重要，而Druid的WebStatFilter提供了强大的Web请求监控能力，能够全面追踪和分析Web应用的请求处理情况。本节将深入探讨WebStatFilter的实现原理、配置方式以及在实际项目中的应用实践。

WebStatFilter核心架构

WebStatFilter是Druid监控体系中的关键组件，它作为一个Servlet Filter拦截所有Web请求，并收集详细的监控数据。其核心架构采用分层设计，确保监控数据的完整性和准确性。

mermaid

请求处理流程详解

WebStatFilter的请求处理流程采用精细化的时间测量和错误处理机制，确保监控数据的准确性：

mermaid

核心配置参数详解

WebStatFilter提供了丰富的配置选项，可以通过Filter的init参数进行灵活配置：

参数名称	类型	默认值	说明
`exclusions`	String	null	排除的URL模式，多个用逗号分隔
`sessionStatEnable`	boolean	false	是否启用Session统计
`sessionStatMaxCount`	int	1000	Session统计最大数量
`profileEnable`	boolean	false	是否启用性能分析
`principalSessionName`	String	null	用户Principal的Session名称
`principalCookieName`	String	null	用户Principal的Cookie名称
`realIpHeader`	String	null	真实IP地址的Header名称

实战配置示例

在实际项目中配置WebStatFilter非常简单，以下是一个完整的web.xml配置示例：

<filter>
    <filter-name>DruidWebStatFilter</filter-name>
    <filter-class>com.alibaba.druid.support.http.WebStatFilter</filter-class>
    <init-param>
        <param-name>exclusions</param-name>
        <param-value>*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*</param-value>
    </init-param

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考