Jenkins如何监控构建状态

在 Jenkins 中监控构建状态，常见方式可以分为界面查看、API/CLI、通知告警、插件集成几类。下面按实用场景给你一个较完整的说明。

一、Jenkins 界面直接查看（最基础）

1. 任务（Job）页面

• 进入具体 Job
• 查看 Build History（构建历史）
  • 蓝色球：成功
  • 红色球：失败
  • 黄色球：不稳定
  • 灰色球：未构建/停用

2. 构建详情页

• 点击某次构建号
• 可查看：
  • 构建日志
  • 构建参数
  • 构建时长
  • 失败原因（如果有）

3. 仪表盘（Dashboard）

• 安装 Dashboard View 插件
• 可集中显示多个 Job 的状态、成功率、最近构建时间

二、使用 Jenkins API 监控（适合自动化）

1. REST API

GET http://jenkins-url/job/your-job/lastBuild/api/json

返回示例字段：

{
  "result": "SUCCESS",
  "building": false,
  "duration": 12345,
  "number": 102
}

常见接口：

• 最近构建：/job/xxx/lastBuild/api/json
• 构建状态：/job/xxx/lastBuild/consoleText
• 所有构建：/job/xxx/api/json?tree=builds[number,result,url]

2. CLI（命令行）

jenkins-cli build jobName -s

或查看状态：

curl -s http://jenkins/job/xxx/lastBuild/api/json

三、实时通知（推荐做法）

1. 邮件通知

• 使用 Email Extension Plugin
• 在 Post-build Actions 中配置：
  • 构建失败通知
  • 构建恢复通知

2. 即时通讯

常用插件：

• Slack Notification
• DingTalk（钉钉）
• 企业微信（WeChat Work）
• Lark / Feishu

示例（钉钉）：

• 构建失败 → 推送消息到指定群
• 消息含：Job 名、构建号、日志链接

四、使用监控插件（增强可视化和统计）

1. Build Monitor Plugin

• 专门的大屏监控插件
• 显示：
  • Job 状态
  • 构建进度
  • 失败闪烁提醒

2. Prometheus + Grafana（高级）

• 安装 Prometheus Metrics Plugin
• Jenkins 暴露指标：

http://jenkins/metrics/currentUser/metrics

• Grafana 可画：
  • 构建成功率
  • 平均构建时间
  • 失败趋势

五、Pipeline 中主动监控状态

示例（Jenkinsfile）

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'make'
            }
        }
    }
    post {
        success {
            echo '构建成功'
        }
        failure {
            echo '构建失败'
        }
        unstable {
            echo '构建不稳定'
        }
    }
}

六、常见监控组合建议

如果你有具体需求（比如：只用钉钉监控失败、K8s 中 Jenkins、Pipeline 怎么写通知），可以告诉我，我可以直接给你配置示例。