Ubuntu 上查看 Jenkins 日志的常用方法
一 系统日志文件查看
- 主要日志文件位于：/var/log/jenkins/jenkins.log。常用命令：
- 实时查看最新日志：sudo tail -f /var/log/jenkins/jenkins.log
- 查看最近 N 行（如 200 行）：sudo tail -n 200 /var/log/jenkins/jenkins.log
- 分页查看：sudo less /var/log/jenkins/jenkins.log
- 关键字检索：sudo grep “ERROR” /var/log/jenkins/jenkins.log
- 如目录或文件不存在，先确认服务是否运行：sudo systemctl status jenkins
- 日志目录通常为 /var/log/jenkins/，可按需查看该目录下的其他相关日志文件。
二 Web 界面查看
- 进入 Manage Jenkins → System Log（或 Manage Logs），可查看系统级日志，并在页面中进一步查看各类日志详情。
- 查看某次构建的输出：进入对应 Job → Build History → 选择具体构建 → Console Output，用于定位构建过程与任务执行细节。
三 构建日志与 CLI 方式
- 使用 Jenkins CLI 获取某任务的构建日志：
- 下载 CLI：wget http://:8080/cli.jar
- 获取日志：java -jar cli.jar -s http://:8080/ -auth : build log
- 将 、、、 替换为实际值。
四 服务状态与故障排查
- 快速检查服务状态与启动失败原因：sudo systemctl status jenkins，结合 /var/log/jenkins/jenkins.log 的错误信息进行定位。
- 常见检查项：
- 端口占用：sudo lsof -i :8080 或 sudo netstat -tulnp | grep 8080
- 权限问题：确保 /var/lib/jenkins、/var/cache/jenkins、/var/log/jenkins 归属 jenkins:jenkins
- 配置变更后重载并重启：sudo systemctl daemon-reload && sudo systemctl restart jenkins
- Java 环境：java -version，必要时安装合适版本（如 openjdk-11-jdk）。
五 日志轮转与长期分析
- 为避免日志占满磁盘，建议配置 logrotate 对 /var/log/jenkins/jenkins.log 做按日/按大小轮转与保留策略。
- 如需集中分析与可视化，可将日志接入 ELK Stack（Elasticsearch、Logstash、Kibana） 或 LogAnalyzer 等方案。
