Jenkins Linux版如何监控任务状态

Jenkins Linux 版监控任务状态的实用方案

一内置与插件方式

使用 Monitoring 插件（JavaMelody） 查看 Jenkins Master/Agent 的 CPU、内存、HTTP 响应时间、当前请求数 等，适合快速体检与容量评估；该插件以仪表盘形式展示，便于定位性能瓶颈。
使用 Prometheus Metrics 插件 暴露 /prometheus 指标端点，获取 Job、构建、节点（Agent）、队列、Executor 等 CI/CD 业务指标，便于做趋势分析与容量规划。
使用 Email Extension / Slack Notification 等通知类插件，在任务 成功、失败、不稳定、中止 等状态触发 邮件/企业微信/Slack 告警，适合即时通知到团队。

二 Prometheus Grafana 监控与告警示例

安装与暴露指标：在 Manage Jenkins → Plugins 安装 Prometheus Metrics Plugin，Jenkins 将在 http://:8080/prometheus 暴露指标。

Prometheus 拉取配置示例：

scrape_configs:
  - job_name: 'jenkins'
    metrics_path: '/prometheus'
    static_configs:
      - targets: ['<jenkins_host>:8080']

常用告警规则示例（节点离线）：

- alert: JenkinsNodeOffline
  expr: default_jenkins_nodes_online == 0
  for: 2m
  labels:
    severity: warning
  annotations:
    summary: "Jenkins 节点离线"
    description: "Jenkins 节点 {{ $labels.node }} 已离线超过 2 分钟"

可视化：在 Grafana 配置 Prometheus 数据源并导入 Jenkins 仪表盘模板（ID: 9964），即可查看 构建成功率、构建耗时、队列长度、Executor 使用率、节点在线状态 等面板。

三 Linux Shell 与 API 轮询监控

获取最新一次构建结果（JSON）：
```
curl -s -u <user>:<token> \
  http://<jenkins>/job/<job_name>/lastBuild/api/json | jq -r '.result'
```
常见结果：SUCCESS、UNSTABLE、FAILURE、ABORTED、NOT_BUILT、null（构建中）。

实时等待构建结束并判定结果（示例）：

#!/usr/bin/env bash
set -euo pipefail
JENKINS_URL="http://<jenkins>"
JOB="<job_name>"
USER="<user>"
TOKEN="<api_token>"

# 触发构建（可选）
# curl -X POST -u "$USER:$TOKEN" "$JENKINS_URL/job/$JOB/build"

# 获取最新构建号
BUILD=$(curl -s -u "$USER:$TOKEN" \
  "$JENKINS_URL/job/$JOB/lastBuild/api/json" | jq -r '.number')

echo "Watching build #$BUILD"

while true; do
  RESULT=$(curl -s -u "$USER:$TOKEN" \
    "$JENKINS_URL/job/$JOB/$BUILD/api/json" | jq -r '.result')
  if [[ "$RESULT" != "null" ]]; then
    echo "Build #$BUILD finished with result: $RESULT"
    case "$RESULT" in
      SUCCESS)   exit 0 ;;
      UNSTABLE)  exit 1 ;;
      FAILURE|ABORTED) exit 2 ;;
      *)         exit 3 ;;
    esac
  fi
  sleep 5
done

说明：将 : 替换为 API Token（推荐）或密码；如 Jenkins 启用了 CSRF，需先获取 crumb 并在请求头中携带。上述方式适合 Shell/CI 脚本 内做门禁或联动部署。

四构建后动作根据状态执行逻辑

安装 PostBuildScript 插件，在 构建后操作 中选择 Execute scripts，可读取当前构建状态（如 SUCCESS、FAILURE、ABORTED、UNSTABLE），据此执行不同命令，例如：
- 仅在 失败/中止 时执行全量清理与重拉依赖；
- 在成功时执行部署或归档；
- 在 不稳定 时仅做通知或跳过部分步骤。
适用场景：减少不必要的重复构建、失败快速回滚、按状态分流后续流程。

五实践建议

组合监控：用 Prometheus Grafana 做 趋势与容量（成功率、耗时、队列、节点健康），用 邮件/Slack 做 即时告警，用 Shell API 做 自动化门禁与联动。
安全与权限：优先使用 API Token 而非明文密码；为监控账号授予 最小权限（Job/Read、View/Read 等）。
稳定性：为 Prometheus 抓取 与 脚本轮询 设置合理间隔（如 5–15 秒），避免对 Jenkins Master 造成额外压力。
可视化与基线：在 Grafana 建立 构建健康度 与 节点在线率 的 基线面板，并设置 告警阈值 与 升级/扩容 的触发条件。

最新问答

相关标签