SonarQube中文网站 > 新手入门 > SonarQube项目活动记录在哪看 SonarQube项目活动记录如何按事件筛选
教程中心分类
SonarQube项目活动记录在哪看 SonarQube项目活动记录如何按事件筛选
发布时间:2026/11/16 14:14:14

  早上打开SonarQube,发现昨天还通过的项目今天没过质量门禁。大家想知道的是哪次分析开始变化,以及那段时间有没有换规则、更新分析器或发布新版本。项目概览能看到当前结果,活动页则能把保留下来的分析记录按时间排开。左侧是扫描记录和附在上面的事件,右侧是指标趋势。顺着这个时间线查,比只看当前的问题列表更容易缩小范围。

  一、SonarQube项目活动记录在哪看

 

  活动页在单个项目的导航栏里。进入页面前先确认项目和分支,尤其是主分支与发布分支名称相近的时候。下文用中文描述功能,英文界面可按括号中的英文名称查找。

 

  1、从项目导航进入活动页

 

  ①登录SonarQube,依次打开【项目(Projects)】→【目标项目】→【活动(Activity)】。

 

  ②如果项目支持分支分析,先用【分支选择器】确认当前分支。排查发布前后的变化时,选实际执行过扫描的发布分支,再核对左侧记录的日期。

 

  ③在左侧分析列表找到要看的日期,查看该次分析旁有没有【质量门禁】、【版本】或【质量配置】等事件。

 

  左侧的一条记录对应一次保留下来的分析。某次扫描旁边没有版本或门禁事件,也可能只是这次扫描没有触发对应的变化。比如连续三次扫描都未通过门禁,门禁变化事件可以出现在由通过变为未通过的那一次。

 

  2、把分析记录和指标趋势放在一起看

 

  查到一个可疑日期后,可以看同一天的覆盖率、问题数或重复率有没有变化。图上的变化可以帮你定位要查哪一轮分析,具体原因还得结合事件和构建记录判断。

 

  ①在【活动(Activity)】页的图表区域选择要看的指标,例如覆盖率或重复率。将鼠标移到对应日期的数据点,查看当时的指标值。

 

  ②对照左侧【分析列表】,找到同一时间附近的扫描。如果某项指标从那次分析起发生变化,记下日期和事件名称,留着与构建记录核对。

 

  二、SonarQube项目活动记录如何按事件筛选

 

  在活动页左侧找到事件筛选器。筛选针对的是附在分析记录上的事件,所以选中某个类别后,列表可能一下少很多。想查门禁何时变了和想查哪次发布被扫描,需要选不同的类别。

 

  1、按质量门禁或项目版本查时间点

 

  ①在【活动(Activity)】页打开【筛选事件(Filter events)】,选择【质量门禁(Quality Gate)】,查看门禁状态在哪次分析发生变化。

 

  ②如果要查某个版本何时被扫描,把条件切换为【版本(Version)】,查看项目版本变化对应的分析记录。记下显示的版本值和时间,再与构建记录核对。

 

  ③查完后清除【筛选事件(Filter events)】中的条件,回到完整的分析列表,查看目标记录前后有没有其他扫描。

 

  质量门禁筛选适合找状态转折点。要核对失败之后又扫过几次,可以清除条件回看那段时间。版本事件反映的是SonarQube识别到的项目版本变化。如果构建一直沿用同一个版本值,多次扫描也可能只有一条版本事件。

  2、按质量配置或分析器事件找规则变化

 

  问题数突然增加时,可以顺手核对分析环境。质量配置变化和分析器更新都有可能改变扫描结果,两类事件在活动页里有各自的入口。

 

  ①在【筛选事件(Filter events)】中选择【质量配置(Profile)】,查看相关分析使用的配置是否改过,或是否换用了另一套配置。记录里有规则变更明细时,展开核对涉及的规则。

 

  ②如果怀疑是分析器更新,切换到【问题检测(Issue detection)】。再查【SonarQube Server版本升级】事件,核对首次升级后分析出现的时间。界面中可用的类别以当前版本为准。

 

  3、查人工添加的项目标记

 

  ①在【筛选事件(Filter events)】中选择【其他(Other)】,查看团队在分析快照上手动添加的事件。如果打开的是应用而非单个项目,还可留意【定义变更(Definition change)】,这类事件对应应用定义的变化。

 

  三、SonarQube项目活动记录筛不到时怎么查

 

  活动页筛不到记录,可能是筛选条件排除了这次分析,也可能是扫描还在服务器端处理。时间较久的记录还受历史清理策略影响。先查是哪一种,再决定去哪里找证据。

 

  1、先确认原始分析记录是否存在

 

  ①回到【活动(Activity)】页,清除【筛选事件(Filter events)】的条件,确认项目、分支和要查的时间范围。

 

  ②如果记录出现了,但选择某一类别后又消失,查看该次分析附带的事件。排查版本时,可对照【构建日志】中实际传入的项目版本,看看这一轮有没有变化。

 

  一次分析可以正常完成,活动列表里也有记录,但没有新事件。比如修复了一批问题,门禁在修复前后都通过,这次扫描就可以在趋势图上体现变化,同时没有门禁状态变化事件。

 

  2、核对扫描提交后的处理结果

 

  近期扫描在活动页找不到时,可以拿构建时间与服务器端的任务时间对照。扫描器上传了报告,服务器还要处理这份报告,项目结果才会更新。

 

  ①打开对应构建的【扫描日志】,核对项目标识、分支和提交时间,确认报告提交到了正在查看的SonarQube实例。

 

  ②有相应权限时,在项目管理区域打开【后台任务(Background Tasks)】,找到对应的分析任务,检查它是排队中、处理中,还是已经失败。若任务失败,打开任务详情查看报错。

 

  ③任务完成后回到【活动(Activity)】刷新页面,先在无筛选状态下确认分析记录,再查看是否有预期事件。

 

  3、检查旧快照是否仍在保留范围内

 

  ①如果近期分析能看到,早期分析却成段缺失,请管理员核对【历史清理(Housekeeping)】的保留策略。需要追溯已清理的分析时,按日期查找当时留存的【构建日志】或【发布记录】。

  总结

 

  项目活动页适合回答“什么时候开始变了”。团队复盘时,可以把那次分析的时间和构建编号一并记下来,方便把门禁变化、规则调整或版本发布放回同一条时间线上。碰到趋势图上有变化、事件筛选里却空白的情况,也可以从这次分析本身查起,看看改变的是指标,还是项目的分析条件。

176 5129 0128