趋势监控
使用 CppDepend 中的趋势监控优化软件开发
简介

趋势图显示在 CppDepend 仪表板上。默认可用的趋势图显示:
- 代码行数
- 被违反的代码规则数与规则违规数
- 各种代码质量度量的最大值与平均值
- 第三方使用情况
趋势图可自定义,轻松创建自己的趋势图来显示默认和/或自定义趋势度量。

对于所有趋势相关操作, 趋势菜单 可用。

趋势度量
要列出默认趋势度量,请查看 查询和规则浏览器面板 并选择名为的组 趋势度量.

如果趋势指标列在代码查询面板中,那是因为趋势指标是一个 CQLinq 代码查询。它是一种特殊的代码查询:
- 趋势指标是返回标量的代码查询。因此,趋势指标查询通常使用返回标量的 LINQ 聚合运算符。这包括如下运算符 Count() Sum() Average() Min() Max() ...
- 代码查询的头部是按以下方式格式化的注释行 // <TrendMetric Name="Metric Name" Unit="Metric Unit Name" />
例如这是 # 代码行数 趋势度量代码查询:

由于趋势指标是代码查询,因此很容易创建自己的趋势指标或修改现有指标。例如,下面是一个统计继承自……的类型数量的代码查询 Poco.Exception:

有六个默认趋势指标不是代码查询。它们与违反的代码规则数量和代码规则违规次数有关:

趋势指标在分析时记录,如以下章节所述 记录趋势度量.
趋势图
Create or Edit trend charts 对话框允许您定义所有趋势图属性。趋势指标系列列表可用,勾选一个系列即可在趋势图上将其可视化。系列的外观可以自定义,包括:
- 系列的颜色
- 如果系列以折线或面积形式显示
- 定义系列刻度。刻度设置可用于调整多个系列的刻度,以便在同一趋势图上进行比较。

报告趋势图
在上图中,我们可以看到一个标记为的复选框: 在报告中显示此趋势图 趋势图确实可以显示在报告中。
为此,复选框 CppDepend 项目属性面板 > Report 选项卡 > 勾选 Use standard report > Trend Charts 必须勾选。

记录趋势度量
趋势指标值在分析时记录。通过每天运行分析,可以构建一系列趋势指标值。
与趋势指标值日志相关的设置在以下位置均可用 CppDepend选项 > 趋势 章节,以及在 CppDepend 项目属性 > Analysis > Trend Metrics Log 章节。如果项目属性中设置了相关设置,它们将覆盖选项中定义的全局设置。
趋势度量日志设置包括:
- 日志记录的频率,例如每天或每周最多一次
- 为每个日志定义一个标签,表示所分析的代码库版本。在上面的趋势图屏幕截图中,您可以看到此版本标签显示在趋势图的时间线 X 轴上。
- 保存包含趋势指标值的文件的文件夹。为避免文件过大,每年创建一个文件。

请注意,无论趋势指标日志设置如何,使用 CppDepend.Console.exe 命令行参数 /LogTrendMetrics 将在分析期间强制记录趋势指标。
