如何快速高效地查看Ubuntu Gitlab日志，精准定位Gitlab问题？

在使用 GitLab 的过程中，日志往往是定位问题的关键。但常常会遇到日志文件过大、查找困难、滚动回溯慢等痛点。下面通过结构化的步骤与实用命令。让你在 Ubuntu 上快速高效地查看 GitLab 日志，精准定位各种异常。

一、了解 GitLab 日志目录与主要文件

GitLab 的所有主要日志都集中在 /var/log/gitlab 下按服务划分如下：

• gitlab‑rails/var/log/gitlab/gitlab‑rails/production.log
• nginx/var/log/gitlab/nginx/gitlab_access.log,/var/log/gitlab/nginx/gitlab_error.log
• sidekiq/var/log/gitlab/sidekiq/sidekiq.log
• builds & CI/CD 作业日志/var/log/gitlab/builds/*/*.log
• 其他服务: 对应子目录。

如果你还不知道这些位置，可以用 或者直接查看 .

直接读取关键日志文件

# 查看 Rails production 日志
sudo less /var/log/gitlab/gitlab-rails/production.log
# 查看 Nginx 错误日志
sudo less /var/log/gitlab/nginx/gitlab_error.log

实时跟踪

# 实时跟踪 Rails 日志
sudo gitlab-ctl tail gitlab-rails/production.log
# 实时跟踪 Nginx 错误
sudo gitlab-ctl tail nginx/gitlab_error.log

二、利用程序工具快速定位错误信息

Sudo 权限下可用以下工具：

• journalctl:

# 查看 gitlab 相关 systemd 单元
sudo journalctl -u gitlab-runsvdir.service -f
# 或单个组件。例如 rails：
sudo journalctl -u gitlab-runsvdir@gitlab‑rails.service -f

• `tail` 与 `grep` 的组合：

# 查看最近 100 行，并过滤错误关键词
sudo tail -n 100 /var/log/gitlab/gitlab‑rails/production.log | grep -i error
# 实时监控并筛选特定关键词
sudo tail -f /var/log/gitlab/nginx/gitlab_error.log | grep --line-buffered 'timeout'

• `awk` 与 `sed` 用于结构化分析：

# 提取时间戳和错误等级
sudo awk '/ERROR/{print $1,$2,$0}' /var/log/gitlab/sidekiq/sidekiq.log | head

Pain Point #1：日志太大导致搜索慢？从方法来看，先使用 `head`。`tail` 定位到大致区块，再用 `grep` 精确筛选。

三、管理和旋转日志

`logrotate` 是 Ubuntu 默认的日志轮转工具，可通过配置保持历史记录并压缩旧文件。



`logrotate` 手动触发与检查配置：

# 强制执行一次轮转
sudo logrotate -f /etc/logrotate.d/gitlab
# 查看当前轮转状态和剩余空间：
ls -lh /var/log/gitlab/* | grep .gz$
# 或者检查最近一次轮转时间：
stat /var/log/gitlab/*.log.gz | grep Modify

Pain Point #2：忘记设置轮转导致磁盘爆满？至于方法，确保 `/etc/logrotate.d/gitlog` 中包含以下基本条目：

• /var/log/gitalb/*/*.log {}
• daily missingok rotate 14 compress notifempty create 640 root root
• postrotate /usr/bin/sudo gitlabshell reload;按理说，endscript
⚠️ 请根据实际方法和需求自行调整。

Pain Point #3：频繁出现“Error while rotating logs” 原因可能是权限不足或方法不匹配。检查 `` 使用者是否有读写权限，并确认配置方法无误。

操作步骤的观点是，

• - 确认 `/etc/group` 中包含 `gitops` 使用者组；
• - 使用 `chmod 644 /etc/logrotate.d/*` 给配置文件读权限；
• - 重启 `rsyslogd`: `sudo systemctl restart rsyslog`

Pain Point #4：想要保留历史但又不想占太多空间？说到方案一，减少保留天数；方案二：开启 gzip 压缩；方案三：设置分区挂载点专门存放旧日誌。

---

四、实战排查命令组合

下面是一组常用命令组合。可在一个脚本或终端中连贯执行，从而省去手动切换文件的烦恼。

1. Migrate all services’ latest logs into one view:

   sudu sh -c 'for f in $;do echo "--- $ ---";tail -n10 $f;done'
   

2. Solve “timeout” or “connection refused” errors quickly: sudu bash -c ' echo "=== NGINX ERRORS ===";sudo grep timeout /var/log/gitalb/nginx/*.log;echo "=== POSTGRESQL LOGS ===";sudo grep connection_refused /var/lib/postgresql/data/server.log;'">;

---

© 2026 Ubuntu & GitLab Community.