容器与云原生 / 系统课时

怎样限制 Docker 日志大小

怎样限制 Docker 日志大小

容器持续输出日志时,如果不做轮转,宿主机磁盘可能被单个容器逐步吃满。本课用 json-file 日志驱动演示单容器与守护进程级限制,并说明配置何时生效、怎样验证以及哪些做法容易失效。

学习目标

  • 理解 max-size 与 max-file 分别限制什么
  • 为单个容器和新建容器设置日志轮转
  • 能验证配置是否生效,并识别已有容器不更新的问题

先分清大小限制的对象

在未修改默认日志配置时,Docker 使用 json-file 驱动把容器的 stdout、stderr 保存为日志文件;如果没有配置轮转,这些文件可能持续增长。max-size 表示单个日志文件达到多大后滚动,max-file 表示最多保留多少个滚动文件。

例如 max-size=10m、max-file=3 可以粗略理解为每个容器最多保留约 3 个、每个不超过 10 MB 的日志文件。它不是精确的容器磁盘配额,也不限制应用自己写入其他路径的文件。

先给单个容器加限制

排查或验证时,先用容器级参数最直接。下面启动一个持续输出日志的 Alpine 容器,并立即检查它实际记录的日志驱动配置。

bash
docker run -d --name log-limit \
  --log-driver json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  alpine sh -c 'while true; do echo "heartbeat"; sleep 1; done' >/dev/null

docker inspect --format '{{.HostConfig.LogConfig.Type}}' log-limit
docker inspect --format '{{index .HostConfig.LogConfig.Config "max-size"}} {{index .HostConfig.LogConfig.Config "max-file"}}' log-limit

docker rm -f log-limit >/dev/null

预期输出:

text
json-file
10m 3

如果输出符合预期,说明限制已经写入这个容器的 HostConfig。实际日志文件何时发生轮转取决于日志量,不需要为了验证参数而先把磁盘写满。

把限制设成新容器的默认值

需要统一约束主机上的新容器时,可在 Docker daemon 配置中设置默认日志驱动与选项。Linux 常见配置文件是 /etc/docker/daemon.json;其他安装方式应修改对应的 Docker daemon 配置。

json
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

log-opts 中的值要写成字符串。修改后需要重启 Docker daemon,而且只会影响之后创建的容器;已经存在的容器不会自动继承新配置。

在使用 systemd 管理 Docker 的 Linux 主机上,可以重启服务后创建一个临时容器验证默认值:

bash
sudo systemctl restart docker

docker run -d --name log-default alpine sleep 300 >/dev/null
docker inspect --format '{{index .HostConfig.LogConfig.Config "max-size"}} {{index .HostConfig.LogConfig.Config "max-file"}}' log-default

docker rm -f log-default >/dev/null

预期输出:

text
10m 3

如果主机不是 systemd 环境,应使用该平台提供的 Docker daemon 重启方式,但验证思路不变:重新创建容器,再检查它的 LogConfig。

配置没生效时按这个顺序查

先确认目标容器是不是在修改配置后重新创建的;仅执行 docker restart 不会改变既有容器的日志驱动选项。再检查 daemon.json 是否为合法 JSON,以及 max-size、max-file 是否都使用字符串值。

不要直接编辑、删除或用 truncate 操作 Docker 自己管理的日志文件。日志驱动的底层文件应由 Docker daemon 管理,外部直接修改可能干扰日志读取与轮转。

如果没有依赖 json-file 的兼容性要求,也可以评估 local 日志驱动。它默认启用轮转并使用更节省空间的内部格式;无论选择哪种驱动,核心原则都是同时设置单文件大小、保留数量,并把集中日志的长期保留交给外部日志系统。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎样限制 Docker 日志大小

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

登录哪都通