ThinkPHP怎样监控Swap交换_Swap交换空间监控【内存】

当你的 ThinkPHP 应用跑着跑着，突然响应变慢、内存压力飙升、甚至出现 OOM（内存耗尽）错误，十有八九是系统 Swap 交换空间被大量使用——背后就是物理内存已经快扛不住了。

遗憾的是，ThinkPHP 本身并不自带 Swap 监控，你得借助系统命令、内核文件，或与外部监控工具协作来采集真实状态。下面这五种方法可以落地，覆盖从简单到复杂的场景。

一、直接调系统命令，拿实时 Swap 数据

这个方法最简单：用 PHP 的 shell_exec() 调用 Linux 原生命令，直接读取内核暴露的 Swap 统计信息。好处是无需额外扩展，CentOS、Ubuntu、甚至 macOS 都能用（命令格式稍作调整即可）。适合放在定时任务或运维接口里，按需触发。

具体几步走：

• 在 ThinkPHP 控制器或命令行指令中写采集逻辑，比如创建一个 php think system:swap 命令；
• 用 swapon -s 命令列出当前启用的交换设备路径和大小（单位是 KB）；
• 再用 free -m 命令，提取第三行 Swap 行的 used 和 total 字段（单位是 MB）；
• 把结果格式化成 JSON 或数组，方便记录日志或前端展示，比如 {"total_mb":2048,"used_mb":426,"usage_percent":20.8}；
• 别忘了加异常处理——如果 swapon -s 返回空或 free 报错，就返回“Swap 未启用或权限不足”提示，跳过后续计算。

二、读 /proc/meminfo 文件，避免命令注入风险

这个方法更安全，它绕过外部命令执行，直接读取 Linux 内核提供的 /proc/meminfo 文件。这样做的好处很明显：没有命令注入风险，也没有 fork 开销，适合高频轻量检查。文件里 SwapTotal 和 SwapFree 两个字段，精确反映了当前 Swap 配置和剩余容量。

• 用 file_get_contents('/proc/meminfo') 抓取原始内容；
• 用正则把 SwapTotal:\s+(\d+)\s+kB 和 SwapFree:\s+(\d+)\s+kB 这两行数值提取出来；
• 计算已用 Swap：used = total - free，单位统一为 MB，并保留一位小数；
• 如果读取失败（比如权限拒绝或文件不存在），记录警告日志，并返回默认值 0 MB used；
• 建议设置超时和重试机制，防止 I/O 卡顿阻塞整个 PHP 请求周期。

三、集成到日志通道，自动触发告警

把 Swap 监控嵌入日志系统，是一种低侵入式的状态捕获方案。通过自定义日志处理器，每次写入 error 或 critical 级别日志时，顺便附上当前 Swap 使用率，方便事后回溯故障根因。

• 在 config/log.php 中新增一个叫 swap_monitor 的通道，类型设为 custom；
• 写一个自定义处理器类，继承 think\log\driver\File，重写 write() 方法——在写入前调用 getSwapUsage() 获取当前值；
• 当 Swap 使用率 ≥ 70% 时，自动向指定通道（比如钉钉 Webhook 或邮件）发告警，内容包含时间戳、主机名和详细数值；
• 配置日志级别为 notice 或更高，避免 debug 模式下产生冗余输出；
• 确保这个通道只在生产环境启用，开发环境禁用，不然性能受影响。

四、上系统级监控工具，对接运行指标

用 Prometheus + Node Exporter 搭建长期可观测性，把 Swap 指标作为独立维度暴露出来。然后通过 ThinkPHP 的 HTTP 客户端定期拉取或推送到指标服务，实现跨服务的统一视图。

• 部署 Node Exporter，确认 node_memory_SwapTotal_bytes 和 node_memory_SwapFree_bytes 指标已经采集到；
• 在 ThinkPHP 中用 think\Http 发起 GET 请求到 http://localhost:9100/metrics，解析文本格式指标；
• 提取对应指标行，计算使用率并缓存到 Redis，设置 TTL 为 30 秒，防止重复拉取；
• 在后管页面通过 AJAX 轮询这个缓存键，动态渲染 Swap 使用进度条和颜色预警（绿色 < 50%，黄色 50–85%，红色 > 85%）；
• 如果请求失败或指标缺失，前端显示 监控服务不可用，不中断主业务流程。

五、结合物理内存和进程数据，做交叉分析

Swap 的数值本身只是表面现象，必须结合物理内存压力和进程内存占用一起看，才能判断问题的本质——到底是内存泄漏、缓存膨胀，还是突发流量引发的 Swap 激活。

• 同步采集 /proc/meminfo 里的 MemA vailable、Buffers、Cached 字段，计算真实可用内存；
• 执行 ps aux --sort=-%mem | head -n 10，拿到内存占用 Top 10 的进程，重点关注 PHP-FPM 子进程的 RSS 值；
• 如果发现 MemA vailable 持续低于 500MB 且 SwapUsed 大于 0，基本可以判定物理内存严重不足；
• 如果 MemA vailable 很充足，但 SwapUsed 非零，就要检查是否有休眠进程或内核模块异常占用；
• 最后把这三种指标组合成一个结构化数组，写入 runtime/cache/swap_diagnosis.php，供诊断脚本调用。