1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V2.15.0 | - |
| V2.33.0 | 1）原「模板性能」标签页更名为「业务性能」 2）拆分「FR模板性能」与「BI模板性能」页面 |
| V2.34.0 | 1）优化「性能设置」配置，对单项目的单类型业务性能生效 2）扩充性能观察指标，全面掌握模板访问情况与性能状态 |
| V2.36.0 | FineBI 模板性能明细指标调整，指标口径与仪表板计算逻辑对齐 |
| V2.38.0 | 交互优化，排查性能问题时支持自动带参跳转，提升排查效率 |
1.2 应用场景
BI 模板性能功能是运维平台提供的业务性能监控能力之一。
帮助管理员全面掌握 BI 模板的访问情况与性能状态，快速定位性能瓶颈，降低问题排查成本。
2. 使用前提
1）功能面向对象
本功能，仅面向 PC 端访问的 BI 仪表板。
本功能，需确保 FineBI 项目版本为： 6.1.9~6.1.X，或 7.0.8及以上
2）开启链路追踪
使用本功能前，请先确保开启链路追踪。详情请参见：链路追踪使用前提
3）配置性能设置
管理员登录运维平台，选择目标项目，单击「健康巡检>业务性能」，在右上角单击「性能设置」。
单击「BI模板性能」，配置该项目的 BI 模板性能设置，单击「保存」完成配置。
单击「BI模板性能」，配置该项目的 BI 模板性能设置，单击「保存」完成配置。
| 配置项 | 说明 |
|---|---|
| 数据刷新时间 | 每日按默认区间聚合计算的执行时间，默认值为凌晨 2 点 |
| 默认展示指标 | 配置 BI 模板性能总览表和明细表中默认展示的字段，所有用户刷新页面后均会重置为该配置 |
| 慢查询设置 | 超过设置值的请求，会被算作慢请求 默认值为 10000ms，要求必填、整数、最小 1000ms |
3. 功能入口
1）管理员登录运维平台，进入目标被管理项目，单击「健康巡检>业务性能」。
2）在「业务性能」页面的下拉列表中选择「BI模板性能」，即可切换至对应监控模块。
4. 性能总览
性能总览页面由「总览图」和「总览表」两部分组成，提供 BI 模板访问情况的全局视图。
4.1 配置查询条件
1）设置展示字段
在「总览」界面，单击右上角的「展示字段」按钮，勾选需要展示的维度和指标。该设置对总览图的下钻明细和总览表生效。
| 维度/指标 | 说明 |
|---|---|
| 模板路径 | 仪表板在用户的分析下的完整路径 |
| 模板名称 | 仪表板的名称 |
| 目录名称 | 仪表板挂载到平台目录的名称 |
| 模板发布情况 | 已发布、未发布、发布中 |
| 创建者 | 仪表板的创建者 |
| 模板ID | 仪表板的ID |
| 最近使用时间 | 仪表板最近一次被访问的时间 |
| 优化建议 | 运维平台识别到的仪表板问题，建议的优化方向 |
| 访问次数 | 用户操作仪表板的次数（预览、编辑、导出） |
| 访问人数 | 操作仪表板的用户数（预览、编辑、导出） |
| 首屏平均耗时 | 首屏耗时是指用户打开仪表板，到仪表板可见范围加载完成可以进行交互的时间 首屏平均耗时是指该仪表板的首屏耗时的平均数 |
| 中位FMP | 该仪表板首屏耗时的中位数 |
| 最大首屏耗时 | 该仪表板首屏耗时的最大值 |
| 慢查询总数 | 慢查询指大于第 2 章「慢查询设置」的请求 慢查询总数为慢查询的总数 |
| 慢查询占比 | 慢查询的总数 / 查询总数 |
| 表格组件数 | 仪表板内的表格类组件数量 |
| 图表组件数 | 仪表板内的图表类组件数量 |
| 过滤组件数 | 仪表板内的过滤组件数量 |
2）筛选模板范围
点击「筛选」按钮，可筛选总览图和总览表中的FineBI仪表板范围。
查询限制 60S 超时，超时则查询失败，提示「性能查询超时」，请缩小模板范围后再尝试。
| 筛选项 | 说明 |
|---|---|
| 检测区间 | 筛选访问FineBI仪表板的时间区间
|
| 访问用户 | 筛选访问仪表板的用户名称 |
| 模板ID | 筛选仪表板的ID |
| 模板名称 | 筛选仪表板的名称 |
| 模板发布情况 | 筛选仪表板发布到平台目录的状态，分为：已发布、未发布、申请发布中 |
| 目录名称 | 筛选挂出到平台目录的目录名称 |
| 模板范围 | 筛选在用户的分析下的仪表板完整路径 |
| 首屏平均耗时 | 首屏耗时是指用户打开仪表板，到仪表板可见范围加载完成可以进行交互的时间 首屏平均耗时是指该仪表板的首屏耗时的平均数 |
| 慢查询数 | 大于第 2 章「慢查询设置」的请求数量 |
4.2 总览图
总览图以图表形式直观展示模板的访问情况，包含以下三个图表：
| 图表类型 | 说明 |
|---|---|
| 访问量 TopN 排行 | 以柱状图降序展示访问量最高的 FineBI 仪表板 横轴为访问次数，纵轴为模板名称，可滚动查看全部资源 单击对应柱状图跳转至BI模板性能明细页 |
| 耗时分布情况 | 结合「访问次数」和「平均首屏耗时」两个维度展示所有 FineBI 仪表板，快速定位高访问、高耗时的问题模板 横轴为访问次数，纵轴为平均首屏耗时（ms） 单击对应散点跳转至BI模板性能明细页 |
| 整体访问趋势 | 展示选定时间范围内系统整体平均首屏耗时和总访问次数的变化趋势，帮助发现性能恶化拐点 横轴为日期，纵轴为平均首屏耗时及总访问次数 数据点支持单击跳转至BI模板性能明细页 |
4.3 总览表
总览表以表格形式展示按模板 ID 聚合后的性能指标。
1）查看单个模板的明细
单击某行的「模板ID」链接，系统携带该行模板 ID、访问用户与当前总览页的检测时间范围，跳转至「BI模板性能-明细」页面并自动触发查询。
其中优化建议包括：
| 含义 | |
|---|---|
| 无需优化 | 慢查询占比≤0.2 |
| 建议减少总组件数 | 表格组件数+图表组件数＞30 |
| 建议减少图表组件数 | 图表组件数＞6 |
2）导出数据
单击右上角「导出」按钮，系统将当前界面展示的数据导出为 Excel 文件并下载至本地，便于离线分析和存档。
导出行数限制最大 100W 行，超过后仅导出前 100W 行。若数据量过大，建议缩小时间区间分批导出。
导出超时限制为 5 分钟，若超时会提示「导出超时，请缩减数据范围」，建议缩小时间区间或减少筛选项后重新导出。
5. 性能明细
明细表一行显示一次模板访问记录。
5.1 配置查询条件
1）设置展示字段
在「明细」界面，单击右上角的「展示字段」按钮，勾选需要展示的维度和指标。该设置对明细表生效。
| 维度/指标 | 说明 |
|---|---|
| 访问时间 | 用户访问仪表板的时间 |
| 访问用户 | 访问仪表板的用户名称 |
| 模板路径 | 仪表板在用户的分析下的完整路径 |
| 模板ID | 仪表板的ID |
| 模板名称 | 仪表板的名称 |
| 会话ID | 此次访问会话的ID |
| 访问类型 | 预览、编辑、导出 |
| 版本时间 | 访问仪表板时的工程版本 |
| 集群ID | 访问仪表板时的集群ID |
| 首屏耗时 | 指用户打开仪表板，到仪表板可见范围加载完成可以进行交互的时间 |
| 白屏时间 | 指用户打开仪表板，模板界面完全白屏的时间 |
| 慢查询数 | 慢查询是指大于第二章「慢查询设置」的请求 慢查询数是指慢查询的总数 |
| 失败查询数 | 指查询失败的请求数量 |
2）筛选模板范围
点击「筛选」按钮，可筛选明细表中的FineBI仪表板范围。
查询限制 60S 超时，超时则查询失败，提示「性能查询超时」，请缩小模板范围后再尝试。
| 筛选项 | 说明 |
|---|---|
| 检测区间 | 筛选访问FineBI仪表板的时间区间
|
| 访问用户 | 筛选访问仪表板的用户名称 |
| 模板ID | 筛选仪表板的ID |
| 模板名称 | 筛选仪表板的名称 |
| 会话 ID | 此次访问会话的ID |
| 访问类型 | 预览、编辑、导出 |
| 首屏耗时 | 指用户打开仪表板，到仪表板可见范围加载完成可以进行交互的时间 |
| 慢查询数 | 指大于第二章「慢查询设置」的请求数量 |
| 失败查询数 | 指查询失败的请求数量 |
5.2 明细表
在性能明细表中，支持以下跳转操作：
| 入口 | 跳转目标与携带参数 |
|---|---|
| 会话ID | 跳转至「BI组件性能-明细」页面，自动带入该会话 ID 与访问时间前后各扩展 10 分钟的检测时间区间，用于查看该次访问触发的全部组件查询 |
| 访问趋势 | 跳转至「BI模板性能-总览」页面，自动带入该行模板 ID，并将检测时间设置为近一周，用于判断问题是偶发还是持续 |
| 首屏链路 | 跳转至该次访问对应的首屏链路追踪明细页面 |
| 调用链路 | 跳转至该次访问对应的调用链路追踪明细页面 |
导出：单击「导出」按钮，可将当前界面展示的性能明细数据导出为 Excel 文件。
导出行数限制最大 100W 行，超过后仅导出前 100W 行。若数据量过大，建议缩小时间区间分批导出。
导出超时限制为 5 分钟，若超时会提示「导出超时，请缩减数据范围」，建议缩小时间区间或减少筛选项后重新导出。
上一篇：组件监控
