Fusio项目日志表性能优化实践

背景介绍

Fusio作为一个API管理平台，其日志表(fusio_log)记录了系统运行过程中的各种请求信息。随着业务量的增长，日志表数据量快速积累(案例中达到25万条记录)，导致系统性能出现明显下降，特别是在处理健康检查请求时响应时间达到100毫秒以上。

问题分析

通过MariaDB的慢查询日志分析，发现性能瓶颈主要来自于速率限制功能对日志表的查询操作。具体表现为COUNT(*)聚合查询在没有合适索引的情况下，需要对大量数据进行全表扫描。

优化方案

针对日志表查询模式，我们设计了两个复合索引：

1. 租户ID+IP+日期索引：优化基于租户和IP地址的速率限制查询
2. 租户ID+用户ID+日期索引：优化基于租户和用户ID的速率限制查询

索引创建语句如下：

ALTER TABLE fusio_log ADD INDEX IDX_LOG_TID-IP-DATE (tenant_id, ip, date);
ALTER TABLE fusio_log ADD INDEX IDX_LOG_TID-UID-DATE (tenant_id, user_id, date);

优化效果

优化前后性能对比显著：

优化前：

• 平均响应时间：约100毫秒
• 最高达到130毫秒

优化后：

• 平均响应时间：约10毫秒
• 性能提升近10倍

技术原理

复合索引的设计考虑了查询中最常用的过滤条件组合。通过将高频查询条件(tenant_id)放在索引最左侧，配合次级条件(ip或user_id)和日期范围查询(date)，数据库引擎可以高效定位目标数据，避免全表扫描。

最佳实践建议

1. 定期监控：对生产环境中的慢查询进行持续监控
2. 索引策略：根据实际查询模式设计针对性的复合索引
3. 数据归档：对历史日志数据进行定期归档，控制表数据量
4. 测试验证：任何索引变更都应在测试环境验证效果

总结

通过合理的索引设计，Fusio日志表的查询性能得到了显著提升。这一优化已被官方采纳并集成到5.1.4版本中，为所有用户带来更好的性能体验。对于高流量环境，建议结合日志轮转和归档策略，确保系统长期稳定运行。