[转帖]3.3.7. 自动诊断和建议报告SYS

https://help.kingbase.com.cn/v8/perfor/performance-optimization/performance-optimization-6.html#sys-ksh

KDDM 是 KingbaseES 性能自动诊断和建议的报告。它基于 KWR 快照采集的性能指标和数据库时间模型（DB Time），自动分析等待事件、IO、网络、内存和 SQL 执行时间等，给出一系列性能优化建议。通过 KDDM 报告，能够实现数据库性能的快速调优。

KDDM 存在于 KWR 插件里，和 KWR 一起对外提供服务。

目前 KDDM 报告仅支持 TEXT 格式，不支持 HTML 格式输出。

3.3.7.1. 快速生成 KDDM 报告 ¶

通过 KWR 自动快照或者手动快照创建一系列 KWR 快照，然后就可以通过 perf.kddm_report({snap_1}, {snap_2}) 来创建 KDDM 报告：

CREATE EXTENSION sys_kwr;

SELECT * FROM perf.create_snapshot();

INSERT INTO t1 SELECT generate_series(1, 1000000);

SELECT * FROM perf.create_snapshot();

SELECT * FROM perf.kddm_report(1,2);

生成的报告如下：

SELECT * FROM perf.kddm_report(1,2);

3.3.7.2. 使用 KDDM ¶

3.3.7.2.1. 配置 GUC 参数 ¶

sys_kwr.language：指定 KDDM 报告输出的语言，TEXT类型，有效的值：'english'/'eng'/'chinese'/'chn'，默认 'chinese'，即按中文显示报告。

说明：KDDM 报告依赖 KWR 快照，关于KWR快照部分 GUC 参数，请参考 KWR 相关章节。

3.3.7.2.2. 生成KDDM报告 ¶

生成 kddm 报告

SELECT * FROM perf.kddm_report(1, 2);

说明：KDDM 报告也会自动在数据库服务器 DATA 目录的 sys_log 下保存一份。

生成 kddm 报告并保存到指定文件

SELECT * FROM perf.kddm_report_to_file(1, 2, '/home/test/kddm_1_2.txt');

为指定 query id 的 SQL 语句生成 SQL 报告

SELECT * FROM perf.kddm_sql_report(1, 2, 5473583404117387630);

根据快照范围和具体的 SQL ID，给出 SQL 详细报告，主要用于分析耗时较多的 SQL 语句占用的 CPU，IO 资源的使用情况。

3.3.7.3. KDDM 报告 ¶

kddm 报告根据 KWR 快照内容，给出以下的建议和报告：

数据库时间分解报告
CPU 相关建议
- TOP SQL 建议
- 使用扩展 SQL 协议建议
- CPU 负载高建议
- 优化回滚事务建议
- 优化堆页面裁剪建议
- 使用索引建议
等待事件相关建议
- TOP 等待事件建议
- LWLock 类等待事件建议
- IO 类等待事件建议
- Client 类等待建议
完整 SQL 列表

每条具体建议包含三项内容：

建议依据：描述了数据库当前存在的性能问题。
建议动作：按优先级给出性能优化的建议操作，通过指定的操作选项能够改善当前存在的性能问题。
参考信息：描述了当前性能问题的具体指标。

示例报告：TOP SQL 建议

该报告展示可以通过 TOP SQL 找到消耗资源最多的SQL语句，当设置成如下配置参数时，对外提供树状结构显示 TOP SQL 的报告。

sys_stat_statements.track = 'all'

示例报告：使用索引建议

该报告展示可以通过使用索引来提高 SQL 性能的建议，不仅给出了具体的 SQL 语句，还会给出创建索引的 DDL 语句，以及预期收益率。

该报告也给出了存在但未被使用的索引，DBA 可以根据实际情况进一步操作。

合理的索引使用可以加速检索过程。

3.3.7.4. GUC 参数建议 ¶

KDDM 提供 GUC 参数建议功能，根据数据库服务器的硬件情况和用户指定的业务类型，显示建议结果：

SELECT * FROM perf.kddm_guc_advisor();

--最大连接数：300，使用默认值

--CPU核心数：96，自动获取

--总物理内存：256 GB，自动获取

--应用类型：OLTP，使用默认值

--建议参数列表：

max_connections = 300

shared_buffers = 64GB

effective_cache_size = 192GB

maintenance_work_mem = 2GB

work_mem = 55MB

wal_buffers = 16MB

min_wal_size = 1GB

max_wal_size = 4GB

max_worker_processes = 24

max_parallel_workers_per_gather = 4

max_parallel_workers = 24

max_parallel_maintenance_workers = 4

可以通过制定最大连接数、CPU 核心数、内存大小、业务类型等参数来定制化 GUC 参数建议列表，函数的声明如下：

TEXT perf.kddm_guc_advisor(

   IN conn bigint = 0,

   IN service_type TEXT = 'oltp',

   IN cpu bigint = 0,

   IN memory bigint = 0);

参数说明：

conn：最大连接数，默认300，范围：1-1000
cpu：CPU 核心数，默认自动获取，范围：1-1000
memory：内存大小，单位为 MB，默认自动获取，范围：128MB - 1T
service_type：业务类型，默认为 ’oltp’，可选范围：
- oltp：事务型数据库服务器
- olap：分析性数据库服务器
- web：Web服务器
- desktop：桌面应用
- mixed：混合应用