如何获取Jenkins节点在线时间及实现节点更新重启后恢复资源调度

开发者阿泽

2026-5-25

嘿，咱们逐个解决你的这两个Jenkins问题——这些都是我日常工作里常碰到的场景：

1. 如何获取Jenkins节点的在线时间？

有几种实用的方法，根据你的使用场景选就行：

通过Jenkins UI直接查看
进入Jenkins主页 → 左侧点「Manage Jenkins」→ 「Manage Nodes and Clouds」→ 选中目标节点，在详情页的「状态」或「节点属性」区域，能看到Connected since（连接时间），从这个时间到现在的间隔就是在线时长。
通过Jenkins REST API查询
调用节点的API接口：GET http://<你的Jenkins地址>/computer/<节点名称>/api/json，返回的JSON里有lastOnlineTimestamp或connectedTime字段（不同Jenkins版本可能字段名略有不同），拿到时间戳后就能算出具体在线时长。

用Groovy脚本在控制台执行
进入「Manage Jenkins」→ 「Script Console」，运行下面的脚本（替换成你的节点名称）：

def nodeName = "你的Slave节点名称"
def node = Jenkins.instance.getComputer(nodeName)
if (node?.isOnline()) {
    def connectedSince = node.getConnectTime()
    def duration = System.currentTimeMillis() - connectedSince
    def hours = duration / (1000 * 60 * 60)
    def minutes = (duration % (1000 * 60 * 60)) / (1000 * 60)
    println "节点 ${nodeName} 已在线 ${hours.intValue()} 小时 ${minutes.intValue()} 分钟"
} else {
    println "节点 ${nodeName} 当前离线"
}

这个脚本会直接计算并输出在线时长，适合批量查询或者自动化场景。

2. 监控更新重启后的Slave节点，确保真正恢复在线

你说的这个问题太真实了——发了重启指令后，节点可能因为进程没立刻终止、Jenkins代理没及时断开，导致在线状态延迟变化，只看在线状态确实不靠谱。分享几个我常用的解决方案：

结合「离线原因」和「最后活动时间」判断
触发更新重启前，先给节点设置一个自定义离线原因，比如用Groovy脚本：
```
def node = Jenkins.instance.getComputer("你的Slave节点名称")
node.setTemporarilyOffline(true, new hudson.slaves.OfflineCause.ByCLI("正在执行更新重启操作"))
```
然后监控的时候，不能只看是否在线，还要同时满足两个条件：
1. 之前设置的自定义离线原因已经消失
2. 节点的lastActivityTimestamp有更新（说明重启后有新的心跳或任务执行）
  这样才能确认节点是真的完成重启并恢复可用。
在节点启动流程里加「上线通知钩子」
在Slave节点的启动脚本里，等Jenkins代理成功启动并连接到Master后，主动通知你的调度器。比如：
- Linux节点：在代理启动脚本末尾加一段curl请求
```
# 代理启动成功后通知调度器
curl -X POST http://你的调度器地址/notify-node-online -d "node=你的Slave节点名称"
```
- Windows节点：在启动bat脚本最后加对应的PowerShell请求
  这种方式最直接，只有当代理完全正常运行时才会触发通知，完全避开状态延迟的问题。
用Jenkins事件监听做精准触发
可以用Jenkins的脚本控制台配合事件监听，监听节点的OnlineEvent和OfflineEvent。不过要注意区分是重启后的上线还是其他情况，你可以提前给节点加个自定义标记（比如节点属性），监听事件时过滤出带有这个标记的节点上线事件，再通知调度器。
外部监控工具双重验证
配合Prometheus+Grafana或者Zabbix这类工具，监控Slave节点的系统指标：比如Jenkins代理进程是否存在、进程启动时间是否是最新的、CPU负载是否恢复正常。等Jenkins显示在线，同时这些指标也符合预期，再通知调度器，这样更稳妥。

内容的提问来源于stack exchange，提问作者Danny Staple