Jenkins中Bot用户触发GitHub API限流问题排查求助

遇到这种Bot触发API限流的情况确实闹心，尤其是找不到具体是哪个Jenkins任务在“疯狂输出”的时候。下面给你梳理几个靠谱的定位思路，还有你关心的调用记录查询方案：

一、先搞清楚当前限流的详细状态 #

首先调用GitHub的Rate Limit API，确认剩余额度、重置时间，以及是否真的是Bot的额度被耗尽：

curl -H "Authorization: token YOUR_BOT_TOKEN" https://api.github.com/rate_limit

返回结果里的rate字段会显示limit（总限额）、remaining（剩余次数）、reset（重置时间戳），能帮你确认是不是当前请求量真的超过了5000次/小时的限制。

二、排查Jenkins侧的请求来源 #

这是最直接的定位方式，毕竟所有请求都是从Jenkins任务发起的：

• 检查单个任务的控制台日志：逐个查看近期执行的Jenkins任务，搜索包含api.github.com的日志，看看有没有高频调用的任务（比如循环调用API的脚本、配置错误的插件）。
• 用Jenkins插件批量分析日志：安装Log Parser Plugin或者Console Log Filter Plugin，批量扫描所有任务的日志，统计每个任务中GitHub API请求的次数，快速找出调用量最高的那个。
• 开启插件调试日志：如果是Jenkins的GitHub相关插件（比如GitHub Integration Plugin、Pipeline GitHub Plugin）在发起请求，你可以在Jenkins的「系统管理」→「系统日志」里，把对应插件的日志级别改成DEBUG，这样会记录每个API请求的详细信息，包括发起的任务名称、请求端点。

三、利用GitHub的审计日志（组织/企业账号专属） #

如果你的Bot属于GitHub组织或企业账号，那审计日志就是神器：

• 登录GitHub组织后台，进入「Settings」→「Audit log」，筛选该Bot账号的操作记录，能看到每个API调用的时间、请求端点、发起IP（可以对应到你的Jenkins服务器IP），甚至能关联到具体的仓库或操作。你可以按时间范围筛选最近一分钟的记录，精准定位高频请求。

四、实时监控Bot的API请求 #

如果上面的方法还找不到，就直接在Jenkins服务器上抓包或代理请求：

• 用tcpdump实时抓包：执行下面的命令，过滤所有使用Bot token的GitHub API请求，能实时看到请求的端点、时间，甚至请求内容：

  tcpdump -i any host api.github.com and port 443 -A | grep "Authorization: token YOUR_BOT_TOKEN"
  

• 用代理工具记录请求：比如用mitmproxy做中间代理，让Jenkins的请求通过代理转发，这样能完整记录所有Bot发起的API请求，包括请求的来源进程（对应Jenkins任务的执行进程），轻松定位到具体任务。

五、关于“列出最近一分钟API调用记录”的问题 #

• 如果你是组织/企业账号，直接用上面提到的GitHub审计日志，就能筛选出最近一分钟的所有调用记录。
• 个人Bot账号的话，GitHub没有直接的API返回历史调用记录，但可以通过上面的实时抓包/代理监控来实现，或者在调用API的脚本里主动添加日志：比如在每个API请求前，记录当前Jenkins任务名称、时间、请求端点到日志文件，这样事后就能回溯。

额外的预防建议 #

• 尽量给每个Jenkins任务分配独立的GitHub token，这样一旦某个任务限流，能直接定位到它，不用排查所有任务。
• 给所有GitHub API调用添加限流逻辑，比如用backoff库实现指数退避，确保每个任务的请求频率不超过每分钟1次的预期。

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