Linux 生成 Sosreport 系統診斷報告完整指南

什麼是 Sosreport？

sosreport 是 Red Hat/CentOS 系統自帶的診斷信息收集工具，會打包收集：內核版本、已加載模塊、系統/服務配置文件、硬件信息、日誌、網絡設置、掛載點等，**是向 Red Hat 提交技術支持案例時的必備附件**。

安裝與前置條件

# 通常預裝，若無則安裝
yum install sos -y

# 需 root 權限運行

基本用法

# 默認生成報告（交互式詢問案例號、用戶名等）
sosreport

# 非交互式指定參數
sosreport --batch --case-id=01234567 --customer="Company Name"

# 指定輸出目錄（默認 /var/tmp）
sosreport --tmp-dir /tmp

執行通常需 幾分鐘，完成後在 /tmp 或 /var/tmp 生成壓縮包（.tar.xz、.tar.gz 或 .tar.bz2）。

模塊化控制：啟用/禁用特定插件

Sosreport 採用插件架構，可精確控制收集範圍：

列出所有可用插件

sosreport -l
# 或
sosreport --list-plugins

禁用特定插件（如跳過耗時的 kvm、amd 檢查）

sosreport -n kvm,amd
# 或
sosreport --skip-plugins=kvm,amd

啟用特定插件（僅運行指定插件）

sosreport -e network,filesys
# 或
sosreport --enable-plugins=network,filesys

傳遞插件專屬參數（-k/--plugin-option）

# 禁用 rpm 插件的 rpm -Va 檢查（耗時）
sosreport -k rpm.rpmva=off

# 限制日誌收集行數
sosreport -k logs.max_lines=5000

常用插件速查

報告提交與分析

• 將生成的壓縮包作為附件上傳至 Red Hat Customer Portal 案例
• 本地解壓查看：tar -xvf sosreport-*.tar.xz，內含 sos_commands/ 目錄按類別存放命令輸出
• 常用分析入口：sos_commands/kernel/、sos_commands/network/、sos_commands/filesys/

最佳實踐建議

1. 定期主動收集：建立定時任務每周生成一次，建立基線，故障時對比
2. 故障現場優先：發生問題**立即**生成，避免日誌輪轉丟失關鍵信息
3. 精簡模式：明確問題領域時用 -e 僅啟用相關插件，大幅縮短耗時
4. 脫機環境：離線系統可用 sosreport --batch 免交互生成，後拷貝傳輸