# 系统性能快照
#### enable_perf_trigger
**参数说明：**设置是否开启秒级CPU冲高火焰图功能
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- on：打开数据库秒级CPU冲高火焰图功能。
- off：关闭数据库秒级CPU冲高火焰图功能。
**默认值** **：**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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### perf_trigger_limit
**参数说明：**设置由CPU使用率冲高触发火焰图采集的阈值。当系统CPU资源占用率超过该参数取值时，会生成CPU冲高火焰图。
**参数类型：**整型
**参数单位：**%
**取值范围：**0 \~ 100
**默认值** **：**90
**设置方式：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### perf_trigger_increase
**参数说明：**设置由CPU使用率秒级升高触发火焰图采集的阈值。当系统CPU资源占用率相比前一秒升高的比例超过该参数取值时，会生成CPU秒级冲高火焰图。
**参数类型：**整型
**参数单位：**%
**取值范围：**0 \~ 100
**默认值** **：**30
**设置方式：** 该参数属于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_wdr_snapshot
**参数说明：**设置是否开启数据库监控快照功能。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- 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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
不建议打开的场景：
- 在多表和多库的场景下，wdr snapshot会在每个库串行记录快照，记录快照时间会很长，不建议打开。
- 在多表的场景下，由于内部的一些表的性能问题，pg_stat_all_tables在多表的场景下，查询很慢，这时做wdr snapshot就会很慢，所以不建议打开。
- 如果在大量DDL期间做WDR snapshot会可能造成WDR snapshot失败，不建议打开。
 
#### enable_wdr_snapshot_standby
**参数说明：** 设置是否开启WDR功能支持分布式备机，开启该参数后，WDR snapshot会获取备机的性能数据，并存储在主机。该参数需要在GTM FREE模式下生效，即[enable_gtm_free](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-10-0306.html#ZH-CN_TOPIC_0000002527986764__zh-cn_topic_0000002527055628_zh-cn_topic_0000002338364398_section1080710724310)取值为on时生效。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- on：开启WDR功能支持分布式备机。
- off：关闭WDR功能支持分布式备机。
**默认值** **：**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_show_standby_name
**参数说明** **：**设置是否开启显示区分同一分片主备机名字的功能，该名字区分主备节点。在主备DN上设置该参数，查询性能视图，视图中的node_name可以区分主备机，开启该功能后在同一分片的不同节点上查询dbe_perf.node_name，返回不同的名字。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- 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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响** **：**请在充分理解参数含义，并经过测试验证后进行修改。
#### wdr_snapshot_retention_days
**参数说明：**系统中数据库监控快照数据的保留天数。当数据库运行过程期间所生成的快照数量超过保留天数内允许生成的快照数量的最大值(默认为24\*8=192)时，系统将每隔wdr_snapshot_interval时间间隔，清理一次snapshot_id最小的快照数据。
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
当且仅当[enable_wdr_snapshot]参数取值为on时，该参数设置有效。
**参数类型：**整型
**参数单位：**d（天）
**取值范围：**1 \~ 30
**默认值** **：**8
**设置方式：** 该参数属于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)中对应设置方法进行设置。取值不能带单位。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响** **：**该参数取值越大，磁盘占用越高。
#### wdr_snapshot_query_timeout
**参数说明：**系统执行数据库监控快照操作时，设置快照操作相关的sql语句的执行超时时间。如果语句超过设置的时间没有执行完并返回结果，则本次快照操作失败，但会将已经生成的部分快照保留下来。
**参数类型：**整型
**参数单位：**s（秒）
**取值范围：**0 \~ 2147483647
**默认值** **：**100
**设置方式：** 该参数属于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)中对应设置方法进行设置，0表示不作超时限制。例如，不带单位取值60，表示wdr_snapshot_query_timeout为60s；带单位取值1min，表示wdr_snapshot_query_timeout为1min。取值如果要带单位，必须为s、min、h、d。
**设置建议：**根据需求场景进行配置。如果不关心快照中的数据，希望快速生成快照，可以适当地将该参数取值调小；如果需要快照中的数据尽量完备，可以相应地将该参数取值调大。
**设置不当的风险与影响** **：**在生成快照超时的前提下，该参数取值越大，超时时间越长，会导致生成快照的时间变长，但快照内的数据更完备。
#### wdr_snapshot_interval
**参数说明：**后台线程Snapshot自动对数据库监控数据执行各项快照操作的时间间隔。
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
当且仅当[enable_wdr_snapshot]参数取值为on时，该参数设置有效。
**参数类型：**整型
**参数单位：**min（分钟）
**取值范围：**10 \~ 60
**默认值** **：**60
**设置方式：** 该参数属于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)中对应设置方法进行设置。例如，不带单位取值60，表示wdr_snapshot_interval为60min；带单位取值1h，表示wdr_snapshot_interval为1h。取值如果要带单位，必须为min、h、d。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响** **：**在固定保留天数下，该参数取值越小，磁盘占用量越大。
#### wdr_snapshot_space_threshold
**参数说明：**快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的50%时，会启用数据库的控制逻辑，使快照占用空间趋于平稳。
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 当且仅当[enable_wdr_snapshot]参数取值为on时，该参数设置有效。
- 若将该参数取值改得比当前快照占用空间要小，并不会使快照占用空间回缩，而是开启控制逻辑，控制快照增长，使快照占用空间趋于平稳。
 
