Jenkins 流水线监控器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/jenkins-pipeline-monitor。
技能介绍
要解决什么问题
当 Jenkins 上的流水线数量超过个位数后,肉眼盯控制台的做法会很快失效:构建卡在队列里没人发现、某个 stage 的耗时悄悄翻倍、回归测试的结果没人逐版本比对。排查这类问题通常要手工翻日志、切页面、抄时间戳,成本高且容易漏掉趋势性变化。这个技能把这类重复的巡检工作交给结构化的 API 数据。
核心能力与工作流程
它同时对接两类数据面:
- Jenkins REST API(
/api/json):获取构建队列状态与构建基本信息。 - Blue Ocean REST 端点:获取流水线的分阶段(stage)视图,用于拆解每个环节的耗时。
在此基础上,技能的核心工作流程是:
- 拉取队列与构建数据:从 Jenkins REST API 读取排队中的构建和最近构建的记录。
- 拆解阶段耗时:通过 Blue Ocean 端点把一次构建拆成 stage,定位是哪个环节变慢。
- 解析测试结果:使用 JUnit XML 解析测试报告,把通过率、失败用例的趋势串起来,而不是只看最后一次运行。
- 输出可对比的指标:把队列等待时间、stage 时长、测试趋势整理成便于比较的形式,让「这版比上版慢了多少」有据可查。
适用边界与注意点
- 指标质量取决于 Jenkins 实例本身的状态:构建历史被清理、Blue Ocean 插件未安装或 API 权限不足时,能拿到的数据会打折扣。
- Jenkins 本体的部署方式多样,官方提供 WAR、Docker 镜像、原生包和 Windows 安装器等形态;技能不关心部署形态,但要求实例的 REST API 可达。
- 资料中关于环境搭建、贡献方式与 Jenkins 内部实现的内容,均摘自 Jenkins 官方 README 与开发者文档,遇到边界情况建议回到上游文档核对。
- 它做的是监控与数据整理,不负责修复流水线本身——定位到慢 stage 之后,改动仍由人来下。
使用场景
- 夜间发布后收到报警,需要确认构建是否卡在 Jenkins 队列,并查看排队时长。
- 排查测试质量下滑:需要逐版本解析 JUnit XML,比对失败用例的变化趋势。
- 回归阶段耗时突增,需要借助 Blue Ocean 端点拆解各 stage 时长,定位瓶颈。
- 定期巡检流水线,需要汇总最近构建的状态与关键耗时,形成可追溯记录。
适合人员
- 运维工程师:需要在多个 Jenkins 任务间巡检队列与构建状态,尽早发现卡住或变慢的流水线。
- CI 工程师:需要逐版本对比 JUnit 测试结果,定位回归阶段耗时和失败用例的变化。
- 测试负责人:需要汇总多条流水线的测试趋势,向团队说明质量变化并跟进修复。
- 平台工具开发者:需要基于 Jenkins 与 Blue Ocean 的 REST 数据做监控脚本或自动化巡检。