
# 日志输出相关参数介绍
用户可以根据自己的需要，通过修改实例数据目录下的gaussdb.conf文件中特定的配置参数来控制日志的输出，从而更好地了解数据库的运行状态。
可调整的配置参数请参见[表1]。
 表1配置参数 
| 参数名称                               | 描述                                                                            | 取值范围                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 备注                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| client_min_messages                | 配置发送到客户端信息的级别。                                                                | - debug5  - debug4  - debug3  - debug2  - debug1  - log  - info  - notice  - warning  - error  - fatal  - panic   默认值：notice | 级别不低于设置值的所有消息会被发送。 通常，设置的级别越低，发送给客户端的消息就越多。 对于客户端日志消息：如果client_min_messages参数值设置为fatal或panic，该参数的实际值会被强制指定为error。client_min_messages无论设置为哪个级别，info级别消息都会发送到客户端。 |
| log_min_messages                   | 配置写到服务器日志里信息的级别。                                                              | - debug5  - debug4  - debug3  - debug2  - debug1  - log  - info  - notice  - warning  - error  - fatal  - panic   默认值：warning               | 级别不低于设置值的所有消息会被写入。 通常，设置的级别越低，写入服务器日志的消息就越多。 对于服务器日志消息：当log_min_messages设置级别不高于error时，log级别消息都会写入服务器日志。                                      |
| log_min_error_statement            | 配置写到服务器日志中错误SQL语句的级别。                                                         | - debug5  - debug4  - debug3  - debug2  - debug1  - log  - info  - notice  - warning  - error  - fatal  - panic   默认值：error                                  | 级别不低于设置值的消息对应的所有SQL语句会被写入。 通常，设置的级别越低，写入服务器日志的SQL语句就越多。 对于服务器日志SQL消息：当设置级别不高于error时，log级别消息对应的SQL语句都会写入服务器日志。 只有系统管理员可以修改该参数。                                                             |
| log_min_duration_statement         | 配置语句执行持续的最短时间。如果某个语句的持续时间大于或者等于设置的毫秒数，则会在日志中记录该语句及其持续时间。打开这个选项可以方便地跟踪需要优化的查询。 | INT类型。 默认值：-1。 单位：毫秒。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 设置为-1表示关闭这个功能。 只有系统管理员可以修改该参数。                                                                                                                                                                                                             |
| log_connections/log_disconnections | 配置是否在每次会话连接或结束时向服务器日志里打印一条信息。                                                 | - on：每次会话连接或结束时向日志里打印一条信息。  - off：每次会话连接或结束时不向日志里打印信息。   默认值：off。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | -                                                                                                                                                                                                                                                                                                                                   |
| log_duration                       | 配置是否记录每个已完成语句的持续时间。                                                           | - on：记录每个已完成语句的持续时间。  - off：不记录已完成语句的持续时间。   默认值：off                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 只有系统管理员可以修改该参数。                                                                                                                                                                                                                                                                                                                     |
| log_statement                      | 配置日志中记录哪些SQL语句。                                                               | - none：不记录任何SQL语句。  - ddl：记录数据定义语句。  - mod：记录数据定义语句和数据操作语句。  - all ：记录所有语句。   默认值： none                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 只有系统管理员可以修改该参数。                                                                                                                                                                                                                                                                                                                     |
| log_hostname                       | 配置是否记录主机名。                                                                    | - on：记录主机名。  - off：不记录主机名。   默认值：off                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 缺省时，连接日志只记录所连接主机的IP地址。打开这个选项会同时记录主机名。 该参数同时影响查看审计结果、系统视图PG_STAT_ACTIVITY和GUC参数log_line_prefix。                                                                                                                                                                                          |
   
上表有关参数级别的说明请参见[表2]。
 表2日志级别参数说明 
| 级别           | 说明                                  |
|:---|:---|
| DEBUG\[1-5\] | 提供开发人员使用的信息。5级为最高级别，以此类推，1级为最低级别。   |
| INFO         | 提供用户隐含要求的信息。如在VACUUM VERBOSE过程中的信息。 |
| NOTICE       | 提供可能对用户有用的信息。如长标识符的截断，作为主键一部分创建的索引。 |
| WARNING      | 提供给用户的警告。如在事务块范围之外的COMMIT。          |
| ERROR        | 报告导致当前命令退出的错误。                      |
| LOG          | 报告一些管理员感兴趣的信息。如检查点活跃性。              |
| FATAL        | 报告导致当前会话终止的原因。                      |
| PANIC        | 报告导致所有会话退出的原因。                      |
   
