若禅道效能模块无法查看或正确计算关键指标，需依次启用内置度量项、启动自动化数据采集、创建分析图表、构建透视表根因分析、SQL直查验证数据准确性。
如果您已在禅道中启用效能模块，但无法查看或正确计算需求交付周期、缺陷密度、任务完成率等关键指标，则可能是度量项未启用、数据采集未触发或计算规则与实际流程不匹配。以下是使用度量指标的具体操作路径：
一、启用并配置内置度量项
禅道默认内置291个研发效能度量项，覆盖需求交付周期、缺陷密度、任务完成率等维度；启用前需确认当前版本为Zentao 18.0及以上，且用户已开通BI权限。该步骤确保系统具备可计算的指标定义基础。
1、使用管理员账号登录禅道，进入【后台】→【扩展】→【效能管理】。
2、在“度量项”标签页中，点击右上角【批量启用】按钮，勾选常用度量项，例如需求平均交付周期、迭代内任务完成率、每人每日有效工时。
3、对任一已启用的度量项点击【编辑】，检查其“计算规则”是否贴合团队流程，例如将需求交付周期的起始点设为“需求状态变更为‘已确认’”，终点设为“关联任务全部关闭”。
二、启动自动化数据采集
度量指标的数值依赖真实过程行为数据，禅道通过后台定时任务自动从任务、Bug、版本、日志等模块提取原始记录，避免人工补录导致的滞后与偏差。该步骤确保度量库有持续、可信的数据源。
1、进入【后台】→【定时任务】，查找名为效能数据采集的任务，确认其状态为“启用”，执行周期建议设为每6小时一次。
2、点击该任务右侧【执行】按钮，手动触发首次采集，等待约2–5分钟完成。
3、返回【效能管理】→【度量库】，在“原始度量库”中核查是否有近24小时内生成的数据记录条目；若数量为0，需检查对应项目/产品模块是否已开启工作流日志记录功能。
三、创建效能分析图表
图表是将度量结果转化为可视洞察的直接方式，禅道提供免SQL图表设计器，支持趋势对比、多维下钻与指标叠加，无需数据库知识即可完成配置。
1、进入【效能管理】→【图表】→【新建图表】，模板类型选择迭代效能趋势图。
2、在“数据源”区域点击【选择度量项】，添加迭代任务完成率与平均Bug修复时长两个指标，时间范围设为最近6次迭代。
3、点击【保存并预览】，图表生成后，鼠标悬停某数据点可查看该迭代对应的项目名称、起止日期及异常明细。
四、构建多维透视表进行根因分析
当发现某次迭代任务完成率骤降或Bug修复时长突增时，透视表支持按人员、模块、缺陷类型、指派对象等字段交叉分组，快速定位瓶颈环节，辅助归因判断。
1、进入【效能管理】→【透视表】→【新建透视表】，数据源选择基础度量库-任务执行明细。
2、在行维度中添加指派给与任务类型，列维度添加迭代名称，值区域设置为任务消耗工时总和与任务关闭数量计数。
3、点击【保存并预览】，表格将按人员+任务类型组合展开，可直观识别出哪类任务在哪个成员处存在明显积压或延迟。
五、通过SQL直查验证度量数据准确性
当图表或透视表结果与业务感知存在偏差时，可通过直接查询底层数据库校验原始数据来源，排除计算逻辑误配或数据同步遗漏问题。
1、使用具有数据库访问权限的账号，连接禅道MySQL实例，执行以下语句验证需求交付周期原始数据来源：
SELECT id, project, product, title, openedDate, closedDate FROM zt_story WHERE status = 'closed' AND closedDate IS NOT NULL LIMIT 10;
2、比对查询结果中的openedDate与closedDate是否与界面中“需求平均交付周期”计算值一致；若不一致，需回溯该度量项的“计算规则”中起止条件是否覆盖了此条记录的状态变迁路径。
3、执行如下语句核验任务完成率统计基数是否完整：
SELECT COUNT(*) FROM zt_task WHERE execution IN (SELECT id FROM zt_project WHERE type = 'sprint') AND status IN ('done', 'closed');
