ActionTech DBLE项目中的General日志功能详解

什么是General日志

General日志是ActionTech DBLE分布式数据库中间件提供的一种SQL语句记录功能。当开启此功能后，所有到达DBLE的SQL语句都会被记录下来，这对于数据库管理员进行SQL审计、性能分析以及故障排查非常有帮助。

General日志的核心特性

1. 记录范围：记录所有到达DBLE的SQL语句
2. 记录方式：仅支持文件(file)方式记录
3. 性能影响：开启后会有3%～5%的性能损耗
4. 使用建议：在不需要观察SQL执行情况时建议关闭此功能

配置参数详解

General日志功能通过bootstrap.cnf文件中的参数进行配置：

基础配置参数

1. homePath：指定DBLE存放各种文件的父目录

   • 示例：-DhomePath=. 表示当前路径

2. enableGeneralLog：控制是否开启General日志

   • 0：关闭（默认值）
   • 1：开启
   • 示例：-DenableGeneralLog=1

日志文件相关参数

1. generalLogFile：指定General日志文件路径

   • 相对路径：会在homePath后拼接
   • 绝对路径：以'/'开头
   • 默认值：general/general.log
   • 示例：
     • 相对路径：-DgeneralLogFile=general/general.log
     • 绝对路径：-DgeneralLogFile=/general/general.log

2. generalLogFileSize：触发日志文件翻转的大小（单位：MB）

   • 默认值：16MB
   • 超过此大小会生成格式为yyyy-MM/general-MM-dd-%d.log的新文件
   • 示例：-DgeneralLogFileSize=16

3. generalLogQueueSize：内部实现机制使用的队列大小

   • 必须是2的次方
   • 默认值：4096
   • 示例：-DgeneralLogQueueSize=4096

管理命令详解

DBLE提供了丰富的管理命令来操作General日志：

1. 查看General日志状态

show @@general_log;

返回结果示例：

+------------------+---------------------------------------+
| NAME             | VALUE                                 |
+------------------+---------------------------------------+
| general_log      | ON                                    |
| general_log_file | /tmp/./general/general.log            |
+------------------+---------------------------------------+

也可以通过查询系统表获取信息：

use dble_information; 
select * from dble_variables where variable_name like '%general%';

2. 开启/关闭General日志

开启日志：

enable @@general_log;

成功返回：

Query OK, 1 row affected (0.02 sec)
enable general_log success

关闭日志：

disable @@general_log;

成功返回：

Query OK, 1 row affected (0.02 sec)
disable general_log success

3. 修改日志文件路径

reload @@general_log_file='/tmp/dble-general/general/general.log';

成功返回：

Query OK, 1 row affected (0.00 sec)
reload general log path success

已知问题与限制

1. Execute包中的长数据：当执行Execute包时，接收到的long data数据会以16进制形式打印在general日志中

2. 读写分离用户：对于执行Execute包的读写分离用户，SQL不会打印出来。这是因为读写分离功能实际上只是SQL的中转站，过程中不会保留任何数据

最佳实践建议

1. 生产环境使用：由于开启General日志会有3%-5%的性能损耗，建议在生产环境中仅在需要排查问题时临时开启

2. 日志文件管理：根据业务量合理设置generalLogFileSize参数，避免单个日志文件过大

3. 监控日志存储：定期检查日志文件存储空间，确保有足够的磁盘空间

4. 安全考虑：General日志可能包含敏感SQL信息，应妥善保管日志文件并设置适当的访问权限

通过合理配置和使用General日志功能，可以有效地监控和分析DBLE中的SQL执行情况，为数据库性能优化和问题排查提供有力支持。