GitLab Linux配置中的日志管理

GitLab Linux配置中的日志管理

一、日志文件位置

GitLab在Linux系统中的日志文件集中存储于/var/log/gitlab目录下，按组件分类管理，常见日志文件及路径如下：

GitLab Rails应用日志：/var/log/gitlab/gitlab-rails/production.log（记录应用主要请求、操作信息）；
异常日志：/var/log/gitlab/gitlab-rails/production_json.log（JSON格式的异常堆栈信息，便于程序分析）；
Sidekiq后台任务日志：/var/log/gitlab/sidekiq/current（记录异步任务执行状态，如CI流水线、定时任务）；
Nginx访问/错误日志：/var/log/gitlab/nginx/gitlab_access.log（HTTP请求记录）、/var/log/gitlab/nginx/gitlab_error.log（Nginx服务错误信息）；
GitLab Shell日志：/var/log/gitlab/gitlab-shell/gitlab-shell.log（记录SSH密钥验证、Git命令执行等操作）；
Unicorn Web服务器日志：/var/log/gitlab/unicorn/unicorn_stdout.log（Web请求处理日志）。

二、实时查看日志

GitLab提供gitlab-ctl命令行工具，可便捷地实时查看日志：

查看所有服务日志：sudo gitlab-ctl tail（输出GitLab所有组件的实时日志流）；
查看特定组件日志：sudo gitlab-ctl tail <组件名>（如sudo gitlab-ctl tail gitlab-rails查看Rails应用日志，sudo gitlab-ctl tail nginx查看Nginx日志）；
查看特定日志文件：sudo gitlab-ctl tail <日志路径>（如sudo gitlab-ctl tail nginx/gitlab_error.log查看Nginx错误日志）。

三、日志轮转配置

日志轮转用于防止日志文件无限增长，GitLab支持两种轮转方式：

1. 内置Logrotate（推荐）

GitLab Omnibus包内置logrotate服务，可通过/etc/gitlab/gitlab.rb文件自定义配置：

# 全局默认配置（影响大多数服务）
logging['logrotate_frequency'] = "daily"    # 轮转频率：daily（每天）、weekly（每周）、monthly（每月）
logging['logrotate_size'] = nil           # 按大小轮转（nil表示不启用，如需启用可设为"200M"）
logging['logrotate_rotate'] = 30           # 保留日志文件数量（如30表示保留最近30个）
logging['logrotate_compress'] = "compress" # 压缩方式（gzip，压缩后缀为.gz）
logging['logrotate_method'] = "copytruncate" # 轮转方法（copytruncate：复制原文件后清空，避免服务中断）

# 特定服务覆盖配置（如Nginx）
nginx['logrotate_frequency'] = nil
nginx['logrotate_size'] = "200M"  # Nginx日志按200M大小轮转

修改后需执行以下命令使配置生效：

sudo gitlab-ctl reconfigure  # 重新生成logrotate配置文件
sudo gitlab-ctl restart      # 重启GitLab服务

2. Runit日志管理（旧版本）

对于使用Runit管理的GitLab版本（如早期Omnibus包），可通过/etc/gitlab/gitlab.rb配置svlogd参数：

logging['svlogd_size'] = 200 * 1024 * 1024  # 单个日志文件最大200MB
logging['svlogd_num'] = 30                # 保留30个轮转日志文件
logging['svlogd_timeout'] = 24 * 60 * 60   # 每24小时强制轮转一次
logging['svlogd_filter'] = "gzip"          # 使用gzip压缩轮转后的日志

修改后同样需执行sudo gitlab-ctl reconfigure和sudo gitlab-ctl restart生效。

四、日志级别调整

GitLab支持调整日志级别，控制日志输出的详细程度（级别从低到高：:debug→:info→:warn→:error→:fatal→:unknown）。默认级别为:info，可根据需求修改：

# 调整Rails应用日志级别（最常用）
gitlab_rails['log_level'] = :debug  # 开发调试时可设为debug，生产环境建议设为info或warn

# 调整Sidekiq日志级别
sidekiq['log_level'] = :warn        # 后台任务日志设为warn，减少无关信息