# 日志分析与调试

URL: https://caijiao.org/gentoo/debugging
Source: docs/gentoo/debugging.md
Description: 本章介绍 Gentoo 系统日志分析与调试方法，包括系统日志查看、错误排查和故障处理技巧。

在完成备份与恢复后，下一步是 **掌握 Gentoo 系统日志分析与调试方法**，提高故障排查和系统维护能力。

## 一、系统日志概览

Gentoo 系统使用 **OpenRC** 或 **systemd**（可选）管理服务，主要日志存储在 `/var/log`：

- `/var/log/messages`：系统核心日志  
- `/var/log/dmesg`：内核启动日志  
- `/var/log/portage/elog/`：Portage 编译日志  
- `/var/log/Xorg.0.log`：Xorg 图形日志  

## 二、查看与监控日志

1. 实时查看日志：

```bash
tail -f /var/log/messages
````

2. 过滤关键内容：

```bash
grep -i error /var/log/messages
```

3. 使用 `less` 分页查看：

```bash
less /var/log/portage/elog/*
```

## 三、故障调试方法

1. **内核或模块问题**：

```bash
dmesg | less
```

- 查找驱动加载错误、硬件识别异常

2. **服务启动失败**：

```bash
rc-status
/etc/init.d/<service> status
```

- 查看服务状态与启动日志

3. **Portage 编译错误**：

- 查看 `/var/log/portage/elog/` 中的详细日志
- 检查 USE 标志、依赖包版本和编译选项

## 四、日志分析技巧

- 利用时间戳定位问题发生时间
- 对比系统升级或配置修改前后的日志
- 将错误关键字整理为常见问题列表，便于快速排查

## 五、建议操作

- 定期检查系统日志，及时发现潜在问题
- 配置日志轮转（logrotate）避免日志过大
- 在升级内核、系统或 Portage 后重点关注新日志内容