# 记录日志的内容 #### debug_print_parse **参数说明：**用于控制打印解析树结果。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示开启打印解析树结果的功能。 - off：表示关闭打印解析树结果的功能。 **默认值：**off **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### debug_print_rewritten **参数说明：**用于控制打印查询重写结果。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示开启打印查询重写结果的功能。 - off：表示关闭打印查询重写结果的功能。 **默认值：**off **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### debug_print_plan **参数说明：**用于设置是否将查询的执行计划打印到日志中。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示将查询的执行计划打印到日志中。 - off：表示不将查询的执行计划打印到日志中。 **默认值：**off **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) - 只有当日志的级别为log及以上时，debug_print_parse、debug_print_rewritten和debug_print_plan的调试信息才会输出。当这些选项打开时，调试信息只会记录在服务器的日志中，而不会输出到客户端的日志中。通过设置[client_min_messages](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0286.html#ZH-CN_TOPIC_0000002527986752__zh-cn_topic_0000002526895804_zh-cn_topic_0000002338364198_zh-cn_topic_0059778452_s2955da1f1cb24b0aa68ddc77700233e0)和[log_min_messages](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0286.html#ZH-CN_TOPIC_0000002527986752__zh-cn_topic_0000002526895804_zh-cn_topic_0000002338364198_zh-cn_topic_0059778452_sc6c47ec8cc1b47e28be98dbb24b1b39a)参数可以改变日志级别。 - 在打开debug_print_plan开关的情况下需尽量避免调用gs_encrypt_aes128及gs_decrypt_aes128函数，避免敏感参数信息在日志中泄露的风险。同时建议用户在打开debug_print_plan开关生成的日志中对gs_encrypt_aes128及gs_decrypt_aes128函数的参数信息进行过滤后再提供给外部维护人员定位，日志使用完成后请及时删除。 #### debug_pretty_print **参数说明：** 打开此参数对[debug_print_parse]、[debug_print_rewritten]和[debug_print_plan]产生的日志进行缩进，会生成易读且更长的输出格式。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示进行缩进。 - off：表示不进行缩进。 **默认值：**on **设置方式：** 该参数属于USERSET类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_checkpoints **参数说明：**控制在服务器日志中记录检查点和重启点的信息。打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量，其中包含需要写的缓存区的数量及写入所花费的时间等。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示打开此参数，服务器日志消息包含涉及检查点和重启点的统计量。 - off：表示关闭此参数，服务器日志消息不包含涉及检查点和重启点的统计量。 **默认值：**off **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_connections **参数说明：**控制是否记录客户端连接请求的日志信息。日志信息包括连接的IP、PORT、用户名、数据库名、GaussDB数据库响应建立连接流程中关键步骤的耗时等。 ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 部分客户端程序（例如gsql），在判断是否需要口令的时候会尝试连接两次，因此日志消息中可能存在重复的"connection receive"（收到连接请求）。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示记录日志信息。 - off：表示不记录日志信息。 **默认值：**off **设置方式：** 该参数属于BACKEND类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_disconnections **参数说明：**控制记录客户端结束连接信息。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示记录信息。 - off：表示不记录信息。 **默认值：**off **设置方式：** 该参数属于BACKEND类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_duration **参数说明：**控制是否记录每个已完成SQL语句的执行时间。对使用扩展查询协议的客户端，会记录语法分析、绑定和执行每一步所花费的时间。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示记录所有已完成SQL语句的执行时间。 - off：表示不记录SQL语句的执行时间。 ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 该参数设置为on或[log_min_duration_statement](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0286.html#ZH-CN_TOPIC_0000002527986752__zh-cn_topic_0000002526895804_zh-cn_topic_0000002338364198_zh-cn_topic_0059778452_s62cf0fb833324a82a841f02134a932e5)设置为0都会记录每个已完成SQL语句的执行时间，不同之处在于log_min_duration_statement会强制记录SQL语句。 **默认值：**off **设置方式：** 该参数属于SUSET类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_error_verbosity **参数说明：**控制服务器日志中每条记录的消息写入的详细度。 **参数类型：**枚举类型 **参数单位：**无 **取值范围：** - terse：表示不包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录。 - verbose：表示包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 - default：表示包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录，不包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 **默认值：**default **设置方式：** 该参数属于SUSET类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**根据对日志消息的详细度要求进行设置。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_hostname **参数说明：**此参数关闭状态下，连接消息日志只显示正在连接主机的IP地址。打开此参数，表示会同时记录主机名。由于解析主机名需要一定的时间，可能影响数据库的性能。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示记录主机名。 - off：表示不记录主机名。 **默认值：**off **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**开启时可能影响数据库的性能。 #### log_line_prefix **参数说明：** 控制每条日志信息的前缀格式。日志前缀类似于printf风格的字符串，在日志的每行开头输出。用以%为开头的"转义字符"表示状态信息，具体请参见[表1]。 表1转义字符表 | 转义字符 | 状态信息 | |:---|:---| | %a | 应用程序名称。 | | %u | 用户名。 | | %d | 数据库名。 | | %r | 远端主机名或者IP地址以及远端端口，在不启动log_hostname时显示IP地址及远端端口。 | | %h | 远端主机名或者IP地址，在不启动log_hostname时只显示IP地址。 | | %p | 线程ID。 | | %t | 时间戳（不带毫秒，Windows上没有时区）。 | | %m | 带毫秒的时间戳。 | | %n | 表示指定错误上报的节点。 | | %i | 命令标签：会话当前执行的命令类型。 | | %e | SQLSTATE错误码。 | | %c | 会话ID，详见说明。 | | %l | 每个会话或线程的日志编号，从1开始。 | | %s | 线程启动时间。 | | %v | 虚拟事务ID（backendID/ localXID） | | %x | 事务ID（0表示没有分配事务ID）。 | | %q | 不产生任何输出。如果当前线程是后端线程，忽略这个转义序列，继续处理后面的转义序列；如果当前线程不是后端线程，忽略这个转义序列和它后面的所有转义序列。 | | %S | 会话ID。 | | %T | Trace ID。 | | %% | 字符%。 | ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 转义字符%c打印的会话ID，由两个4字节的十六进制数组成，通过字符"."分开。这两个十六进制数分别表示线程的启动时间及线程编号，所以%c也可以用作一种更节省空间的记录线程启动时间和编号的方式。比如，可以用下面的查询从pg_stat_activity中生成这种十六进制的会话ID： ``` SELECT to_hex(EXTRACT(EPOCH FROM backend_start)::integer) || '.' || to_hex(pid) FROM pg_stat_activity; ``` - 当log_line_prefix设置为非空值时，需要保证最后一个字符是一个空格，以此来直观地与后续的日志行进行区分，也可以使用一个标点符号。 - Syslog会生成时间戳及线程ID信息，所以当登录日志时，不需要包含这些转义字符。 **参数类型：**字符串 **参数单位：**无 **取值范围：**字符串 **默认值：**'%m %n %u %d %h %p %S %x %a ' ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png) %m %n %u %d %h %p %S %x %a 表示会话开始时间戳、错误上报节点、用户名、数据库名、远程主机名或IP、线程ID、会话ID、事务ID、应用程序名称。 **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**根据对日志状态信息的需求进行设置。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_lock_waits **参数说明：** 当一个会话的等待获得一个锁的时间超过[deadlock_timeout](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0300.html#ZH-CN_TOPIC_0000002558946623__zh-cn_topic_0000002558056293_zh-cn_topic_0000002338523934_zh-cn_topic_0059778102_se697b4ff00b643938b67eb5e08206cd5)的值时，此参数控制在数据库日志中记录此消息，有助于判断锁等待事件是否会导致死锁等问题。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示记录此信息。 - off：表示不记录此信息。 **默认值：**off **设置方式：** 该参数属于SUSET类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_statement **参数说明** **：**控制记录SQL语句。对于使用扩展查询协议的客户端，记录接收到执行消息的事件和绑定参数的值（内置单引号要双写）。 ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) - 即使log_statement设置为all，包含简单语法错误的语句也不会被记录，因为仅在完成基本的语法分析并确定了语句类型之后才记录日志。在使用扩展查询协议的情况下，执行阶段之前（语法分析或规划阶段）同样不会记录。将[log_min_error_statement](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0286.html#ZH-CN_TOPIC_0000002527986752__zh-cn_topic_0000002526895804_zh-cn_topic_0000002338364198_zh-cn_topic_0059778452_s8cdbbd89c18b4425ad32f96456349c1d)设为ERROR或更低才能记录这些语句。 - 设置该参数为非none时，可视为开启相关语句审计功能，数据库DBA可以访问服务端日志查看SQL执行记录。 **参数类型：**枚举类型 **参数单位：**无 **取值范围：** - none：表示不记录SQL语句。 - ddl：表示记录所有的数据定义语句，比如CREATE、ALTER和DROP语句。 - mod：表示记录所有DDL语句，还包括数据修改语句INSERT、UPDATE、DELETE、TRUNCATE和COPY FROM 。 - all：表示记录所有语句，PREPARE、EXECUTE和EXPLAIN ANALYZE语句也同样被记录。 **默认值：**none **设置方式：** 该参数属于SUSET类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**根据是否需要记录SQL语句进行设置。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### log_temp_files **参数说明：**控制记录比该参数设定值大的临时文件的删除信息。临时文件可以用来排序、哈希及临时查询结果。当一个临时文件被删除时，将会产生一条日志消息。 **参数类型：**整型 **参数单位：**kB **取值范围：**-1 \~ 2147483647 - 正整数表示只记录比log_temp_files设定值大的临时文件的删除信息。 - 0表示记录所有的临时文件的删除信息。 - -1表示不记录任何临时文件的删除信息。 **默认值：**-1 **设置方式：** 该参数属于SUSET类型参数，请参见[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。取值为整数时，默认单位为kB；如果带单位，必须为kB、MB、GB。例如，不带单位取值16384，表示log_temp_files为16384kB；带单位取值16MB，表示log_temp_files为16MB。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**设置为非-1的值时，当满足记录要求的临时文件越多，日志记录也会越多，则会影响系统性能。取值若超出范围，或者取值带有除kB、MB、GB以外的单位时，会有报错提示。 #### log_timezone **参数说明：** 设置服务器写日志文件时使用的时区。与[TimeZone](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0298.html#ZH-CN_TOPIC_0000002527826812__zh-cn_topic_0000002526896558_zh-cn_topic_0000002338364558_zh-cn_topic_0059778109_sa60c5d71347646c2ad97ccb7541c6f12)不同，这个值是数据库范围的，针对所有连接到本数据库的会话生效。 **参数类型：**字符串 **参数单位：**无 **取值范围：**字符串，可查询视图PG_TIMEZONE_NAMES（详见《开发指南》的"系统表和系统视图 \> 系统视图 \> PG_TIMEZONE_NAMES"章节）获得。 **默认值：**根据OS时区设置 **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png) gs_initdb进行相应系统环境设置时会对默认值进行修改。 #### logging_module **参数说明：** 用于设置或者显示模块日志在服务端的可输出性。该参数依赖于[log_min_messages](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0286.html#ZH-CN_TOPIC_0000002527986752__zh-cn_topic_0000002526895804_zh-cn_topic_0000002338364198_zh-cn_topic_0059778452_sc6c47ec8cc1b47e28be98dbb24b1b39a)参数的设置，低于log_min_messages设置级别的模块日志不会打印。 **参数类型：**字符串 **参数单位：**无 **取值范围：** ``` ALL,on(),off(COMMAND,DFS,GUC,GSCLEAN,HDFS,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,GDS,TBLSPC,WLM,OBS,INDEX,EXECUTOR,OPFUSION,GPC,GSC,VEC_EXECUTOR,STREAM,LLVM,OPT,OPT_REWRITE,CBOPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_CHOICE,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,OPT_PLANNER,OPT_STAT_EXT,SPM,SPM_KEY_FLOW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,MOT,PLANHINT,PARQUET,PGSTAT,CARBONDATA,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,PLSQL_COMPILE,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,WDR_SNAPSHOT,WDR_REPORT,ASP_REPORT,BLACKBOX,INCRE_CKPT,INCRE_BG_WRITER,DBL_WRT,RTO_RPO,HEARTBEAT,COMM_IPC,COMM_PARAM,TIMESERIES,SCHEMA,GTT,SEGMENT_PAGE,LIGHTPROXY,HOTKEY,THREAD_POOL,OPT_AI,WALRECEIVER,USTORE,UPAGE,UBTREE,UNDO,TIMECAPSULE,GEN_COL,DCF,AI4DB,DB4AI,ABO,MOD_ABOFEEDBACK,PLDEBUGGER,ADVISOR,SEC,SEC_FE,SEC_LEGER,SEC_POLICY,SEC_SDD,SEC_TDE,COMM_FRAMEWORK,COMM_PROXY,COMM_POOLER,COMM_STATUS,VACUUM,JOB,SPI,NEST_COMPILE,RESOWNER,GSSTACK,LOGICAL_DECODE,GPRC,DISASTER_READ,STANDBY_READ,SQL_APPLY,REPSYNC,SQLPATCH,PARTITION,UBT_NEWPAGE,GS_DEPENDENCY,GPI,LWLOCK,LOCK,UNIQUE_SQL,GSI,GLC,SRF,DBLINK,BARRIER_CREATOR,EXRTO_PAGE_P,SEQ_TUP_P,BT_TUP_P,DISPATCH_VERIFY,HBKT,DBE_STATS,DBE_XMLGEN,UPDATE_DIST_COL,GS_ILM,GSPERF,EXEC_REMOTE,UBTREE_PARA,BTREE_PARA,ANTI_CACHE,ANTI_RECYCLER,VERIFYLOG,GS_REPAIR,AUTHID,CCINDEX,UPSERT,ONLINE_DDL,MTD,EXRTO_BUFFER,WAL,STREAM_PBE,HTAP,UALT,GTM_LITE_READ_S,UGIN,EXRTO_READ_RECY,GS_SIGNAL,BUFFILE,BUFFER,PAGE,IMPORT_EXPORT,UTIL) ``` ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) 当前版本CN_RETRY不生效。 **默认值：**'off(ALL)'。即默认关闭所有模块日志。 **设置方式：**该参数属于会话级参数，不建议通过gs_guc工具来设置。 **设置方法**：首先，可以通过SHOW logging_module来查看哪些模块是支持可控制的。例如，查询输出结果为： ``` gaussdb=# show logging_module; logging_module -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ALL,on(),off(COMMAND,DFS,GUC,GSCLEAN,HDFS,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,GDS,TBLSPC,WLM,OBS,INDEX,EXECUTOR,OPFUSION,GPC,GSC,VEC_EXECUTOR,STREAM,LLVM,OPT,OPT_REWRITE,CBOPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_CHOICE,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,OPT_PLANNER,OPT_STAT_EXT,SPM,SPM_KEY_FLOW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,MOT,PLANHINT,PARQUET,PGSTAT,CARBONDATA,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,PLSQL_COMPILE,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,WDR_SNAPSHOT,WDR_REPORT,ASP_REPORT,BLACKBOX,INCRE_CKPT,INCRE_BG_WRITER,DBL_WRT,RTO_RPO,HEARTBEAT,COMM_IPC,COMM_PARAM,TIMESERIES,SCHEMA,GTT,SEGMENT_PAGE,LIGHTPROXY,HOTKEY,THREAD_POOL,OPT_AI,WALRECEIVER,USTORE,UPAGE,UBTREE,UNDO,TIMECAPSULE,GEN_COL,DCF,AI4DB,DB4AI,ABO,MOD_ABOFEEDBACK,PLDEBUGGER,ADVISOR,SEC,SEC_FE,SEC_LEGER,SEC_POLICY,SEC_SDD,SEC_TDE,COMM_FRAMEWORK,COMM_PROXY,COMM_POOLER,COMM_STATUS,VACUUM,JOB,SPI,NEST_COMPILE,RESOWNER,GSSTACK,LOGICAL_DECODE,GPRC,DISASTER_READ,STANDBY_READ,SQL_APPLY,REPSYNC,SQLPATCH,PARTITION,UBT_NEWPAGE,GS_DEPENDENCY,GPI,LWLOCK,LOCK,UNIQUE_SQL,GSI,GLC,SRF,DBLINK,BARRIER_CREATOR,EXRTO_PAGE_P,SEQ_TUP_P,BT_TUP_P,DISPATCH_VERIFY,HBKT,DBE_STATS,DBE_XMLGEN,UPDATE_DIST_COL,GS_ILM,GSPERF,EXEC_REMOTE,UBTREE_PARA,BTREE_PARA,ANTI_CACHE,ANTI_RECYCLER,VERIFYLOG,GS_REPAIR,AUTHID,CCINDEX,UPSERT,ONLINE_DDL,MTD,EXRTO_BUFFER,WAL,STREAM_PBE,HTAP,UALT,GTM_LITE_READ_S,UGIN,EXRTO_READ_RECY,GS_SIGNAL,BUFFILE,BUFFER,PAGE,IMPORT_EXPORT,UTIL) (1 row) ``` 支持可控制的模块使用大写来标识，特殊标识ALL用于对所有模块日志进行设置。可以使用on/off来控制模块日志的输出。设置SSL模块日志为可输出，使用如下命令： ``` gaussdb=# set logging_module='on(SSL)'; SET gaussdb=# show logging_module; logging_module ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ALL,on(SSL),off(COMMAND,DFS,GUC,GSCLEAN,HDFS,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,GDS,TBLSPC,WLM,OBS,INDEX,EXECUTOR,OPFUSION,GPC,GSC,VEC_EXECUTOR,STREAM,LLVM,OPT,OPT_REWRITE,CBOPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_CHOICE,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,OPT_PLANNER,OPT_STAT_EXT,SPM,SPM_KEY_FLOW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,MOT,PLANHINT,PARQUET,PGSTAT,CARBONDATA,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,PLSQL_COMPILE,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,WDR_SNAPSHOT,WDR_REPORT,ASP_REPORT,BLACKBOX,INCRE_CKPT,INCRE_BG_WRITER,DBL_WRT,RTO_RPO,HEARTBEAT,COMM_IPC,COMM_PARAM,TIMESERIES,SCHEMA,GTT,SEGMENT_PAGE,LIGHTPROXY,HOTKEY,THREAD_POOL,OPT_AI,WALRECEIVER,USTORE,UPAGE,UBTREE,UNDO,TIMECAPSULE,GEN_COL,DCF,AI4DB,DB4AI,ABO,MOD_ABOFEEDBACK,PLDEBUGGER,ADVISOR,SEC,SEC_FE,SEC_LEGER,SEC_POLICY,SEC_SDD,SEC_TDE,COMM_FRAMEWORK,COMM_PROXY,COMM_POOLER,COMM_STATUS,VACUUM,JOB,SPI,NEST_COMPILE,RESOWNER,GSSTACK,LOGICAL_DECODE,GPRC,DISASTER_READ,STANDBY_READ,SQL_APPLY,REPSYNC,SQLPATCH,PARTITION,UBT_NEWPAGE,GS_DEPENDENCY,GPI,LWLOCK,LOCK,UNIQUE_SQL,GSI,GLC,SRF,DBLINK,BARRIER_CREATOR,EXRTO_PAGE_P,SEQ_TUP_P,BT_TUP_P,DISPATCH_VERIFY,HBKT,DBE_STATS,DBE_XMLGEN,UPDATE_DIST_COL,GS_ILM,GSPERF,EXEC_REMOTE,UBTREE_PARA,BTREE_PARA,ANTI_CACHE,ANTI_RECYCLER,VERIFYLOG,GS_REPAIR,AUTHID,CCINDEX,UPSERT,ONLINE_DDL,MTD,EXRTO_BUFFER,WAL,STREAM_PBE,HTAP,UALT,GTM_LITE_READ_S,UGIN,EXRTO_READ_RECY,GS_SIGNAL,BUFFILE,BUFFER,PAGE,IMPORT_EXPORT,UTIL) (1 row) ``` 可以看到模块SSL的日志输出被打开。 ALL标识相当于一个快捷操作，即对所有模块的日志可输出进行开启或关闭。 ``` gaussdb=# set logging_module='off(ALL)'; SET gaussdb=# show logging_module; logging_module -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ALL,on(),off(COMMAND,DFS,GUC,GSCLEAN,HDFS,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,GDS,TBLSPC,WLM,OBS,INDEX,EXECUTOR,OPFUSION,GPC,GSC,VEC_EXECUTOR,STREAM,LLVM,OPT,OPT_REWRITE,CBOPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_CHOICE,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,OPT_PLANNER,OPT_STAT_EXT,SPM,SPM_KEY_FLOW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,MOT,PLANHINT,PARQUET,PGSTAT,CARBONDATA,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,PLSQL_COMPILE,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,WDR_SNAPSHOT,WDR_REPORT,ASP_REPORT,BLACKBOX,INCRE_CKPT,INCRE_BG_WRITER,DBL_WRT,RTO_RPO,HEARTBEAT,COMM_IPC,COMM_PARAM,TIMESERIES,SCHEMA,GTT,SEGMENT_PAGE,LIGHTPROXY,HOTKEY,THREAD_POOL,OPT_AI,WALRECEIVER,USTORE,UPAGE,UBTREE,UNDO,TIMECAPSULE,GEN_COL,DCF,AI4DB,DB4AI,ABO,MOD_ABOFEEDBACK,PLDEBUGGER,ADVISOR,SEC,SEC_FE,SEC_LEGER,SEC_POLICY,SEC_SDD,SEC_TDE,COMM_FRAMEWORK,COMM_PROXY,COMM_POOLER,COMM_STATUS,VACUUM,JOB,SPI,NEST_COMPILE,RESOWNER,GSSTACK,LOGICAL_DECODE,GPRC,DISASTER_READ,STANDBY_READ,SQL_APPLY,REPSYNC,SQLPATCH,PARTITION,UBT_NEWPAGE,GS_DEPENDENCY,GPI,LWLOCK,LOCK,UNIQUE_SQL,GSI,GLC,SRF,DBLINK,BARRIER_CREATOR,EXRTO_PAGE_P,SEQ_TUP_P,BT_TUP_P,DISPATCH_VERIFY,HBKT,DBE_STATS,DBE_XMLGEN,UPDATE_DIST_COL,GS_ILM,GSPERF,EXEC_REMOTE,UBTREE_PARA,BTREE_PARA,ANTI_CACHE,ANTI_RECYCLER,VERIFYLOG,GS_REPAIR,AUTHID,CCINDEX,UPSERT,ONLINE_DDL,MTD,EXRTO_BUFFER,WAL,STREAM_PBE,HTAP,UALT,GTM_LITE_READ_S,UGIN,EXRTO_READ_RECY,GS_SIGNAL,BUFFILE,BUFFER,PAGE,IMPORT_EXPORT,UTIL) (1 row) gaussdb=# set logging_module='on(ALL)'; SET gaussdb=# show logging_module; logging_module -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ALL,on(COMMAND,DFS,GUC,GSCLEAN,HDFS,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,GDS,TBLSPC,WLM,OBS,INDEX,EXECUTOR,OPFUSION,GPC,GSC,VEC_EXECUTOR,STREAM,LLVM,OPT,OPT_REWRITE,CBOPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_CHOICE,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,OPT_PLANNER,OPT_STAT_EXT,SPM,SPM_KEY_FLOW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,MOT,PLANHINT,PARQUET,PGSTAT,CARBONDATA,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,PLSQL_COMPILE,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,WDR_SNAPSHOT,WDR_REPORT,ASP_REPORT,BLACKBOX,INCRE_CKPT,INCRE_BG_WRITER,DBL_WRT,RTO_RPO,HEARTBEAT,COMM_IPC,COMM_PARAM,TIMESERIES,SCHEMA,GTT,SEGMENT_PAGE,LIGHTPROXY,HOTKEY,THREAD_POOL,OPT_AI,WALRECEIVER,USTORE,UPAGE,UBTREE,UNDO,TIMECAPSULE,GEN_COL,DCF,AI4DB,DB4AI,ABO,MOD_ABOFEEDBACK,PLDEBUGGER,ADVISOR,SEC,SEC_FE,SEC_LEGER,SEC_POLICY,SEC_SDD,SEC_TDE,COMM_FRAMEWORK,COMM_PROXY,COMM_POOLER,COMM_STATUS,VACUUM,JOB,SPI,NEST_COMPILE,RESOWNER,GSSTACK,LOGICAL_DECODE,GPRC,DISASTER_READ,STANDBY_READ,SQL_APPLY,REPSYNC,SQLPATCH,PARTITION,UBT_NEWPAGE,GS_DEPENDENCY,GPI,LWLOCK,LOCK,UNIQUE_SQL,GSI,GLC,SRF,DBLINK,BARRIER_CREATOR,EXRTO_PAGE_P,SEQ_TUP_P,BT_TUP_P,DISPATCH_VERIFY,HBKT,DBE_STATS,DBE_XMLGEN,UPDATE_DIST_COL,GS_ILM,GSPERF,EXEC_REMOTE,UBTREE_PARA,BTREE_PARA,ANTI_CACHE,ANTI_RECYCLER,VERIFYLOG,GS_REPAIR,AUTHID,CCINDEX,UPSERT,ONLINE_DDL,MTD,EXRTO_BUFFER,WAL,STREAM_PBE,HTAP,UALT,GTM_LITE_READ_S,UGIN,EXRTO_READ_RECY,GS_SIGNAL,BUFFILE,BUFFER,PAGE,IMPORT_EXPORT,UTIL),off() (1 row) ``` **设置建议：**根据需要开启对应模块日志的打印。不建议开启所有模块的日志打印（即：'on(ALL)'）。 **设置不当的风险与影响：**开启时可能会打印较多对应模块相关的日志，影响系统性能。 #### enable_unshipping_log **参数说明：** 用于控制是否打印语句不下推的日志，主要用于帮助用户定位不下推语句可能导致的性能问题。当[enable_stream_operator](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0280.html#ZH-CN_TOPIC_0000002559106507__zh-cn_topic_0000002527056344_zh-cn_topic_0000002372322525_zh-cn_topic_0059778346_sd0c593b1c12b49a9a00ffab1b79771f6)参数关闭时，如果此参数设置为on，会有大量关于计划不能下推的日志记录到日志文件中。如果用户不需要这些日志内容，建议用户在enable_stream_operator参数关闭时，也同时关闭enable_unshipping_log参数。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示打印日志。 - off：表示不打印日志。 **默认值：**off **设置方式：** 该参数属于USERSET类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### opfusion_debug_mode **参数说明** **：**用于调试简单查询是否进行查询优化。设置成log级别可以在DN的执行计划中看到没有查询优化的具体原因。 **参数类型：**枚举类型 **参数单位：**无 **取值范围：** - off：表示不打开该功能。 - log：表示打开该功能，可以在DN的执行计划中看到没有查询优化的具体原因。 ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) - 需要设置参数[max_datanode_for_plan](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0283.html#ZH-CN_TOPIC_0000002558946615__zh-cn_topic_0000002526896464_zh-cn_topic_0000002338523962_section133745491475)才能看到DN的执行计划。 - 提供在log中显示语句没有查询优化的具体原因，需要将参数设置成log级别，[log_min_messages](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0286.html#ZH-CN_TOPIC_0000002527986752__zh-cn_topic_0000002526895804_zh-cn_topic_0000002338364198_zh-cn_topic_0059778452_sc6c47ec8cc1b47e28be98dbb24b1b39a)设置成debug4级别，[logging_module]设置'on(OPFUSION)'，注意log内容可能会比较多，尽可能在调优期间执行少量作业使用。 **默认值：**off **设置方式：** 该参数属于USERSET类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### enable_debug_vacuum **参数说明：**允许输出一些与VACUUM相关的日志，便于定位VACUUM相关问题。开发人员专用，不建议普通用户使用。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示开启此日志开关。 - off：表示关闭此日志开关。 **默认值：**off **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### enable_err_stack **参数说明**：控制ERROR级别中ACTION为"Contact Huawei technical support."的错误码报错是否打印堆栈。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示开启此日志开关。 - off：表示关闭此日志开关。 **默认值：**on **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。 #### enable_show_err_code **参数说明**：控制gsql等前端连接是否显示报错的错误码。 **参数类型：**布尔型 **参数单位：**无 **取值范围：** - on：表示开启此开关。 - off：表示关闭此开关。 **默认值：**off **设置方式：** 该参数属于SIGHUP类型参数，请参考[表1](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0254.html#ZH-CN_TOPIC_0000002527826790__zh-cn_topic_0000002558055361_zh-cn_topic_0000002338364610_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。 **设置建议：**推荐使用默认值。 **设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。