模板性能分析插件

1.1 版本

1.2 应用场景

预览模板时，有时会出现耗时较长的情况。此时模板设计人员希望了解模板预览过程中哪些功能或数据集耗时较长，哪个部分出现性能问题，通过安装「模板性能分析」插件可帮助定位模板的耗时分布。

1.3 功能简介

「模板性能分析」插件可通过执行模板并对模板执行过程进行记录分析，给出详细的报告，帮助定位模板的耗时分布。

「模板性能分析」插件适用范围如下：

• 目前仅支持范围：未开行式引擎的 CPT 模板、旧版 FRM 模板。

• 聚合报表暂不支持、图表耗时暂不纳入统计。

• 多 sheet 报表支持分析但暂未拆分 sheet 关系，不同 sheet 间单元格耗时会相加。

• 如果需要在远程设计情况下进行分析，需要服务器及设计器都安装插件。

• 不支持移动端。

2.1 安装插件

点击下载插件：模板性能分析

设计器插件安装方法请参见 ：设计器插件管理

服务器安装插件方法请参见：服务器插件管理

2.2 界面介绍

2.2.1 设计器界面

安装插件后，设计器内新增分析图标。如下图所示：

2.2.2 平台界面

安装插件后，平台新增「执行检测」管理系统节点。如下图所示：

3.1 设计器中插件使用方法

1）打开需要分析的报表，点击分析图标，如下图所示：

2）进入报表的性能分析模式，此时可正常进行预览查询操作。查询完成后点击「点击完成分析」按钮，将在新标签页打开分析结果。如下图所示：

3.2 平台中插件使用方法

1）以管理员身份进入数据决策系统，点击「管理系统>执行检测」，选择预览方式和模板，如下图所示：

2）点击「添加检测任务」，点击「确定」，将在新标签页进入报表的性能分析模式，此时可正常进行预览查询操作。如下图所示：

3）点击「点击完成分析」按钮，将在新标签页打开分析结果。如下图所示：

注：如服务器中部分功能尚未使用可能出现服务器状态显示「警告，部分检测点未生效」，此时可正常分析，不受影响。

报告包括：模板信息、取数耗时、计算耗时三部分。

4.1 模板信息

由模板访问时间、模板名称、模板查询参数、和模板总耗时（不包含前端渲染耗时）四部分组成。如下图所示：

注意：模板总耗时，是将每个请求的耗时累计起来，而非所有请求在某段时间内的总耗时。

例：在 5s 内发送 300 个请求，每个请求花费 1s 计算完成，并且所有请求都在这 5s 内返回并展示。

       那么总耗时接近 300s 而不是 5s 。

4.2 取数耗时

包含模板中各个数据集、SQL 公式等 SQL 取数的耗时统计。如下图所示：

CPT：

FRM：

4.3 计算耗时

从报表单元格（扩展前单元格）和对应功能两个维度展示耗时情况，可点击表头进行排序，找到耗时最多的单元格（此部分当前在frm中不准确，请勿参考）。如下图所示：

• -1ms 代表未包含相关计算设置，部分没有设置相应功能的格子也可能出现较小的耗时（几 ms ），如超级链接，通常是计算时执行对应的判断逻辑花费的微小时间。

• 其中单元格计算耗时包括分组计算、汇总计算、单元格公式、排序、过滤、结果集筛选六列的耗时，以及部分其他耗时（如单元格数据填充）。

• 由于目前报表计算顺序是从上到下，从左到右，如果出现上/左侧的格子计算需要基于下/右侧格子数据的情况，如 A2 格子内容为 SUM(A3) ，A2 的单元格计算时间目前会包含 A3 单元格的计算时间。

• 离线模板分析报告：可以使用浏览器右键保存功能保存 html 至本地，变成离线报告，后续可以直接使用浏览器打开对应的 html 文件进行查看。