摘要

WDR(Workload Diagnosis Report)负载诊断报告，是 openGauss 的工作负载诊断报告，常用于判断 openGauss 长期性能问题。WDR 报告基于两次不同时间点系统的性能快照数据，生成这两个时间点之间的性能表现报表。

开启 WDR 快照

参数简介

enable_wdr_snapshot

参数说明: 是否开启数据库监控快照功能。

该参数属于 SIGHUP 类型参数，请参考表GUC 参数分类中对应设置方法进行设置。

取值范围: 布尔型

  • on: 打开数据库监控快照功能。
  • off: 关闭数据库监控快照功能。

默认值: off

wdr_snapshot_retention_days

参数说明: 系统中数据库监控快照数据的保留天数，超过设置的值之后，系统每隔 wdr_snapshot_interval 时间间隔，清理 snapshot_id 最小的快照数据。

该参数属于 SIGHUP 类型参数，请参考表GUC 参数分类中对应设置方法进行设置。

**取值范围:**整型，1 ～ 8。

默认值: 8

wdr_snapshot_query_timeout

参数说明: 系统执行数据库监控快照操作时，设置快照操作相关的 sql 语句的执行超时时间。如果语句超过设置的时间没有执行完并返回结果，则本次快照操作失败。

该参数属于 SIGHUP 类型参数，请参考表GUC 参数分类中对应设置方法进行设置。

**取值范围:**整型，100 ～ INT_MAX（秒）。

默认值: 100s

wdr_snapshot_interval

参数说明: 后台线程 Snapshot 自动对数据库监控数据执行快照操作的时间间隔。

该参数属于 SIGHUP 类型参数，请参考表GUC 参数分类中对应设置方法进行设置。

**取值范围:**整型，10 ～ 60（分钟）。

默认值: 1h

查看当前 wdr 相关配置

postgres@omm:local=#select name, setting from pg_settings where name like '%wdr%';
            name             | setting
-----------------------------+---------
 enable_wdr_snapshot         | off
 wdr_snapshot_interval       | 60
 wdr_snapshot_query_timeout  | 100
 wdr_snapshot_retention_days | 8
(4 rows)

开启 wdr 日志

omm@107707f966f0:/var/lib/mogdb/data$ gs_guc reload -D $PGDATA -c "enable_wdr_snapshot=on"
expected instance path: [/var/lib/mogdb/data/postgresql.conf]
gs_guc reload: enable_wdr_snapshot=on: [/var/lib/mogdb/data/postgresql.conf]
server signaled

Total instances: 1. Failed instances: 0.
Success to perform gs_guc!

omm@107707f966f0:/var/lib/mogdb/data$ gsql -d postgres -r
gsql ((MogDB 2.1.1 build b5f25b20) compiled at 2022-03-21 14:42:30 commit 0 last mr  )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.

postgres@omm:local=#select name, setting from pg_settings where name like '%wdr%';
            name             | setting
-----------------------------+---------
 enable_wdr_snapshot         | on
 wdr_snapshot_interval       | 60
 wdr_snapshot_query_timeout  | 100
 wdr_snapshot_retention_days | 8
(4 rows)

查看快照统计表

postgres@omm:local=#show search_path;
  search_path
----------------
 "$user",public
(1 row)

postgres@omm:local=#alter session set search_path=snapshot;
SET
postgres@omm:local=#show search_path;
 search_path
-------------
 snapshot
(1 row)

postgres@omm:local=#\d
                                             List of relations
  Schema  |                   Name                   |   Type   | Owner |             Storage
----------+------------------------------------------+----------+-------+----------------------------------
 snapshot | snap_class_vital_info                    | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_bgwriter_stat                | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_ckpt_status                  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_config_settings              | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_double_write_status          | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_file_iostat                  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_file_redo_iostat             | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_instance_time                | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_memory_node_detail           | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_os_runtime                   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_os_threads                   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_pagewriter_status            | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_record_reset_time            | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_recovery_status              | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_redo_status                  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_rel_iostat                   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_replication_slots            | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_replication_stat             | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_rto_status                   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_shared_memory_detail         | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_stat_all_indexes             | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_stat_all_tables              | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_stat_bad_block               | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_stat_database                | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_stat_database_conflicts      | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_stat_db_cu                   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_stat_user_functions          | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_statement_count              | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_statio_all_indexes           | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_statio_all_sequences         | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_statio_all_tables            | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_thread_wait_status           | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_threadpool_status            | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_transactions_prepared_xacts  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_transactions_running_xacts   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_wait_events                  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_global_workload_transaction         | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_seq                                 | sequence | omm   |
 snapshot | snap_statement_responsetime_percentile   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_file_iostat                 | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_file_redo_iostat            | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_rel_iostat                  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_stat_all_indexes            | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_stat_all_tables             | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_stat_bad_block              | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_stat_database               | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_stat_database_conflicts     | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_stat_user_functions         | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_statement                   | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_statement_count             | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_statio_all_indexes          | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_statio_all_sequences        | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_statio_all_tables           | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_transactions_prepared_xacts | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_transactions_running_xacts  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_user_login                  | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_workload_sql_count          | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_workload_sql_elapse_time    | table    | omm   | {orientation=row,compression=no}
 snapshot | snap_summary_workload_transaction        | table    | omm   | {orientation=row,compression=no}
 snapshot | snapshot                                 | table    | omm   | {orientation=row,compression=no}
 snapshot | tables_snap_timestamp                    | table    | omm   | {orientation=row,compression=no}
