openGauss DataKit ：智能诊断（2）

使用指导

概述

智能诊断插件主要有安装部署、慢SQL、SQL诊断和历史数据诊断功能。

1. 安装部署主要包括代理的安装、卸载、启动、停止和状态监控功能。代理需要部署在对应的数据库服务器，且需要通过root用户进行安装。

2. 慢SQL主要包括慢SQL查询和慢SQL诊断功能，对纳入平台管理的集群/实例下的数据库中的历史慢SQL记录进行查询以及诊断操作。

3. SQL诊断主要包括创建诊断任务、查询诊断任务、查看诊断详情、删除诊断任务以及设置阈值功能。SQL诊断插件依赖本插件代理的部署，没有部署代理时，只会对执行计划相关的诊断项进行分析。SQL诊断插件可以通过慢SQL创建诊断任务，也可以通过自定义创建诊断任务。创建诊断任务后才可以查看和删除诊断任务，诊断任务运行完成后才可以查看诊断结果的详情信息。

4. 历史数据诊断主要包括发起诊断、查看诊断详情以及设置阈值的功能。历史数据诊断不依赖本插件代理的部署，但会依赖实例监控插件服务端的部署，实例监控插件没有部署服务端时，历史指标数据相关的诊断项会分析异常。发起诊断之后，等待诊断完成才可以查看诊断结果的详情信息。

部署代理

安装代理

1. 登录一体化平台，点击【智能运维】下【SQL诊断】菜单进入SQL诊断首页。

   

2. 在首页点击【安装代理】按钮，弹出安装代理窗口。

   

3. 选择对应数据库实例，输入Root密码，点击【一键部署】按钮开始安装，点击【取消】按钮可取消安装。

   说明： 所有必选参数均需要填写。必填参数用星号（*）标识。

   配置项	必填	组件形式	配置说明
   采集实例	是	下拉框	平台纳入管理的集群/实例
   Root用户密码	是	文本输入框	部署实例的服务器Root用户密码
   代理端口	是	文本输入框	安装代理的端口号，默认为2321，非法输入会出现异常
   回调路径	是	文本输入框	平台的地址，代理回传数据时调用平台Api接口，有默认值
   安装目录	是	文本输入框	代理安装在服务器上的绝对路径，有默认值

   

4. 点击完【一键部署】按钮后，会弹出安装过程窗口，安装完成后，可以点击【返回】按钮，跳转到安装代理窗口，点击【取消】关闭安装窗口。

   说明：

   安装过程中会涉及到如下操作：

   1. 检测数据库实例是否存在，不存在会提示异常信息；

   2. 检测安装目录是否为空，不为空会提示异常信息；

   3. 检测端口是否被占用，被占用会提示异常信息；

   4. 检测python环境是否存在，不存在会提示异常信息；

   5. 检测java版本是否大于1.8，不存在会在线下载，无法连接外网会提示异常信息；

   6. 检测bcc是否安装，没安装会在线下载，无法连接外网会提示异常信息；

   7. SSH上传代理jar包、FlameGraph工具、启动脚本。

   

5. 在安装过程界面中可以查看安装异常信息。

   

6. 安装代理完成后，会在【已安装代理】TAB中新增一条数据。

查看已安装代理

安装完成后，即可在【已安装代理】TAB中看到对应代理的信息。

说明：

1. 默认展示集群名称，点击【集群名称】可查看集群下已安装代理的实例；

2. 安装成功会在实例前显示绿色圆点，表示代理正在运行中，且状态健康；

3. 运行中的代理可以停止以及卸载。

   

停止代理

1. 在【已安装代理】TAB中，当鼠标悬停在实例上时，可以看到实例后有【停止】以及【卸载】按钮，点击【停止】按钮会在实例前显示蓝色圆点，表示代理正在停止中。

   说明： 仅能停止运行状态健康的代理。

   

2. 停止成功会在实例前显示黄色圆点，表示代理已经停止。

   

3. 停止失败在实例前显示绿色圆点以及红色感叹号，表示代理停止异常，当鼠标悬停在红色感叹上可以看到异常信息。

   

启动代理

1. 在【已安装代理】TAB中，当当鼠标悬停在实例上时，可以看到实例后有【启动】以及【卸载】按钮，点击【启动】按钮会在实例前显示蓝色圆点，表示代理正在启动中。

   说明： 仅能启动运行状态不健康的代理。

   

2. 启动成功会在实例前显示绿色圆点，表示代理已经启动。

   

3. 启动失败在实例前显示黄色圆点以及红色感叹号，表示代理启动异常，当鼠标悬停在红色感叹上可以看到异常信息。

   

卸载代理

1. 在【已安装代理】TAB中，当鼠标悬停在实例上时，可以看到实例后有【卸载】按钮，点击【卸载】按钮，弹出卸载窗口。

   

2. 输入Root密码，点击【一键卸载】按钮，开始卸载操作，点击【取消】按钮，关闭卸载窗口。

   说明： 所有必选参数均需要填写。必填参数用星号（*）标识。

   配置项	必填	组件形式	配置说明
   采集实例	是	下拉框	平台纳入管理的集群/实例
   Root用户密码	是	文本输入框	部署实例的服务器Root用户密码

   注： 卸载过程不可逆，卸载完成后将会清除该代理所有有关的数据（不影响SQL诊断历史诊断数据），请谨慎卸载！

   

3. 点击【一键卸载】按钮后，会弹出卸载过程窗口，卸载完成后，可以点击【返回】按钮，跳转到卸载代理窗口，点击【取消】关闭卸载窗口。

   

4. 在卸载过程窗口可以查看卸载异常信息。

   

5. 卸载代理完成后，会在【已安装代理】TAB中删除一条数据。

状态监控

通过定时器每隔1分钟检测采集代理的运行状态。