**参数类型：**整型
**参数单位：**kB
**取值范围：**0 \~ 107374182400
**默认值** **：**0，表示不开启按空间阈值控制快照占用空间的功能。
**设置方式：** 该参数属于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)中对应设置方法进行设置。例如，不带单位取值1024，表示wdr_snapshot_space_threshold为1024kB；带单位取值1MB，表示wdr_snapshot_space_threshold为1MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**根据需求场景进行配置。
**设置不当的风险与影响** **：**设置不当可能导致存量快照数量仅剩最新一组快照。
#### wdr_snapshot_full_backup_interval
**参数说明：**WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔，而是间隔个数。例如，当取值为12时，每一组先生成一个全量快照，再生成11个增量快照；当取值为1时，每个快照都是全量快照。
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 当且仅当[enable_wdr_snapshot]参数取值为on时，该参数设置有效。
- 若在已经生成若干个快照的情况下，更改该参数取值，下一个快照会是全量快照。例如，WDR snapshot当前已经生成了5个增量快照，此时更改参数取值为10，那么下一个快照会为全量快照，然后开启新的周期。
- 在删除快照的时候，会遵循一组快照一起删除的规则。删除快照的数量受最早的一组快照产生时该参数的取值影响，与该参数的当前取值无关。
 
**参数类型：**整型
**参数单位：**个
**取值范围：**1 \~ 24
**默认值** **：**12
**设置方式：** 该参数属于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_asp
**参数说明：**设置是否开启活跃会话信息active session profile。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- on：打开active session profile功能。
- off：关闭active session profile功能。
**默认值** **：**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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### asp_flush_mode
**参数说明：**ASP刷新到磁盘上的方式分为写文件和写系统表，当取值为"file"时，默认写文件，为"table"时写系统表，为"all"时，即写文件也写系统表，仅sysadmin用户可以访问。
**参数类型：**字符串
**参数单位：**无
**取值范围：**当前有效值有"table"、"file"、"all"。
**默认值** **：**"table"
**设置方式：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### asp_flush_rate
**参数说明：** 当内存中样本个数达到[asp_sample_num]时，会按一定比例把内存中样本刷新到磁盘上，asp_flush_rate为刷新比例。该参数为10时表示按10:1进行刷新。
**参数类型：**整型
**参数单位：**无
**取值范围：**1 \~ 10
**默认值** **：**10
**设置方式：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**设置值过小会导致刷盘数据量变大。
#### asp_flush_interval
**参数说明：**设置ASP定时刷盘的时间间隔。
**参数类型：**整型
**参数单位：**s（秒）
**取值范围：**300 \~ 3600
**默认值** **：**300
**设置方式：** 该参数属于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)中对应设置方法进行设置。例如，不带单位取值60，表示asp_flush_interval为60s；带单位取值1min，表示asp_flush_interval为1min。取值如果要带单位，必须为s、min、h、d。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### asp_log_filename
**参数说明：**当ASP写文件时，生成文件名的格式，仅sysadmin用户可以访问。
**参数类型：**字符串
**参数单位：**无
**取值范围：**合法的文件名格式字符串。
**默认值** **：**"asp-%Y-%m-%d_%H%M%S.log"
**设置方式：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### asp_retention_days
**参数说明：**当ASP样本写到系统表时，样本保留的最大天数。
**参数类型：**整型
**参数单位：**（d）天
**取值范围：**1 \~ 7
**默认值** **：**2
**设置方式：** 该参数属于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)中对应设置方法进行设置。取值不能带单位。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**取值过大会导致系统表gs_asp占用磁盘变大。
#### asp_sample_interval
**参数说明：**每次采样的间隔。
**参数类型：**整型
**参数单位：**s（秒）
**取值范围：**1 \~ 10
**默认值** **：**1
**设置方式：** 该参数属于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)中对应设置方法进行设置。例如，不带单位取值10，表示asp_sample_interval为10s；带单位取值10s，表示asp_sample_interval为10s。取值如果要带单位，必须为s、min、h、d。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### asp_sample_num
**参数说明：**LOCAL_ACTIVE_SESSION视图的最大样本个数，仅sysadmin用户可以访问。
**参数类型：**整型
**参数单位：**无
**取值范围：**10000 \~ 100000
**默认值** **：**100000
**设置方式：** 该参数属于POSTMASTER类型参数，请参考[表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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### gs_perf_interval
**参数说明：**设置自动采集堆栈功能的采集时间间隔。
**参数类型：**整型
**参数单位：**min（分钟）
**取值范围：**0 \~ 60。0表示关闭自动采集堆栈功能。
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
若尝试设置为1-4，会自动将该参数调整到默认值5。
**默认值：**5
**设置方式：** 该参数属于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)中对应设置方法进行设置。例如，不带单位取值60，表示gs_perf_interval为60min；带单位取值1h，表示gs_perf_interval为1h。取值如果要带单位，必须为min、h、d。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### gs_perf_retention_days
**参数说明：**设置火焰图文件的保留时长。
**参数类型：**整型
**参数单位：**d（天）
**取值范围：**1 \~ 8
**默认值：**3
**设置方式：** 该参数属于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)中对应设置方法进行设置。取值不能带单位。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。