Golang日志在CentOS如何进行故障排查

一、配置结构化日志记录（基础排查前提）

结构化日志（如JSON格式）能提升日志的可读性与可分析性，便于后续用工具过滤、聚合。推荐使用zap（高性能）或logrus（易扩展）第三方库，避免标准库log的结构化能力不足问题。

zap示例：通过WithFields添加上下文信息（如请求ID、模块名），便于快速定位问题模块。

package main
import (
    "go.uber.org/zap"
)
func main() {
    logger, _ := zap.NewProduction()
    defer logger.Sync()
    logger.Info("User login success",
        zap.String("userID", "123"),
        zap.String("ip", "192.168.1.1"),
    )
}

logrus示例：支持JSON Formatter，方便日志聚合工具解析。

package main
import (
    "github.com/sirupsen/logrus"
    "os"
)
func main() {
    logger := logrus.New()
    logger.SetFormatter(&logrus.JSONFormatter{})
    logger.SetOutput(os.Stdout)
    logger.WithFields(logrus.Fields{
        "module": "auth",
        "status": "success",
    }).Info("User logged in")
}

二、实时查看与过滤日志（快速定位问题）

使用tail命令实时监控日志文件的最新内容，结合grep过滤关键信息（如ERROR级别、特定模块），快速缩小问题范围。

实时查看日志：
```
tail -f /var/log/golang-app.log
```
过滤ERROR日志：
```
grep "ERROR" /var/log/golang-app.log
```
按时间范围过滤：若日志包含时间戳（如zap默认的ISO8601格式），可通过awk提取特定时间段日志（如2025-10-31 14:00至15:00）：
```
awk '/2025-10-31 14:00:00/,/2025-10-31 15:00:00/' /var/log/golang-app.log
```

三、日志轮转（避免日志膨胀）

当日志文件过大时，使用logrotate工具自动切割、压缩归档旧日志，防止占用过多磁盘空间（如CentOS默认日志目录/var/log空间耗尽）。

配置logrotate：在/etc/logrotate.d/golang-app中添加以下配置（按天切割，保留7天，压缩旧日志）：
```
/var/log/golang-app.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
    create 0640 root root
}
```
手动触发轮转：若需立即切割日志，可执行：
```
sudo logrotate -f /etc/logrotate.d/golang-app
```

四、结合监控告警（主动发现问题）

通过Prometheus+Grafana搭建日志监控体系，收集Golang应用的日志指标（如ERROR日志数量、请求延迟），设置阈值告警（如ERROR日志每分钟超过10条时发送邮件/短信）。

Prometheus配置：编辑/etc/prometheus/prometheus.yml，添加Golang应用的metrics端点（需在应用中集成Prometheus客户端，如prometheus/client_golang）：
```
scrape_configs:
  - job_name: 'golang-app'
    static_configs:
      - targets: ['localhost:9090']  # 应用的metrics端口
```
Grafana仪表盘：导入Golang应用的监控模板（如Grafana官方的“Golang”模板），可视化日志指标，设置告警规则（如ERROR日志速率上升时触发告警）。

五、使用调试工具（深入分析问题）

当日志信息不足以定位问题（如内存泄漏、死锁）时，使用Delve（Golang专用调试工具）进行代码级调试，逐步执行代码并观察变量状态。

安装Delve：

go install github.com/go-delve/delve/cmd/dlv@latest

启动调试会话：
```
dlv debug /path/to/your/golang-app
```
常用调试命令：
- break main.main：在main函数入口设置断点；
- continue：继续执行程序；
- next：单步执行（跳过函数调用）；
- print variable：打印变量值（如print userID）。

六、检查系统与依赖（排除外部因素）

若应用日志无明显错误，需检查系统环境与依赖服务是否正常：

查看系统日志：使用journalctl查看应用所属服务的系统日志（如应用以systemd方式运行），排查系统级错误（如权限不足、端口冲突）：
```
journalctl -u your-golang-app.service
```
检查资源使用：使用top、free -m、df -h分别查看CPU、内存、磁盘空间使用情况，排除资源耗尽导致的故障（如内存泄漏导致OOM）。
验证依赖服务：若应用依赖数据库、Redis等外部服务，使用ping、telnet或nc检查网络连通性，确保依赖服务正常运行（如数据库端口是否可达）。

七、代码审查与回滚（解决根本问题）

若以上步骤均无法定位问题，需通过代码审查找出潜在bug（如空指针引用、死循环），或回滚到之前的稳定版本（使用Git等版本控制工具），通过对比差异定位引入问题的代码变更。

代码审查重点：检查近期修改的代码（尤其是涉及网络请求、数据库操作、并发处理的逻辑），确认是否存在未处理的错误（如if err != nil遗漏）。

版本回滚：

git checkout <stable-commit-hash>  # 回滚到指定提交
go build && ./your-golang-app      # 重新编译运行