1. 概述
1.1 版本
| FineBI 版本 | JAR 包 | FineBI 直连性能分析插件 | 新增功能 |
|---|---|---|---|
| 5.1.11 | 2021-04-02 | V1.0.0 | - |
| 5.1.12 | - | V1.1.0 | 增加性能反馈功能 |
| 5.1.13 | - | V1.2.0 | 「系统管理>常规」下新增内存加速引擎和仪表板编辑加速按钮 |
| 5.1.14 | - | V1.3.0 | - |
| 5.1.15 | - | V1.4.0 | - |
| 5.1.16 | - | V1.5.0 | 插件版本跟随 JAR 更新 |
注：5.1.18 及之后版本，「内存加速引擎」和「仪表板编辑加速」按钮挪到「系统管理>缓存」下，且无需安装插件即有这两个按钮（按钮与插件无关）。
1.2 应用场景
用户遇到下面问题时：
做自助数据集时发现某个步骤较慢
预览自助数据集时发现某个步骤较慢
预览仪表板时发现比较慢
编辑组件时发现比较慢
不知道原因是什么，反复检查后仍不能找出问题所在，检查时甚至可能导致服务器崩溃。「FineBI 直连性能分析插件」可更方便的反馈和定位性能问题。
1.3 功能简介
「FineBI 直连性能分析插件」有助于让用户更快更方便的反馈和定位仪表板预览、编辑、以及自助数据集编辑过程中的性能问题。
注：该插件仅支持实时数据下的性能分析，不支持抽取数据。
2. 操作步骤
2.1 安装插件
本文 1.1 节的 FineBI 版本中自带 FineBI 直连性能分析插件，用户升级 JAR 即可。
注：该插件默认为禁用状态，启用 即可。
2.2 性能分析入口
「性能分析」入口如下表所示：
| 仪表板 |
|
|---|---|
| 编辑自助数据集 | 编辑自助数据集时，界面中有「性能分析」按钮 |
「性能分析」按钮示例如下图所示：
2.3 核心信息
「核心信息」可帮助用户初步判断出现性能问题的原因。
点击「性能分析」按钮后，核心信息页面如下图所示：
「核心信息」表字段介绍如下表所示：
| 数据列名称 | 说明 |
|---|---|
| 用户 | 触发性能检测的用户 |
| 一级资源名称 | 仪表板名称，数据集名称 |
| 二级资源名称 | 组件名称，步骤名称 |
| 查询ID | 本次查询的唯一编号 |
| 查询等待时间 | 从用户点击查询到进入查询准备阶段的时间 |
| 查询准备阶段 | 查询的执行计划解析，生成 SQL 的阶段 |
| SQL执行时间 | 数据库执行时间或直连引擎执行时间 |
| 数据传输时间 | 数据库的查询结果返回给 BI 的时间，若直连引擎自己计算，则没有该时间 |
| 内存计算时间 | 所有 BI 代码的计算时间 |
| 前端渲染时间 | 后端计算完毕之后，前端用于展示的时间 |
| 总查询时间 | 从用户点击查询到前端加载完成的总时间 |
| 查询开始时间 | 用户触发性能检测的时间 |
2.4 详细信息
「详细信息」可帮助用户进一步确认出现性能问题的原因和了解下一步的处理方式。
点击「导出详细信息」按钮，将自动导出表格。表格内容如下图所示：
「详细信息」表字段介绍如下表所示：
| 数据列名称 | 说明 |
|---|---|
| 用户 | 触发性能检测的用户 |
| 一级资源名称 | 仪表板名称，数据集名称 |
| 二级资源名称 | 组件名称，步骤名称 |
| 组件类型 | 1-分组表 2-交叉表 3-明细表 4-图表 5-自助数据集 6-筛选控件 7-文本组件 |
| 查询ID | 本次查询的唯一编号 |
| 执行阶段 | 1）查询等待 因为浏览器的限制导致查询之前需要排队 2）查询准备
3）SQL 执行
4）数据传输 数据库返回的结果传给 BI 服务器花的时间 5）内存计算 直连引擎计算的时间 6）等待结束 等待结束阶段（把仪表的所有组件都打包成一个请求时会有该数据），最先出来的组件要等到最后出来的组件的等待时间 7）前端渲染
|
| 片段ID | 一次查询有可能会有多个查询请求，如 创建数据连接，SQL 执行，数据传输都可能再被拆分成多个请求，需要分别统计考量 |
| 耗时（ms） | 该阶段有统计时间则记录该阶段的耗时 |
| 片段内容 | 创建数据连接阶段记录数据连接名 SQL 执行阶段记录执行的 SQL ，SQL 超过 3w 字符的，导出的文件会生成两个 sheet ，包含详细信息和超出 3w 字符的 SQL 如果有临时表注入逻辑，查询 SQL 前面会有，excel insert cost xxx | selcet * ....这样的标识符 |
| 返回结果集行数 | 数据传输阶段，内存计算阶段，前端渲染阶段都需要记录 |
| 返回结果集列数 | 数据传输阶段，内存计算阶段，前端渲染阶段都需要记录 |
| 执行引擎类型 | 1-SQL 引擎 2-csv 引擎（代表Excel数据集和服务器数据集） 3-内存引擎 |
| 开始时间 | 「执行阶段」的开始时间 |
| 结束时间 | 「执行阶段」阶段的结束时间 |
| 异常信息 | 当某个阶段出现错误时，打印报错信息 |
2.5 性能反馈
1）用户发现模板问题后，可点击「性能分析>性能反馈」按钮，将模板性能反馈给管理员。如下图所示：
2）超管收到性能反馈消息提示，如下图所示：
3. 插件相关按钮介绍
BI 版本大于等于 5.1.13 且小于 5.1.18 时，「系统管理>常规」下新增内存加速引擎和仪表板编辑加速按钮；5.1.18 及之后版本，这两个按钮被挪到「系统管理>缓存」下，且无需安装插件即有这两个按钮（按钮与插件无关）。按钮具体介绍请参见：缓存 文档的 2.3、2.4 节内容。
