通过 docker stats 分析容器 swap 使用情况,核心在于观察输出中的 mem swap 列。该列显示的是容器内进程使用的 swap 总量(包括共享内存等),而非仅指磁盘 swap。要准确分析,需结合 docker inspect 查看容器的 swap 限制配置(如 kernel.memory.swappiness)以及宿主机层面的 swap 监控数据,因为 docker 默认不隔离 swap 统计,且
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 统计口径差异所致;反之,若两者均高,则说明确实发生了严重的内存交换。











