记录日志的时间
client_min_messages
参数说明:用于控制发送到客户端的消息级别,级别不低于参数设置值的所有消息会被发送。
参数类型:枚举类型
参数单位:无
取值范围:消息级别从低到高依次为debug5、debug4、debug3、debug2、debug1、log、info、notice、warning、error、fatal和panic。参数的详细信息请参见表1。
- 通常,设置的级别越低,发送给客户端的消息就越多。
- 对于客户端日志消息:如果client_min_messages参数值设置为fatal或panic,该参数的实际值会被强制指定为error。client_min_messages无论设置为哪个级别,info级别消息都会发送到客户端。
- 客户端连接至CN节点时,debug(debug5、debug4、debug3、debug2、debug1)和log级别消息因安全和性能原因不会发送至客户端,如需查看这两类日志,请直接查看CN节点的服务器日志。
默认值:notice
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
log_min_messages
参数说明:用于控制写入服务器日志的消息级别,级别不低于参数设置值的所有消息会被写入。
参数类型:枚举类型
参数单位:无
取值范围:消息级别从低到高依次为debug5、debug4、debug3、debug2、debug1、log、info、notice、warning、error、fatal和panic。参数的详细信息请参见表1。
- 通常,设置的级别越低,写入服务器日志的消息就越多。
- 对于服务器日志消息:当log_min_messages设置级别不高于error时,log级别消息都会写入服务器日志。
- 由于频繁打印会影响系统性能和稳定性,参数级别debug1至debug5一般作为客户现场问题定位手段使用,且建议优先按照模块(参见logging_module)开启这些级别,并在后续及时恢复原有日志级别。
默认值:warning
设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
log_min_error_statement
参数说明:用于控制写入服务器日志的SQL语句对应的消息级别,级别不低于参数设置值的消息对应的所有SQL语句会被写入。
参数类型:枚举类型
参数单位:无
取值范围:消息级别从低到高依次为debug5、debug4、debug3、debug2、debug1、log、info、notice、warning、error、fatal和panic。参数的详细信息请参见表1。
- 通常,设置的级别越低,写入服务器日志的SQL语句就越多。
- 对于服务器日志SQL消息:当设置级别不高于error时,log级别消息对应的SQL语句都会写入服务器日志。
- 当SQL语句中包含用户个人信息时,若不需要记录报错的SQL语句,可以将log_min_error_statement设置为panic。
默认值:error
设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
log_min_duration_statement
参数说明:当某条SQL语句的执行时间大于或者等于该参数设定的值时,这条SQL语句和其执行时间会一并被记录。
设置log_min_duration_statement可以很方便地跟踪需要优化的查询语句。对于使用扩展查询协议的客户端,语法分析、绑定、执行每一步所花的时间将被独立记录。
参数类型:整型
参数单位:ms(毫秒)
当此参数与log_statement同时使用时,已经被log_statement记录的SQL语句不会被重复记录。在没有使用syslog情况下,推荐使用log_line_prefix记录PID或会话ID,方便通过PID或会话ID关联语句消息和执行时间消息。
取值范围:-1 ~ 2147483647
- 设置为-1,关闭此功能。
- 设置为0,记录所有SQL语句和其执行时间。
- 设置为正整数,当某条SQL语句的执行时间大于等于设置值时,这条SQL语句和其执行时间会一并被记录。
默认值:3000(即3s)
设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。取值为整数时,默认单位为ms;取值如果带单位,必须为ms、s、min、h、d。例如,不带单位取值600,表示log_min_duration_statement为600ms;带单位取值10min,表示log_min_duration_statement为10min。
设置建议:设置为默认值。
设置不当的风险与影响:取值若超出范围,或者取值带有除ms、s、min、h、d以外的单位时,会有报错提示。
backtrace_min_messages
参数说明:用于控制写入服务器日志的函数堆栈信息的消息级别,级别不低于参数设置值的消息对应的所有堆栈信息会被写入。
参数类型:枚举类型
参数单位:无
取值范围:消息级别从低到高为debug5、debug4、debug3、debug2、debug1、log、info、notice、warning、error、fatal、panic。参数的详细信息请参见表1。
- 通常,设置的级别越低,写入服务器日志的堆栈信息就越多。
- 该参数作为客户现场问题定位手段使用。由于频繁打印函数堆栈会影响到系统开销及稳定性,问题定位时建议将backtrace_min_messages设置为fatal或panic。
默认值:panic
设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。如果设置的级别过低,在高并发场景下,线程并发打印堆栈可能影响业务正常执行。例如,如果在高并发建连时此参数设置不合理,会拖慢建连线程池处理效率,甚至导致数据库实例不可连接。
表1解释GaussDB中使用的消息安全级别。当日志输出到syslog或者eventlog(仅windows环境下,GaussDB版本不涉及该参数)时,GaussDB进行如表中的转换。
| 信息严重程度类型 | 详细说明 | 系统日志 | 事件日志 |
|---|---|---|---|
| debug[1-5] | 报告详细调试信息。 | DEBUG | INFORMATION |
| log | 报告对数据库管理员有用的信息, 比如检查点操作统计信息。 | INFO | INFORMATION |
| info | 报告用户可能需求的信息, 比如在VACUUM VERBOSE过程中的信息。 | INFO | INFORMATION |
| notice | 报告可能对用户有帮助的信息, 比如, 长标识符的截断, 作为主键一部分创建的索引等。 | NOTICE | INFORMATION |
| warning | 报告警告信息, 比如在事务块范围之外的COMMIT。 | NOTICE | WARNING |
| error | 报告导致当前命令退出的错误。 | WARNING | ERROR |
| fatal | 报告导致当前会话终止的原因。 | ERR | ERROR |
| panic | 报告导致整个数据库被关闭的原因。 | CRIT | ERROR |