AI4DB: 慢SQL根因分析

概述

慢SQL一直是数据运维中的痛点问题，如何有效诊断慢SQL根因是当前一大难题，工具结合openGauss自身特点融合了现网DBA慢SQL诊断经验，该工具可以支持慢SQL根因15+，能同时按照可能性大小输出多个根因并提供针对性的建议。

环境部署

• 数据库运行正常。
• 指标采集系统运行正常。

使用指导

假设用户已经初始化配置文件目录confpath，则可以通过下述命令实现本特性的功能：

• 仅启动慢SQL诊断功能（输出Top3根因），启动命令如下（更多用法参考对service子命令的说明）：

gs_dbmind service start -c confpath --only-run slow_query_diagnosis

• 用户交互式慢SQL诊断，命令如下：

gs_dbmind component slow_query_diagnosis show -c confpath --query SQL --start-time timestamps0 --end-time timestamps1

• 用户手动清理历史预测结果，命令如下：

gs_dbmind component slow_query_diagnosis clean -c confpath --retention-days DAYS

• 停止已启动的服务，命令如下：

gs_dbmind service stop -c confpath

获取帮助

模块命令行说明：

gs_dbmind component slow_query_diagnosis --help

usage:  [-h] -c DIRECTORY [--query SLOW_QUERY]
        [--start-time TIMESTAMP_IN_MICROSECONDS]
        [--end-time TIMESTAMP_IN_MICROSECONDS] [--retention-days DAYS]
        {show,clean}

Slow Query Diagnosis: Analyse the root cause of slow query

positional arguments:
  {show,clean}          choose a functionality to perform

optional arguments:
  -h, --help            show this help message and exit
  -c DIRECTORY, --conf DIRECTORY
                        set the directory of configuration files
  --query SLOW_QUERY    set a slow query you want to retrieve
  --start-time TIMESTAMP_IN_MICROSECONDS
                        set the start time of a slow SQL diagnosis result to
                        be retrieved
  --end-time TIMESTAMP_IN_MICROSECONDS
                        set the end time of a slow SQL diagnosis result to be
                        retrieved
  --retention-days DAYS
                        clear historical diagnosis results and set the maximum
                        number of days to retain data

命令参考

参数	参数说明	取值范围
-h, –help	帮助命令	-
action	动作参数	show：结果展示，clean：清理结果
-c，–conf	配置目录	-
–query	慢SQL文本	*
–start-time	显示开始时间的时间戳，单位毫秒	非负整数
–end-time	显示结束时间的时间戳，单位毫秒	非负整数
–retention-days	清理天数级结果	非负实数

常见问题处理

• 如果用户对没有执行过的慢SQL执行交互式诊断命令，则无法给出诊断结果。
• exporter指标采集功能没有启动时运行慢SQL诊断功能，此时功能无法正常运行。
• 配置文件中的参数重新设置后，需要重新启动服务进程才能生效。