BlueGrove Labs
帮助中心StatusPath ReportsJira Cloud
联系支持
EN

使用指南

如何用 Dashboard Gadget 建立可重复的 Jira Review 监控视图

当监控定义已经确认后，再使用 StatusPath Dashboard Gadget：固定一个 JQL 范围、历史边界、Calendar、Format、目标状态、排序和前五项规则。可重复的是这套配置，不是冻结结果。把五个显示位置的集中度当作调查信号，而不是瓶颈诊断；当信号持续、变化或需要解释时，转到完整报表和 Jira History 深入调查。

固定一套已确认的监控定义

本文只回答：团队如何把一套已经定义好的 In Review 监控配置固定在 Jira Dashboard 上，以一致方式重新运行，并判断何时应从紧凑信号转入完整调查？

本文不负责判断 In Review 是否构成系统性瓶颈。瓶颈诊断请参阅如何查找 Jira 工作流瓶颈；如果任务是设计通用的时长检查队列，请参阅如何查找 Jira 中状态累计时长最长的工作项。本文只负责更窄的操作模式：把固定定义放进 Gadget，以一致方式读取前五项信号，并在必要时离开 Gadget 深入调查。

当前控件以 Dashboard Gadget 文档为准。Atlassian 说明了如何在 Jira Dashboard 中添加和自定义 Gadget。在当前 StatusPath 版本中，v2 编辑页保存 Gadget 自己的自定义 reportConfig；它没有 Saved Report 选择器，Gadget 视图也不显示主报表页面的 Saved Reports 菜单。页脚刷新操作和 Jira Dashboard/Gadget 刷新事件都会重新查询并计算当前报表。当前版本没有可配置的定时刷新间隔，旧 interval 值会被忽略。

可复现的配置和一次观察结果

截图使用以下明确的 fixture 范围：

project = SR
AND key in (SR-5301, SR-5302, SR-5303, SR-5304,
            SR-5305, SR-5306, SR-5307, SR-5308)
ORDER BY key ASC

Atlassian 的 JQL 高级搜索文档说明了如何用 JQL 定义条件和排序。这里的 JQL 只选出八个具名工作项，不计算 In Review 时长。运行 Gadget 后，应确认结果恰好有八行，而且八项当前都处于 In Review。随后，StatusPath 才根据 Jira 历史和所选 Calendar 计算它们的 In Review 时长。

配置可以复现，结果并非冻结。在记录的 fixture 观察时间 2026-07-31 17:00 UTC，每个工作项只进入 In Review 一次，并且仍停留其中。所选 Calendar 计算 UTC 时区工作日 09:00–17:00，且没有例外日期。

工作项 当前状态 本次 Gadget 结果中的 In Review 时长
SR-5301 In Review 32h
SR-5302 In Review 24h
SR-5303 In Review 18h
SR-5304 In Review 12h
SR-5305 In Review 8h
SR-5306 In Review 6h
SR-5307 In Review 4h
SR-5308 In Review 2h

这些数值不是基准、SLA、推荐阈值，也不能证明 In Review 限制了工作流。它们只是固定配置下的一次观察结果。

配置紧凑信号

设置 固定值
报表类型 状态停留时间（Time in Status）
工作项范围 上述八个 key 的 JQL
工作项日期范围 留空
Trim History 关闭（使用全部可用历史）
Calendar 工作日 09:00–17:00，UTC，无例外日期
Format Decimal Hours
目标状态 In Review
表格排序 In Review，降序
图表 瓶颈工作项排行
Top N 5
图表排序 In Review

前五项是位置规则，不是 8h 阈值。 先按 In Review 时长对当前 Gadget 结果中的八行降序排列，再显示前五个位置。本次观察中的五个位置是 SR-5301 至 SR-5305：

前五项 In Review 合计 = 32h + 24h + 18h + 12h + 8h = 94h
全部八项 In Review 合计 = 32h + 24h + 18h + 12h + 8h + 6h + 4h + 2h = 106h
前五项原始集中度 = 94h ÷ 106h × 100 = 88.679245...%
最终显示集中度 = 88.68%
本次观察的第五/第六项数值 = 8h / 6h

在当前范围和计算定义下，前五个工作项占此 Gadget 所显示 Review 时长的 88.68%。 分母严格限定为本次 Gadget 结果中的八个 In Review 时长值。它不是 Total time、全部 Jira 工作项、所有曾进入 In Review 的工作项，也不是整个工作流的分母。8h 在本次观察中只是第五位的数值，不是配置的筛选线；这五项也没有被证明是延误原因。

当前图表先按所选时长降序排列；时长相同的行保留其现有结果顺序，然后 Top N 只取前五个位置。这是位置截断规则，不是有业务含义的并列排序。如果第五和第六项并列，应把它们视为相同调查优先级，并在完整表格中同时检查。任何重新运行之后，开放时长、Jira 数据、权限或历史都可能变化；即使 Gadget 配置不变，前五项成员和集中度仍可能改变。

StatusPath Dashboard Gadget 的瓶颈工作项排行按 In Review 时长显示五行
瓶颈工作项排行从八行 Gadget 结果中保持五个按 In Review 时长排序的位置可见。

