通过 docker stats 分析容器 swap 使用情况,核心在于观察输出中的 mem swap 列。该列显示的是容器内进程使用的 swap 总量(包括共享内存等),而非仅指磁盘 swap。要准确分析,需结合 docker inspect 查看容器的 swap 限制配置(如 kernel.memory.swappiness)以及宿主机层面的 swap 监控数据,因为 docker 默认不隔离 swap 统计,且
docker stats</code 的 swap 数据可能包含宿主机的系统开销。</p><p><img src="https://img.php.cn/upload/article/001/242/473/179529912447678.png" alt="Docker 中怎么通过 docker stats 分析容器 Swap 使用情况"></p> <h2>如何解读 docker stats 中的 MEM SWAP 列</h2><p><code>docker stats输出的
MEM SWAP 列直接反映了容器内所有进程当前使用的 Swap 空间大小。这个数值并非总是精确对应容器专属的磁盘 Swap,它往往包含了容器内进程产生的匿名页被交换到宿主机 Swap 分区的情况。如果该值持续增长,说明容器内的内存压力正在迫使内核将部分内存数据移至磁盘,这通常会导致性能下降。

#!/bin/bash # 实时监控特定容器的 Stats 并过滤 Swap 信息 CONTAINER_ID="my_container" echo "Monitoring Swap usage for $CONTAINER_ID..." docker stats --no-stream $CONTAINER_ID | grep -E "NAME|SWAP"
运行上述脚本后,你将看到类似以下的输出:
NAME MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS MEM SWAP
my_container 50MiB / 1GiB 4.88% 1.5kB / 0B 0B / 0B 10 0B
这表明当前容器未使用任何 Swap 空间。若 MEM SWAP 列显示非零值,如 100MiB,则意味着有 100MB 的数据被交换到了磁盘。
为什么 docker stats 显示的 Swap 数据可能不准确
Docker 默认情况下并不严格隔离 Swap 的使用统计,docker stats获取的数据来源于 cgroups v1 或 v2 的接口。在 cgroups v1 中,Swap 统计可能不够精确,尤其是在混合负载环境下。此外,如果容器没有显式设置 Swap 限制(--memory-swap),其 Swap 使用量可能会受到宿主机整体 Swap 策略的影响,导致 docker stats 显示的值波动较大或包含不属于该容器的系统 Swap 活动。

# 检查容器的 Swap 限制配置
docker inspect --format='{{.HostConfig.MemorySwap}}' my_container
# 如果返回值为 -1,表示无限制;如果为 0,表示禁用 Swap
docker inspect --format='{{.HostConfig.MemorySwappiness}}' my_container
通过执行 docker inspect,你可以确认容器是否启用了 Swap 限制。如果 MemorySwap 为 -1,容器可以使用宿主机所有的 Swap 空间,此时 docker stats 中的 MEM SWAP 值可能无法真实反映容器的独立资源消耗。建议在生产环境中明确设置 --memory-swap 以限制容器的 Swap 使用上限,从而获得更准确的监控数据。
当容器 Swap 使用率过高时该如何排查
当发现 docker stats 中 MEM SWAP 列数值持续升高时,应优先排查容器内是否存在内存泄漏或突发流量导致的内存峰值。可以通过进入容器内部,使用 free -m 或 top 命令查看具体的内存和 Swap 使用情况,并与宿主机上的 vmstat 数据进行对比。如果容器内 Swap 使用率高但宿主机整体 Swap 使用率低,可能是由于 cgroup 统计口径差异所致;反之,若两者均高,则说明确实发生了严重的内存交换。


















