在 Debian 上监控 Jenkins 的实用方案
一 监控目标与总体架构
- 监控对象应覆盖四个层面：
- 系统层：CPU、内存、磁盘 I/O、网络；
- JVM 层：堆内存、GC、线程、类加载；
- Jenkins 应用层：构建队列、执行节点在线状态、构建成功率/时长、插件健康；
- 告警与可视化：统一面板展示与阈值告警。
- 推荐架构：在 Jenkins 上启用指标暴露（如 Prometheus 插件），由 Prometheus 定时抓取，使用 Grafana 做可视化，配合 Alertmanager 或系统级告警实现通知。
二 快速上手步骤
-
系统与服务可用性
- 使用 systemd 检查与守护进程：
- 查看状态：
sudo systemctl status jenkins
- 启动/自启：
sudo systemctl start jenkins；sudo systemctl enable jenkins
- 访问 Web 界面：打开 http://<服务器IP>:8080，确认首页、作业与健康页可正常加载。
- 使用 CLI 辅助巡检：
- 列出代理节点：
jenkins-cli -s http://<IP>:8080 -auth <用户>:<API Token> agent list
- 查看最近一次构建详情：
java -jar jenkins-cli.jar -s http://<IP>:8080 console http://<IP>:8080/job/<job_name>/lastBuild
- 说明：CLI 需先在用户配置中生成 API Token，或使用已配置的凭证。
-
资源与日志的基础巡检
- 系统资源：
top/htop、iostat -x 1、iftop/nethogs 观察 CPU、内存、I/O 与网络异常。
- 磁盘与日志：
- 查看 Jenkins 主目录占用：
du -sh /var/lib/jenkins
- 查看日志：
tail -n 200 /var/log/jenkins/jenkins.log
- 清理与优化（避免磁盘被占满导致实例异常）：
- 定期清理旧构建与制品、限制并发构建数、升级/停用异常插件。
三 深入监控与可视化
- 应用性能插件 Monitoring（JavaMelody）
- 安装后在 Manage Jenkins > Monitoring of Jenkins master 查看仪表盘，覆盖 内存、CPU、HTTP 响应时间、当前请求数 等，适合快速洞察 Master 负载与健康。
- Prometheus + Grafana
- 在 Jenkins 安装 Prometheus 插件，暴露 /prometheus 指标端点。
- Prometheus 配置示例（prometheus.yml）：
- scrape_configs:
- job_name: ‘jenkins’
metrics_path: ‘/prometheus’
static_configs:
- targets: [‘<jenkins_ip>:<jenkins_port>’]
- Grafana 增加 Prometheus 数据源，导入 Jenkins 概览/性能面板，实现趋势与阈值可视化。
- 日志与事件告警
- 构建结果通知：安装 Email Extension 与 Email Extension Template 插件，按构建成功/失败、阶段结果触发邮件。
- 即时通信：使用 Slack Notification 等插件推送构建与节点事件。
- 第三方监控：Jenkins-monitor 可辅助监控集群状态并提供实时告警；也可结合 ElastAlert 对日志/指标做规则化告警。
四 告警规则与容量管理要点
- 建议的关键告警
- 系统资源：CPU 持续高于 80%、可用内存低于 10%、磁盘使用率超过 80%、I/O 长时间饱和。
- Jenkins 业务：构建队列持续大于 0、节点离线、关键作业失败、构建时长异常突增。
- 容量与健康
- 定期清理旧构建与制品、归档与备份（如打包 /var/lib/jenkins），并优化 JVM 参数 与并发构建数，避免因资源争用导致不稳定。
- 存储建议：将 JENKINS_HOME 与构建工作区置于 SSD，降低 I/O 瓶颈并提升构建与日志写入性能。