创建 Gadget 并以一致方式重新运行

  1. 打开目标 Jira Dashboard，添加 StatusPath Reports Gadget。
  2. 打开 Gadget 的 设置，选择状态停留时间（Time in Status）。
  3. 输入上述有边界的 JQL，并确认该 fixture 恰好返回八行，而且每行当前都处于 In Review。
  4. 选择 UTC 工作日 Calendar 和 Decimal Hours Format。
  5. 在表格视图中保留 In Review，并按该列降序排列。
  6. 切换到瓶颈工作项排行，将 Top N 设置为 5，并按 In Review 排序图表。
  7. 保存 Gadget 的自定义配置。当前编辑视图把该 reportConfig 随 Jira Dashboard item 保存，不会选择 Saved Report。
  8. 按约定频率使用可见的刷新操作或 Jira Dashboard 刷新，并在解释结果前记录观察时间。两种路径都会重新查询并计算当前报表。

在截图之外记录 JQL、历史边界、Calendar、Format、排序字段、Top N 和检查频率。重新应用这些设置可以复现计算定义，但不能恢复早先观察时冻结的行和时长。

判断何时离开 Gadget

如果问题只是在本次检查时判断同一条紧凑 In Review 信号是否值得关注，可以留在 Gadget 中。出现以下情况时，应转到主报表页面：

  • 第五和第六项并列，或两者接近到五个位置不足以覆盖相关工作项；
  • 刷新后，前五项成员或集中度发生明显变化；
  • 信号持续存在，需要贡献项数量、分布、趋势、重复进入核查或更大表格；
  • 有人要求判断 In Review 是否为系统性瓶颈、解释某项为何时长较长，或归因给人员和流程。

当前 Gadget 不提供 Saved Reports 菜单，编辑模式也没有 Saved Report 选择器。应单独进入主报表页面，按照可复用报表恢复与版本方法创建或恢复更大的调查工作区，再检查代表性 Jira 工作项。Atlassian 说明，工作项的 Activity → History会记录字段编辑和工作流移动。在归因或改变工作流前，还需要结合这些历史和实际运行背景。

常见错误

把集中度当作瓶颈诊断

88.68% 只说明在本次观察中，五个位置包含了八个返回项的大部分 In Review 时长。它不能证明广泛堆积、持续性、容量约束、成因或业务影响。

把前五项当成八小时阈值

Top N 选择的是排序后的位置数量。第五项在本例中恰好为 8h；换一次刷新或范围，第五位可能是其他数值。

忽略显示边界上的并列

五个位置的图表可能隐藏与第五项时长相同的第六项。应把并列值视为同一优先级，并使用完整表格确定全部调查对象。

假设已经配置定时刷新，或结果会被冻结

当前版本没有可配置的刷新间隔。应主动使用可见的刷新操作或 Jira Dashboard 刷新。重新运行会查询当前 Jira 数据并重新计算；Gadget 保存的是配置，不是早先结果的快照。

寻找主报表页面的 Saved Reports 菜单

当前 v2 编辑页只保存自己的自定义报表配置，没有 Saved Report 选择器。需要 Saved Reports、更大表格、更完整图表或深入调查时，应使用主报表页面。

把累计 Time in Status 称为实际工作或当前区间年龄

Time in Status 可以累计历史边界内的多次停留，长区间也可能包含等待或其他背景。本 fixture 中它等于当前开放 In Review 区间，只因为每个工作项仅进入 In Review 一次。

常见问题

Dashboard Gadget 能诊断 Jira 工作流瓶颈吗？

不能。它固定一套监控定义并提供集中度信号。诊断还需要更广泛、持续的证据和代表性 Jira 历史。

Dashboard Gadget 会自动刷新吗？

它会响应 Jira Dashboard/Gadget 刷新事件，页脚也有手动刷新操作；两者都会重新查询并计算当前报表。当前版本不提供可配置的定时刷新间隔。

前五项等于八小时阈值吗？

不等于。前五项是按 In Review 时长排序后的五个位置；8h 只是本次八行观察结果中的第五个数值。

第五和第六项并列时怎么办？

图表仍只显示五个位置。应把并列行视为相同优先级，打开完整表格，并把所有并列行纳入调查集合。

这个 Gadget 能选择或冻结 Saved Report 吗？

当前 v2 编辑体验不能。它保存自己的自定义 reportConfig，既不提供 Saved Report 选择器，也不显示主页面的 Saved Reports 菜单。之后重新运行会查询当前 Jira 数据，而不是恢复冻结的历史行。

相关指南

固定监控信号，分开处理诊断

有用的 Gadget 保存一套监控定义，而不是一个冻结答案。以一致方式重新运行，以八行结果为边界解释前五项，并在信号需要解释时转到完整报表和 Jira History。集中度只告诉团队下一步应查看哪里，不会替团队决定工作流问题是什么。

在 Atlassian Marketplace 试用 StatusPath Reports，在 Jira Dashboard 中固定显示一条紧凑的 Time in Status 信号。

截图预览