SoS 系统诊断工具快速上手指南三步完成 Linux 日志收集与排障【免费下载链接】sosA unified tool for collecting system logs and other debug information项目地址: https://gitcode.com/gh_mirrors/so/sos系统半夜报警、服务无故重启、日志刷屏却看不出头绪——这样的场景任何一个运维或开发者多少都经历过。面对满屏的报错信息最难的往往不是修而是先搞清楚发生了什么。而 SoS 系统诊断工具就是为这一刻而生的。当系统生病时你的第一反应是什么大部分人第一反应是打开日志文件一个个翻翻完syslog翻dmesg还要手动记下内核版本、软件包列表、挂载信息……忙活半天信息还是零散的。更麻烦的是当你需要向别人求助时对方会反问能把系统现状完整打包给我吗这时候你才发现凭手敲是凑不齐一套像样的证据的。SoS 要解决的正是这个痛点它是一套统一收集系统日志与调试信息的综合工具主要用 Python 编写面向 Linux 发行版以及各类类 UNIX 系统。你只需敲一条命令它就会自动把散落在系统各处的线索打包成一份结构化的诊断档案供你或技术支持人员后续分析。认识 SoS给系统请一位体检医生打个比方SoS 就像一位经验老到的体检医生。你不需要告诉它先查心脏再查血压它自己就有一套完整的检查流程内核与硬件信息、网络与服务状态、软件包与配置文件、各类日志文件……一次全流程检查最后统一出具一份体检报告。说白了它做的就是把故障现场的取证工作标准化、自动化。原来可能要花半小时手动收集的信息现在一条命令、几分钟搞定。它适用的场景非常典型服务器异常需要快速收集系统现状用于排查向厂商或社区求助时需要一份完整的诊断数据包集群或大规模环境需要批量收集多台主机的信息报告需要分享给外部但又担心泄露 IP、主机名等敏感信息。无论你是刚接触 Linux 的新手还是经验丰富的老手它都能帮你把收集信息这件琐事变得干净利落。SoS 使用教程3 分钟完成首次系统诊断下面我们按安装 → 触发一次诊断 → 查看与解读报告这条主线走一遍。整个过程清单化跟着做就能完成首次体验。第一步装好这位医生SoS 的安装方式很多样最省事的是直接用发行版自带的包管理器在 RHEL、Fedora、Rocky 等系统上dnf install sos在 Ubuntu、Debian 等系统上apt install sos如果你喜欢从源码折腾也可以把仓库克隆到本地再安装git clone https://gitcode.com/gh_mirrors/so/sos进入目录后按README的说明完成安装即可。需要提醒的是这个工具要读取系统日志和大量配置文件因此后续运行时需要管理员身份sudo这一点在用包管理器安装时通常会自动处理好。第二步触发一次诊断安装完成后最核心的子命令是sos report。最简单的用法sudo sos report --batch--batch的意思是全程免交互参数都走默认值非常适合第一次尝试。命令执行期间你会看到它逐个插件地收集信息——内核、网络、存储、服务、日志……跑完以后终端会告诉你报告存放在哪个路径通常是类似sosreport-主机名-日期-随机串.tar.xz的压缩包。如果你想知道这台机器上都能收集什么可以先看一眼全家福sudo sos report --list-plugins它会列出当前系统所有可用插件以及各自的启用状态方便你了解 SoS 的覆盖范围。第三步查看并读懂 SoS 报告把生成的压缩包解压后你会看到几个清晰的目录这也是理解报告结构的关键sos_commands/存放各类命令的执行输出比如ps、ip addr、systemctl status等sos_logs/SoS 自身的运行日志以及收集到的系统日志sos_reports/汇总信息包括主机名、内核版本、插件执行情况等。报告相关代码可以在 sos/report/ 目录里一探究竟。解压之后建议先从sos_reports看起它相当于整份报告的目录索引再按需深入sos_commands下的具体输出文件。整个结构一目了然翻起来比大海捞针式地找日志舒服多了。藏在背后的四大核心能力看完上手流程你可能好奇它凭什么一次能收集这么多信息这就要说到它的几个核心设计了。自动化采集零配置开箱即用SoS 内置了一套自动探测逻辑它会先识别当前的发行版和系统环境再决定启用哪些采集项目。你不需要写任何配置文件默认参数就能产出一份覆盖面很广的诊断报告。当然它也提供了 sos.conf 这样的全局配置文件里面按[global]、[report]、[clean]、[upload]等小节分组想调整默认行为时改这里就行。模块化插件体系按需点菜这是 SoS 最有魅力的地方。每一个采集主题都是一个独立插件比如网络、内核、数据库、容器、虚拟化等加起来有数百个之多全部集中在 sos/report/plugins/ 目录下。你可以用--only-plugins只收集关心的部分也可以用--skip-plugins跳过不需要的真正做到按需点菜。跨发行版适配一处编写处处运行SoS 不是一个只服务于某个厂商的工具。在 sos/policies/distros/ 目录下你可以看到它对 RHEL、Fedora、Ubuntu、Debian、SUSE 等主流发行版都有专门适配连软件包管理器的差异rpm、dpkg、snap 等也被妥善处理了。这意味着同一套使用习惯换一台不同系统的机器也能无缝上手。数据脱敏分享报告更安心诊断报告里往往藏着 IP 地址、主机名、用户名等敏感信息。SoS 为此内置了sos clean也叫sos mask子命令可以在分享前把报告里的敏感内容做模糊化处理。相关实现位于 sos/cleaner/。对于需要把报告发给外部支持团队的场景这一步几乎是必备操作。几个过来人的实用提醒最后分享两条经验之谈都是实践中容易踩的坑。第一别一上来就全量收集。默认情况下 SoS 会启用大量插件收集内容多、耗时长。如果问题范围明确——比如怀疑是网络或某个特定服务的问题——建议先用--only-plugins收敛范围比如只收集networking和相关服务的插件几分钟就能拿到针对性报告效率翻倍。第二报告分享前务必先清洗一遍。很多人第一次用sos report拿到报告就直接发给别人了殊不知里面的 IP、主机名、密钥片段都是敏感信息。养成先跑一遍sos clean的习惯既保护自己也让对方收到一份干净的数据。顺带一提如果报告需要加密传输sos report也支持--encrypt-pass之类的参数需要时可以查阅帮助。写在最后从会用走向会玩回到开头那个场景当系统再次闹脾气你不再需要手忙脚乱地翻日志了。一条sos report几分钟后就能拿到一份结构完整、内容全面的诊断档案——这就是 SoS 系统诊断工具带来的从容。如果你对它背后的实现感兴趣官方文档在 docs/ 目录里源码结构清晰、注释完整从入口sos report一路读下去很快就能摸清它的设计脉络。从会用到会玩其实只差一次认真的阅读。愿下次排障时你能多一份笃定。【免费下载链接】sosA unified tool for collecting system logs and other debug information项目地址: https://gitcode.com/gh_mirrors/so/sos创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SoS 系统诊断工具快速上手指南三步完成 Linux 日志收集与排障【免费下载链接】sosA unified tool for collecting system logs and other debug information项目地址: https://gitcode.com/gh_mirrors/so/sos系统半夜报警、服务无故重启、日志刷屏却看不出头绪——这样的场景任何一个运维或开发者多少都经历过。面对满屏的报错信息最难的往往不是修而是先搞清楚发生了什么。而 SoS 系统诊断工具就是为这一刻而生的。当系统生病时你的第一反应是什么大部分人第一反应是打开日志文件一个个翻翻完syslog翻dmesg还要手动记下内核版本、软件包列表、挂载信息……忙活半天信息还是零散的。更麻烦的是当你需要向别人求助时对方会反问能把系统现状完整打包给我吗这时候你才发现凭手敲是凑不齐一套像样的证据的。SoS 要解决的正是这个痛点它是一套统一收集系统日志与调试信息的综合工具主要用 Python 编写面向 Linux 发行版以及各类类 UNIX 系统。你只需敲一条命令它就会自动把散落在系统各处的线索打包成一份结构化的诊断档案供你或技术支持人员后续分析。认识 SoS给系统请一位体检医生打个比方SoS 就像一位经验老到的体检医生。你不需要告诉它先查心脏再查血压它自己就有一套完整的检查流程内核与硬件信息、网络与服务状态、软件包与配置文件、各类日志文件……一次全流程检查最后统一出具一份体检报告。说白了它做的就是把故障现场的取证工作标准化、自动化。原来可能要花半小时手动收集的信息现在一条命令、几分钟搞定。它适用的场景非常典型服务器异常需要快速收集系统现状用于排查向厂商或社区求助时需要一份完整的诊断数据包集群或大规模环境需要批量收集多台主机的信息报告需要分享给外部但又担心泄露 IP、主机名等敏感信息。无论你是刚接触 Linux 的新手还是经验丰富的老手它都能帮你把收集信息这件琐事变得干净利落。SoS 使用教程3 分钟完成首次系统诊断下面我们按安装 → 触发一次诊断 → 查看与解读报告这条主线走一遍。整个过程清单化跟着做就能完成首次体验。第一步装好这位医生SoS 的安装方式很多样最省事的是直接用发行版自带的包管理器在 RHEL、Fedora、Rocky 等系统上dnf install sos在 Ubuntu、Debian 等系统上apt install sos如果你喜欢从源码折腾也可以把仓库克隆到本地再安装git clone https://gitcode.com/gh_mirrors/so/sos进入目录后按README的说明完成安装即可。需要提醒的是这个工具要读取系统日志和大量配置文件因此后续运行时需要管理员身份sudo这一点在用包管理器安装时通常会自动处理好。第二步触发一次诊断安装完成后最核心的子命令是sos report。最简单的用法sudo sos report --batch--batch的意思是全程免交互参数都走默认值非常适合第一次尝试。命令执行期间你会看到它逐个插件地收集信息——内核、网络、存储、服务、日志……跑完以后终端会告诉你报告存放在哪个路径通常是类似sosreport-主机名-日期-随机串.tar.xz的压缩包。如果你想知道这台机器上都能收集什么可以先看一眼全家福sudo sos report --list-plugins它会列出当前系统所有可用插件以及各自的启用状态方便你了解 SoS 的覆盖范围。第三步查看并读懂 SoS 报告把生成的压缩包解压后你会看到几个清晰的目录这也是理解报告结构的关键sos_commands/存放各类命令的执行输出比如ps、ip addr、systemctl status等sos_logs/SoS 自身的运行日志以及收集到的系统日志sos_reports/汇总信息包括主机名、内核版本、插件执行情况等。报告相关代码可以在 sos/report/ 目录里一探究竟。解压之后建议先从sos_reports看起它相当于整份报告的目录索引再按需深入sos_commands下的具体输出文件。整个结构一目了然翻起来比大海捞针式地找日志舒服多了。藏在背后的四大核心能力看完上手流程你可能好奇它凭什么一次能收集这么多信息这就要说到它的几个核心设计了。自动化采集零配置开箱即用SoS 内置了一套自动探测逻辑它会先识别当前的发行版和系统环境再决定启用哪些采集项目。你不需要写任何配置文件默认参数就能产出一份覆盖面很广的诊断报告。当然它也提供了 sos.conf 这样的全局配置文件里面按[global]、[report]、[clean]、[upload]等小节分组想调整默认行为时改这里就行。模块化插件体系按需点菜这是 SoS 最有魅力的地方。每一个采集主题都是一个独立插件比如网络、内核、数据库、容器、虚拟化等加起来有数百个之多全部集中在 sos/report/plugins/ 目录下。你可以用--only-plugins只收集关心的部分也可以用--skip-plugins跳过不需要的真正做到按需点菜。跨发行版适配一处编写处处运行SoS 不是一个只服务于某个厂商的工具。在 sos/policies/distros/ 目录下你可以看到它对 RHEL、Fedora、Ubuntu、Debian、SUSE 等主流发行版都有专门适配连软件包管理器的差异rpm、dpkg、snap 等也被妥善处理了。这意味着同一套使用习惯换一台不同系统的机器也能无缝上手。数据脱敏分享报告更安心诊断报告里往往藏着 IP 地址、主机名、用户名等敏感信息。SoS 为此内置了sos clean也叫sos mask子命令可以在分享前把报告里的敏感内容做模糊化处理。相关实现位于 sos/cleaner/。对于需要把报告发给外部支持团队的场景这一步几乎是必备操作。几个过来人的实用提醒最后分享两条经验之谈都是实践中容易踩的坑。第一别一上来就全量收集。默认情况下 SoS 会启用大量插件收集内容多、耗时长。如果问题范围明确——比如怀疑是网络或某个特定服务的问题——建议先用--only-plugins收敛范围比如只收集networking和相关服务的插件几分钟就能拿到针对性报告效率翻倍。第二报告分享前务必先清洗一遍。很多人第一次用sos report拿到报告就直接发给别人了殊不知里面的 IP、主机名、密钥片段都是敏感信息。养成先跑一遍sos clean的习惯既保护自己也让对方收到一份干净的数据。顺带一提如果报告需要加密传输sos report也支持--encrypt-pass之类的参数需要时可以查阅帮助。写在最后从会用走向会玩回到开头那个场景当系统再次闹脾气你不再需要手忙脚乱地翻日志了。一条sos report几分钟后就能拿到一份结构完整、内容全面的诊断档案——这就是 SoS 系统诊断工具带来的从容。如果你对它背后的实现感兴趣官方文档在 docs/ 目录里源码结构清晰、注释完整从入口sos report一路读下去很快就能摸清它的设计脉络。从会用到会玩其实只差一次认真的阅读。愿下次排障时你能多一份笃定。【免费下载链接】sosA unified tool for collecting system logs and other debug information项目地址: https://gitcode.com/gh_mirrors/so/sos创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
)
