直接安装 jenkins prometheus metrics 插件即可自动暴露执行器占用率、队列积压量、节点离线数等饱和度指标至 /prometheus 端点，prometheus 通过配置 static_configs 主动拉取，无需中间件；插件默认导出 jenkins_executor_idle、jenkins_queue_size_value、jenkins_node_offline_value 等关键指标，支持实时计算饱和度。
直接在 Jenkins Master 上安装 Prometheus Metrics 插件，就能让所有关键饱和度指标（如执行器占用率、队列积压量、节点离线数）自动暴露为标准 Prometheus 格式指标，并被 Prometheus 定期抓取。整个过程不依赖额外中间件或脚本转发。
安装并启用 Jenkins Prometheus 插件
进入 Jenkins 管理界面 → Manage Jenkins → Manage Plugins → 在“Available”页搜索 Prometheus metrics（官方插件，ID：prometheus），勾选安装并重启 Jenkins。插件启用后，Jenkins 会自动在根路径下开放 /prometheus 端点（例如 http://jenkins-master:8080/prometheus），无需手动配置导出逻辑。
验证是否生效：用 curl 访问该地址，应返回纯文本格式的指标，包含类似以下内容：
jenkins_executor_idle{node="master"} 2.0jenkins_executor_total{node="master"} 4.0jenkins_queue_size_value 5.0jenkins_node_offline_value{node="linux-agent-03"} 1.0
确保 Master 饱和度相关指标已覆盖
该插件默认导出的指标已涵盖全线 Master 饱和度核心维度：
-
执行器压力：通过
jenkins_executor_idle和jenkins_executor_total可计算实时占用率（(total - idle) / total） -
任务排队深度：直接使用
jenkins_queue_size_value，反映待调度构建数量 -
主节点健康状态：
jenkins_health_check_score（0–100 分），低于阈值即表示内部服务异常 -
Master JVM 资源瓶颈信号：插件还导出
jenkins_jvm_memory_used_bytes、jenkins_jvm_threads_current等，可用于辅助判断 GC 频繁或线程耗尽等隐性饱和原因
Prometheus 主动拉取配置
在 Prometheus 的 scrape_configs 中添加 Jenkins Master 抓取任务，例如：
- job_name: "jenkins-master"
metrics_path: "/prometheus"
static_configs:
- targets: ["jenkins-master.default.svc.cluster.local:8080"] # K8s 内部 DNS
# 或写死 IP+端口：["10.96.123.45:30009"]
若 Jenkins 启用了 Basic Auth，需补充 basic_auth；若走 HTTPS 且有自签证书，加 insecure_skip_verify: true。配置完成后热重载（curl -X POST http://localhost:9090/-/reload）或重启 Prometheus。
确认指标已就位并可计算饱和度
打开 Prometheus Web UI（http://prometheus:9090），输入表达式验证：
-
1 - (jenkins_executor_idle{node="master"} / jenkins_executor_total{node="master"})→ Master 执行器实时占用率 -
rate(jenkins_queue_size_value[5m]) > 0→ 队列是否持续增长 jenkins_health_check_score{job="jenkins-master"} → 健康分告警基线
这些指标可直接用于 Grafana 绘图或 Alertmanager 告警，无需二次加工或“重定向输送”——插件已原生支持 Prometheus 数据模型与语义。
