hhdb数据库配置文件解析———日志配置

hhdb数据库使用过程中会产生日志文件，若不收集，则无法在出现问题时查找原因，若全部收集,时间久了就会产生大量的日志数据。当我们需要通过日志文件排查问题时，往往无法精准快速的定位问题。今天我来分享一些hhdb数据库的日志配置。

1 日志设置

hhdb数据库的配置文件为数据存储目录data目录下的hhdbsql.conf。修改完配置文件后需要重启数据库才会生效。

1.1 基本设置

启用日志收集，配置日志目录及日志前缀

# 启动日志收集， 这是一个后台进程，抓取发送到stderr的日志消息，并会将他们重定向到日志文件。 logging_collector = on
# 日志输出路径，可以是自定义绝对路径或相对于数据目录DATA 的相对路径 
log_directory = 'log'
# 设置日志输出格式log_line_prefix 设置日志输出格式（能够记录时间，用户名称，数据库名称，客户端IP和端口，方便定位问题）
log_line_prefix = '' #此项配置可以根据需求去进行配置建议配置时间和用户%m [%u]即可。
%a - 应用名
%u - 用户名
%d - 数据库名
%r - 远程主机名或 IP 地址，以及远程端口
%h - 远程主机名或 IP 地址
%p - 进程 ID
%t - 无毫秒的时间戳
%m - 带毫秒的时间戳
%n - 带毫秒的时间戳（作为 Unix 时间戳）
%i - 命令标签：会话当前命令的类型
%e - SQLSTATE 错误代码
%c - 会话 ID：见下文
%l - 对每个会话或进程的日志行号，从 1 开始
%s - 进程开始的时间戳
%v - 虚拟事务 ID (backendID/localXID)
%x - 事务 ID （如果未分配则为 0）
%q - 不产生输出，但是告诉非会话进程在字符串的这一点停止；会话进程忽略
%% - 纯文字

1.2 日志输出级别设置

#设置日志记录内容，log_statement：none，ddl，mod，and all。默认是none 
# None表示不记录
#ddl记录所有数据定义命令，比如CREATE,ALTER,和DROP语句， 
# mod记录所有ddl语句,加上数据修改语句INSERT,UPDATE等 
# all记录所有执行的语句，将此配置设置为all可跟踪整个数据库执行的SQL语句，但会对数据库性能产生较大影响，生产环境不建议配置此值。
log_min_duration_statement = 0. -1表示不可用，0将记录所有SQL语句和它们的耗时，>0只记录那些耗时超过（或等于）这个值（ms）的SQL语句。（用于记录耗时长存在性能问题的sql，不建议设置为0）
若设置为0则log_statement设置为none时也会输出所有sql的记录（log_min_duration_statement 优先级高于 log_statement）。

1.3 日志滚动策略配置

#日志文件名及其扩展名，默认即可
log_filename = 'hhdbsql-%Y-%m-%d_%H%M%S.log' # 交易日志文件名
%a 星期的英文单词的缩写：如星期一， 则返回 Mon
%A 星期的英文单词的全拼：如星期一，返回 Monday
%b 月份的英文单词的缩写：如一月， 则返回 Jan
%B 月份的引文单词的缩写：如一月， 则返回 January
%c 返回datetime的字符串表示，如03/08/15 23:01:26
%d 返回的是当前时间是当前月的第几天
%f 微秒的表示： 范围: [0,999999]
%H 以24小时制表示当前小时
%I 以12小时制表示当前小时
%j 返回 当天是当年的第几天 范围[001,366]
%m 返回月份 范围[0,12]
%M 返回分钟数 范围 [0,59]
%P 返回是上午还是下午–AM or PM
%S 返回秒数 范围 [0,61]...
%U 返回当周是当年的第几周 以周日为第一天
%W 返回当周是当年的第几周 以周一为第一天
%w 当天在当周的天数，范围为[0, 6]，6表示星期天
%x 日期的字符串表示 ：03/08/15
%X 时间的字符串表示 ：23:22:08
%y 两个数字表示的年份 15
%Y 四个数字表示的年份 2015
%z 与utc时间的间隔 （如果是本地时间，返回空字符串）
%Z 时区名称（如果是本地时间，返回空字符串）

#日志文件的权限，默认即可
log_file_mode = 0600
#默认为off，设置为on的话，如果新建了一个同名的日志文件，则会清空原来的文件，再写入日志，而不是在后面追加。
log_truncate_on_rotation =on
#单个日志文件的生存期，默认1天，在日志文件大小没有达到log_rotation_size时，一天只生成一个日志文件
log_rotation_age = 1d 
#当logging_collector被启用时，这个参数决定一个个体日志文件的最大尺寸。当这么多千字节被发送到一个日志文件后，将创建一个新的日志文件。将这个参数设置为零将禁用基于尺寸的新日志文件创建。
log_rotation_size=10MB

• 日志滚动设置示例

示例：日志滚动保存需要配合log_filename、log_truncate_on_rotation、以及log_rotation_age参数来组合设置。

每天一个文件保存一个星期
log_filename = 'hhdbsql-%A.log' 
log_truncate_on_rotation = on 
log_rotation_age = 1d
log_rotation_size = 100MB

每天一个文件保留1个月
logging_collector = on
log_statement='mod'
log_filename = 'hhdbsql-%d.log' 
log_truncate_on_rotation = on 
log_rotation_age = 1d
log_rotation_size = 100MB

每天一个文件保留1年
# 配置项
log_filename = 'hhdbsql-%Y-%m-%d_%H%M%S.log' # 交易日志文件名
# 示例
log_filename = 'hhdbsql-%A.log' 
log_truncate_on_rotation = on 
log_rotation_age = 1d
log_rotation_size = 100MB

说明

通过配置日志级别，可以保留我们需要的数据库交易记录。清理掉不需要的日志文件
位置：说明部分，避免日志文件日积月累占用太多的系统资源

附：日志参数参考表

恒辉产品社区（https://www.deskui.com）提供HHDB数据库的下载地址