系统性能快照
enable_perf_trigger
参数说明：设置是否开启秒级CPU冲高火焰图功能。
参数类型：布尔型
参数单位：无
取值范围：
- on：打开数据库秒级CPU冲高火焰图功能。
- off：关闭数据库秒级CPU冲高火焰图功能。
默认值：on
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
perf_trigger_limit
参数说明：设置由CPU使用率冲高触发火焰图采集的阈值。当系统CPU资源占用率超过该参数取值时，会生成CPU冲高火焰图。
参数类型：整型
参数单位：%
取值范围：0 ~ 100
默认值：90
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
perf_trigger_increase
参数说明：设置由CPU使用率秒级升高触发火焰图采集的阈值。当系统CPU资源占用率相比前一秒升高的比例超过该参数取值时，会生成CPU秒级冲高火焰图。
参数类型：整型
参数单位：%
取值范围：0 ~ 100
默认值：30
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
enable_wdr_snapshot
参数说明：设置是否开启数据库监控快照功能。
参数类型：布尔型
参数单位：无
取值范围：
- on：打开数据库监控快照功能。
- off：关闭数据库监控快照功能。
默认值：on
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：不建议在以下场景打开：
- 在多表和多库的场景下，WDR snapshot会在每个库串行记录快照，记录快照时间会很长，不建议打开。
- 在多表的场景下，由于内部的一些表的性能问题，pg_stat_all_tables在多表的场景下，查询很慢，这时WDR snapshot生成速度就会很慢，所以不建议打开。
- 如果在大量DDL期间执行WDR snapshot生成操作可能会执行失败，不建议打开。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
enable_wdr_snapshot_standby
参数说明：设置分布式备机是否支持WDR功能，开启该参数后，WDR snapshot会获取备机的性能数据，并存储在主机。该参数需要在GTM FREE模式下生效，即enable_gtm_free取值为on时生效。
参数类型：布尔型
参数单位：无
取值范围：
- on：分布式备机支持WDR功能。
- off：分布式备机不支持WDR功能。
默认值：off
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
设置enable_wdr_snapshot_standby参数为on需要满足以下条件：
- wal_level参数为logical或者hot_standby。
- hot_standby参数取值为on。
- 分布式备机读的模式下gtm_option=2或者enable_gtm_free=on。
enable_show_standby_name
参数说明：设置是否开启显示区分同一分片主备机名字的功能，该名字区分主备节点。在主备DN上设置该参数，查询性能视图，视图中的node_name可以区分主备机，开启该功能后在同一分片的不同节点上查询pgxc_node_str()，返回不同的名字。
参数类型：布尔型
参数单位：无
取值范围：
- on：开启视图区分主备机名字功能。
- off：关闭视图区分主备机名字功能。
默认值：off
设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
enable_wdr_cache
参数说明：该参数的功能为，针对WDR报告后台线程调整GUC参数enable_gsstat_cache状态。当enable_wdr_cache设置为on时，WDR报告后台线程会将enable_gsstat_cache设置为on，否则设置为off。
参数类型：布尔型
参数单位：无
取值范围：
- on：将enable_gsstat_cache设置为on。
- off：将enable_gsstat_cache设置为off。
默认值：on
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：设置为默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
wdr_snapshot_retention_days
参数说明：系统中数据库监控快照数据的保留天数。当数据库运行过程期间所生成的快照数量超过保留天数内允许生成的快照数量的最大值（默认为24*8=192）时，系统将每隔wdr_snapshot_interval时间间隔，清理一次snapshot_id最小的快照数据。
参数类型：整型
参数单位：d（天）
取值范围：1 ~ 30
默认值：8
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：该参数取值越大，磁盘占用越高。
wdr_snapshot_query_timeout
参数说明：系统执行数据库监控快照操作时，设置快照操作相关的sql语句的执行超时时间。如果语句超过设置的时间没有执行完并返回结果，则本次快照操作失败，但会将已经生成的部分快照保留下来。
参数类型：整型
参数单位：s（秒）
取值范围：0 ~ 2147483647
默认值：100
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置，0表示不作超时限制。例如，不带单位取值60，表示wdr_snapshot_query_timeout为60s；带单位取值1min，表示wdr_snapshot_query_timeout为1min。取值如果要带单位，必须为s、min、h、d。
设置建议：根据需求场景进行配置。如果不关心快照中的数据，希望快速生成快照，可以适当地将该参数取值调小；如果需要快照中的数据尽量完备，可以相应地将该参数取值调大。
设置不当的风险与影响：在生成快照超时的前提下，该参数取值越大，超时时间越长，会导致生成快照的时间变长，但快照内的数据更完备。
wdr_snapshot_interval
参数说明：后台线程Snapshot自动对数据库监控数据执行各项快照操作的时间间隔。
参数类型：整型
参数单位：min（分钟）
取值范围：10 ~ 60
默认值：60
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值60，表示wdr_snapshot_interval为60min；带单位取值1h，表示wdr_snapshot_interval为1h。取值如果要带单位，必须为min、h、d。
设置建议：推荐使用默认值。
设置不当的风险与影响：在固定保留天数下，该参数取值越小，磁盘占用量越大。
wdr_snapshot_space_threshold
参数说明：快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的50%时，会启用数据库的控制逻辑，使快照占用空间趋于平稳。
- 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。
- 若将该参数取值改得比当前快照占用空间要小，并不会使快照占用空间回缩，而是开启控制逻辑，控制快照增长，使快照占用空间趋于平稳。
参数类型：整型
参数单位：kB
取值范围：0 ~ 107374182400
默认值：0，表示不开启按空间阈值控制快照占用空间的功能。
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值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时，每个快照都是全量快照。
- 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。
- 若在已经生成若干个快照的情况下，更改该参数取值，下一个快照会是全量快照。例如，WDR snapshot当前已经生成了5个增量快照，此时更改参数取值为10，那么下一个快照会为全量快照，然后开启新的周期。
- 在删除快照的时候，会遵循一组快照一起删除的规则。删除快照的数量受最早的一组快照产生时该参数的取值影响，与该参数的当前取值无关。
参数类型：整型
参数单位：个
取值范围：1 ~ 24
默认值：12
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：根据需求场景进行配置。
设置不当的风险与影响：该参数取值越小，全量快照越多，同样空间占用下能保留的总快照数量越少。
enable_asp
参数说明：设置是否开启ASP（Active Session Profile，活跃会话报告）功能。
参数类型：布尔型
参数单位：无
取值范围：
- on：打开ASP功能。
- off：关闭ASP功能。
默认值：on
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
enable_asp_standby
参数说明：设置是否开启ASP支持备机功能。开启该功能后，ASP报告进行采样时，会同步获取备机的采集数据。
参数类型：布尔型
参数单位：无
取值范围：
- on：开启ASP支持备机功能，ASP获取所有备机上的采集数据。
- off：关闭ASP支持备机功能。
默认值：on
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
asp_flush_mode
参数说明：ASP刷新到磁盘上的方式分为写文件和写系统表，当取值为“file”时，默认写文件，为“table”时写系统表，为“all”时，即写文件也写系统表，仅sysadmin用户可以访问。
参数类型：字符串
参数单位：无
取值范围：当前有效值有“table”、“file”、“all”。
默认值："table"
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
asp_flush_rate
参数说明：当内存中样本个数达到asp_sample_num时，会按一定比例把内存中样本刷新到磁盘上，asp_flush_rate为刷新比例。该参数为10时表示按10:1进行刷新。
参数类型：整型
参数单位：无
取值范围：1 ~ 10
默认值：10
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置值过小会导致刷盘数据量变大。
asp_flush_interval
参数说明：设置ASP定时刷盘的时间间隔。
参数类型：整型
参数单位：s（秒）
取值范围：300 ~ 3600
默认值：300
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值60，表示asp_flush_interval为60s；带单位取值1min，表示asp_flush_interval为1min。取值如果要带单位，必须为s、min、h。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
asp_log_filename
参数说明：当ASP写文件时，生成文件名的格式，仅sysadmin用户可以访问。
参数类型：字符串
参数单位：无
取值范围：合法的文件名格式字符串。
默认值："asp-%Y-%m-%d_%H%M%S.log"
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
asp_retention_days
参数说明：当ASP样本写到系统表时，样本保留的最大天数。
参数类型：整型
参数单位：d（天）
取值范围：1 ~ 7
默认值：2
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：取值过大会导致系统表gs_asp占用磁盘变大。
asp_sample_interval
参数说明：每次采样的间隔。
参数类型：整型
参数单位：s（秒）
取值范围：1 ~ 10
默认值：1
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值10，表示asp_sample_interval为10s；带单位取值10s，表示asp_sample_interval为10s。取值如果要带单位，必须为s。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
asp_sample_num
参数说明：LOCAL_ACTIVE_SESSION视图的最大样本个数，仅sysadmin用户可以访问。
参数类型：整型
参数单位：无
取值范围：10000 ~ 100000
默认值：100000
设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
asp_log_directory
参数说明：asp_flush_mode设置为all或者file时，asp_log_directory决定存放服务器asp日志文件的目录。它可以是绝对路径，或者是相对路径（相对于数据目录的路径），仅sysadmin用户可以访问。
- 合法路径：用户对此路径有读写权限。
- 非法路径：用户对此路径无读写权限。
参数类型：字符串
参数单位：无
取值范围：合法目录路径。
默认值：安装时指定。
设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。
设置建议：请在充分测试验证后进行设置。
设置不当的风险与影响：当配置文件中asp_log_directory的值为非法路径时，会导致集群无法重新启动。
gs_perf_interval
参数说明：设置自动采集堆栈功能的采集时间间隔。
参数类型：浮点型
参数单位：min（分钟）
取值范围：0 ~ 60。0表示关闭自动采集堆栈功能。
有效值为0.2 ~ 60，若尝试设置为小于0.2的非0值，会自动将该参数调整到默认值5。
默认值：5
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值60，表示gs_perf_interval为60min；带单位取值1h，表示gs_perf_interval为1h。取值如果要带单位，必须为min、h、d。
设置建议：推荐使用默认值。
设置不当的风险与影响：若参数设置过小，会导致采集频率较高，对系统性能可能有一定影响，且日志数量较多，会占用大量存储空间。请在充分理解参数含义，并经过测试验证后进行修改。
gs_perf_deploy_mode
参数说明：获取gs_perf_service采集进程部署状态。
参数类型：字符串
参数单位：无
取值范围："ROOT"、"DBUSER"、"DISABLE"
- "ROOT"：采集进程部署为ROOT状态，支持所有的火焰图采集功能。
- "DBUSER"：采集进程部署为DBUSER状态，只支持oncpu相关的火焰图采集功能。
- "DISABLE"：采集进程部署为DISABLE状态，不提供火焰图功能。
默认值："ROOT"
设置方式：该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。
设置建议：该参数不允许用户进行设置，只能查看。
设置不当的风险与影响：无
gs_perf_freq
参数说明：设置自动采集堆栈功能的采集频率。
参数类型：整型
参数单位：Hz
取值范围：10 ~ 1000
默认值：999
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
gs_perf_retention_days
参数说明：设置火焰图文件的保留时长。
参数类型：整型
参数单位：d（天）
取值范围：1 ~ 8
默认值：3
设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。
