容器与云原生 / 系统课时

容器日志为什么会占满磁盘

容器日志为什么会占满磁盘

容器本身看起来没有新增文件,宿主机磁盘却可能持续下降,一个常见原因是标准输出被 Docker 日志驱动不断写入宿主机。理解日志从 stdout/stderr 到宿主机文件的路径后,就能找到实际占用,并用轮转限制避免日志无限增长。

学习目标

  • 理解容器日志如何持续消耗宿主机空间
  • 找到容器实际日志文件并检查其占用
  • 使用日志轮转限制单个容器的日志增长

日志空间为什么会一直增加

应用写到 stdout/stderr 的内容不会凭空消失。Docker logging driver 会接收这些记录;在常见的 json-file 驱动下,记录会落到 Docker 数据目录中的日志文件。如果没有配置轮转,持续高频输出就会让文件不断变大。

容器标准输出经日志驱动写入宿主机并触发轮转的路径

需要区分两种“占空间”:应用主动写入容器可写层或挂载卷,是业务文件占用;应用向 stdout/stderr 打日志,则由 logging driver 管理。后者即使应用目录里看不到大文件,也可能吃掉宿主机磁盘。

找到实际日志文件

在 Linux 上使用本机 Docker Engine,并且当前日志驱动提供文件路径时,可以通过 docker inspect 查看 LogPath。下面创建一个产生一批日志后保持运行的测试容器,再读取其日志文件大小。

bash
docker rm -f log-fill-demo >/dev/null 2>&1 || true
docker run -d --name log-fill-demo alpine:3.20 sh -c 'i=0; while [ $i -lt 20000 ]; do echo this-is-a-repeated-log-line-that-demonstrates-growth; i=$((i+1)); done; sleep 300' >/dev/null
sleep 2
LOG_PATH=$(docker inspect -f '{{.LogPath}}' log-fill-demo)
echo "$LOG_PATH"
sudo du -h "$LOG_PATH"
docker rm -f log-fill-demo >/dev/null

预期输出:

text
/var/lib/docker/containers/<ID>/<ID>-json.log
<SIZE>    /var/lib/docker/containers/<ID>/<ID>-json.log

<ID> 和 <SIZE> 会因环境与日志驱动不同而变化。Docker Desktop 通常把 Docker Engine 运行在虚拟机里,宿主操作系统未必能直接访问这里显示的 Linux 路径,因此不要把路径差异误判成“没有日志”。

用轮转限制增长

对 json-file 驱动,可以在创建容器时设置 max-size 和 max-file。前者控制单个日志文件达到多大时轮转,后者控制保留多少个日志文件。

bash
docker rm -f capped-log >/dev/null 2>&1 || true
docker run -d --name capped-log --log-driver json-file --log-opt max-size=10m --log-opt max-file=3 nginx:alpine >/dev/null
docker inspect -f '{{.HostConfig.LogConfig.Type}} {{index .HostConfig.LogConfig.Config "max-size"}} {{index .HostConfig.LogConfig.Config "max-file"}}' capped-log
docker rm -f capped-log >/dev/null

预期输出:

text
json-file 10m 3

这表示该容器的 json-file 日志按约 10 MiB 单文件轮转,并最多保留 3 个日志文件。实际总占用还会有少量元数据和文件系统开销,因此不要把 10m × 3 当作精确上限。

为什么改了配置却没有生效

日志驱动和轮转选项是在容器创建时确定的。修改 Docker daemon 的默认日志配置,只会影响之后新创建的容器;已经存在的容器不会自动切换参数,通常需要按原业务配置重新创建。

如果磁盘告警已经发生,先用 docker inspect 找到高增长容器,确认它是否存在异常刷日志;再修复应用的重复报错或调低无意义日志级别,同时为新建容器设置合理轮转。只限制文件大小而不处理持续报错,虽然能保护磁盘,却会掩盖真正的运行问题。

日志管理的目标不是“把日志删掉”,而是让日志量、保留时间和故障排查需求保持可控:应用避免无意义高频输出,Docker 负责轮转,监控再对磁盘使用率和日志增长速度做预警。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

容器日志为什么会占满磁盘

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通