在 docker 中,`docker stats` 命令默认不直接显示 swap 分区占用情况。要监控容器的 swap 使用量,需要结合 linux 内核的 cgroup v2 机制或手动解析 `/sys/fs/cgroup` 下的文件。对于使用 cgroup v2 的系统(如较新的 ubuntu、fedora),可以通过 `docker stats --format` 配合自定义模板来提取 swap 数据,或者直接使用 `docker inspect` 获取更详细的资源信息。如果系统仍在使用 cgroup v1,则 `docker stats` 本身无法直接提供 swap 指标,需借助外部工具如 `cgroups` 命令行工具或编写脚本读取 cgroup 文件系统。

cgroup v2 下如何提取 Swap 统计
在支持 cgroup v2 的环境中,Docker 容器内的 Swap 使用情况存储在 `/sys/fs/cgroup/docker/

{
"Name": "/my_container",
"MemUsage": "10MiB / 64MiB",
"MemPerc": "15.63%",
"NetIO": "1.2kB / 0B",
"BlockIO": "0B / 0B",
"PIDs": 10
}
上述 JSON 输出展示了 `docker stats` 能提供的标准字段,其中不包含 Swap。因此,若需精确监控 Swap,建议采用以下替代方案:使用 `docker inspect` 获取容器 ID,然后进入宿主机读取对应的 cgroup 文件。例如,执行 `cat /sys/fs/cgroup/docker/$CONTAINER_ID/memory.swap.current` 即可得到当前 Swap 使用量(字节)。此方法适用于所有启用 cgroup v2 的 Docker 版本。
cgroup v1 环境下的替代监控方案
当 Docker 运行在 cgroup v1 环境下时,Swap 控制位于 `/sys/fs/cgroup/memory/docker/
「在我电脑上明明能跑」——因为少了Docker。帮你写Dockerfile、构建镜像、配置多环境、编排docker-compose,从本地开发到服务器部署一条龙。支持Node.js/Python/Go/Java/前端全栈,覆盖CI/CD集成、安全加固、监控告警,告别环境不一致的噩梦。 触发词:Docker部署、容...

#!/bin/bash
CONTAINER_ID=$(docker ps -q --filter name=my_container)
SWAP_PATH="/sys/fs/cgroup/memory/docker/${CONTAINER_ID}/memory.memsw.usage_in_bytes"
if [ -f "$SWAP_PATH" ]; then
echo "Swap Usage: $(cat $SWAP_PATH) bytes"
else
echo "Cgroup v1 memory controller not found or disabled"
fi
该脚本首先通过 `docker ps` 获取目标容器的 ID,然后构造 cgroup v1 的 Swap 文件路径。如果文件存在,它读取并打印当前的 Swap 使用字节数;否则提示控制器未找到。这提供了一种轻量级的监控手段,无需安装额外软件。需要注意的是,某些云提供商或安全策略可能禁用 memory.memsw 控制器,导致该路径不存在,此时应检查 `/proc/cgroups` 确认功能是否开启。
如何验证 Swap 限制是否生效
为了确认 Docker 容器确实受限于指定的 Swap 配额,可以创建一个具有明确内存和 Swap 限制的容器,并模拟高负载场景。例如,启动一个容器并设置 `--memory-swap` 参数,然后在其内部运行消耗大量内存的程序,观察 Swap 使用量的变化。通过对比 `docker stats` 输出的 MemUsage 和从 cgroup 文件读取的 Swap 值,可以验证限制机制是否按预期工作。若 Swap 使用量达到上限后进程被终止或 OOM Killer 介入,则说明配置正确。