(61 rows)

手动生产快照

SNAPSHOT.SNAPSHOT

SNAPSHOT 表记录当前系统中存储的 WDR 快照数据的索引信息、开始、结束时间。只能在系统库中查询到结果，在用户库中无法查询。

表 1 SNAPSHOT 表属性

名称

类型

描述

示例

snapshot_id

bigint

WDR 快照序号。

1

start_ts

timestamp

WDR 快照的开始时间。

2019-12-28 17:11:27.423742+08

end_ts

timestamp

WDR 快照的结束时间。

2019-12-28 17:11:43.67726+08

postgres@omm:local=#select * from snapshot.snapshot;
 snapshot_id |           start_ts            |            end_ts
-------------+-------------------------------+-------------------------------
           1 | 2022-05-02 11:19:37.239977+00 | 2022-05-02 11:19:37.865708+00
(1 row)

postgres@omm:local=#select create_wdr_snapshot();
           create_wdr_snapshot
-----------------------------------------
 WDR snapshot request has been submitted
(1 row)

postgres@omm:local=#select * from snapshot.snapshot;
 snapshot_id |           start_ts            |            end_ts
-------------+-------------------------------+-------------------------------
           1 | 2022-05-02 11:19:37.239977+00 | 2022-05-02 11:19:37.865708+00
           2 | 2022-05-02 11:42:28.047396+00 | 2022-05-02 11:42:28.617173+00
(2 rows)

生成性能报告

a. 执行如下命令生成格式化性能报告文件。

\a \t \o 服务器文件路径

上述命令涉及参数说明如下:

  • \a: 切换非对齐模式。
  • \t: 切换输出的字段名的信息和行计数脚注。
  • \o: 把所有的查询结果发送至服务器文件里。
  • 服务器文件路径：生成性能报告文件存放路径。用户需要拥有此路径的读写权限。

b. 执行如下命令将查询到的信息写入性能报告中。

select generate_wdr_report(begin_snap_id bigint, end_snap_id bigint, report_type cstring, report_scope cstring, node_name cstring);

命令中涉及的参数说明如下。

表 3 generate_wdr_report 函数参数说明

参数

说明

取值范围

begin_snap_id

查询时间段开始的 snapshot 的 id（表 snapshot.snaoshot 中的 snapshot_id）。

-

end_snap_id

查询时间段结束 snapshot 的 id。默认 end_snap_id 大于 begin_snap_id（表 snapshot.snaoshot 中的 snapshot_id）。

-

report_type

指定生成 report 的类型。例如，summary/detail/all。

summary: 汇总数据。

detail: 明细数据。 all: 包含 summary 和 detail。 | | report_scope | 指定生成 report 的范围，可以为 cluster 或者 node。 | cluster: 数据库级别的信息。 node: 节点级别的信息。 | | node_name | 在 report_scope 指定为 node 时，需要把该参数指定为对应节点的名称。(节点名称可以执行 select * from pg_node_env;查询)。在 report_scope 为 cluster 时，该值可以指定为省略、空或者为 NULL。 |   |

执行操作

postgres@omm:local=#select * from pg_node_env;
 node_name |   host    | process | port |   installpath    |      datapath       | log_directory
-----------+-----------+---------+------+------------------+---------------------+---------------
 mogdb     | localhost |       1 | 5432 | /usr/local/mogdb | /var/lib/mogdb/data | pg_log
(1 row)
postgres@omm:local=#
postgres@omm:local=#\a \t \o wdr_20220502.html
postgres@omm:local=#select generate_wdr_report(1,2,'all','node','mogdb');

c.执行如下命令关闭输出选项及格式化输出命令。

\o \a \t

查看报告

openGauss/MogDB WDR报告详解_opengauss

openGauss/MogDB WDR报告详解_ios_02