收集自定义指标,用于历史趋势报告

作为报表管理员,您可以导出报表的历史指标包,并使用它在生命周期查询引擎中创建自定义指标。

开始之前

报告生成器生命周期查询引擎生成自定义度量包并将其上传到生命周期查询引擎之前,请配置 custom.metric.key:
  1. 添加密钥:
    报告生成器
    apps.properties 文件中,添加 rb.custom.metric.key=<key-value>
    生命周期查询引擎
    lqe.properties 文件中,添加 lqe.custom.metric.key=<key-value>
  2. 定义用于验证 Report BuilderLifecycle Query Engine 之间度量包真实性的 <key-value> 值。 密钥必须是自定义字母数字字符串。
    注意: 报告生成器生命周期查询引擎上的 custom.metric.key 值必须相同。
  3. 添加密钥后,重新启动报告生成器生命周期查询引擎的服务器。 重新启动后,密钥将被加密。

关于本任务

下图描述了从报告生成器将报告导出为历史度量包以用于 LQE 部署,然后将其导入生命周期查询引擎以用于报告的步骤。
导出历史度量的步骤

过程

  1. 报表生成器中创建一个报表,用于收集历史指标。 有关更多信息,请参阅使用报告生成器报告各项目指标和历史趋势
    例如,创建一个报告,统计没有测试用例的需求:
    1. 在 " 选择数据 "选项卡上选择报告类型
      1. 单击编辑图标 编辑 选择数据源。 如果只定义了一个数据源,那么缺省情况下将选择此数据源。 要决定选择何种数据源,请参阅主题
        注意: 只有使用生命周期查询引擎作为数据源时,才支持历史趋势(时间序列)报告类型。 此功能不适用于数据仓库 (DW) 数据源。
      2. 选择历史趋势(时间序列),以报告项目的趋势和指标。
      3. 限制范围。

        选择要报告的项目,然后单击继续。 如果未选择任何项目,那么报告将包含您可以访问的所有项目。

        该列表显示所选数据源中您可以访问的项目。 如果您的项目不在列表中,请联系创建 Report Builder 数据源的管理员。
        • 对于生命周期查询引擎 ,仅列出未启用配置的项目。
        • 对于由配置限定 Lifecycle Query Engine 的范围,只会列示已启用配置的项目。
      4. 选择要报道的文物。
      5. 跟踪关系并添加工件。 根据需求,从初始工件追溯到其他工件,并添加工件。
    2. 格式结果
      1. 添加一个属性来统计需求。
      2. 需求数量按项目领域细分。 如果您有自定义的需求属性,请添加它们并将其用作维度,而不仅仅是开箱即用的属性。
      3. 为表格的尺寸添加名称。 报告表中定义的列名将用作导出度量包中的维度名称。 确保列名有意义并与度量设计保持一致。

        例如,您可以将名称用作项目区域和未满足的要求计数。

    3. 命名并分享报告
      报告的名称用作表格的名称。 例如,如果报告的名称是“未满足的要求”,则表格的名称也将相同。
    4. 运行报告
  2. 导出报告的历史指标包,并在生命周期查询引擎中创建自定义指标。 在 “运行报告” 选项卡上,单击 “导出” > “将报告导出到历史指标包以进行 LQE 部署”
    下载的压缩文件由以下文件组成:
    .ddl 文件
    一个可用于创建表格存储度量的SQL文件。 数据库管理员可以运行 .ddl 文件来创建度量表。
    SQL 脚本
    SQL 脚本,通过在报告生成器中按计划拍摄快照来收集数据。
    .ttl 文件
    定义度量衡的形状,例如度量衡表中的列、名称等。
  3. 运行 .ddl 文件,创建度量表。
  4. 生命周期查询引擎管理页面上,导入自定义指标。
    1. 请访问数据指标页面: http://<host_name>:<port>/lqe/web/admin/metric-config。 在生命周期查询引擎 管理页面上,在菜单中找到数据指标
    2. “指标”选项卡中 ,查看可在 “报表生成器” 中使用的历史指标列表。
    3. 单击 " 新建指标 "将自定义历史指标添加到生命周期查询引擎
    4. 单击 " 导入 "上传度量包,其中包括 .ddl.ttl 文件和 SQL 脚本。