容器与云原生 / 系统课时

配置日志驱动与日志轮转

配置日志驱动与日志轮转

本课解决容器日志持续增长导致磁盘被占满的问题。完成后,你将能选择合适的日志驱动,为日志设置大小与文件数量上限,并验证新容器是否使用了预期配置。

学习目标

  • 理解 Docker 日志驱动负责什么
  • 配置单容器和全局日志轮转
  • 验证日志驱动及轮转参数是否生效

日志为什么会占满磁盘

容器写入标准输出和标准错误后,Docker 会交给日志驱动保存。默认配置如果没有限制大小,长期运行的应用可能不断累积日志,最终占满 Docker 数据目录所在磁盘。

日志轮转的核心是同时限制单个日志文件大小和保留文件数量。例如每个文件最多 10 MB,最多保留 3 个文件,则单个容器的日志占用会被控制在约 30 MB 附近,实际值可能因切换时机略有差异。

为单个容器配置轮转

下面启动一个 Nginx 容器,使用 local 日志驱动,并显式设置轮转上限。

bash
docker rm -f log-demo 2>/dev/null || true

docker run -d \
  --name log-demo \
  --log-driver local \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  nginx:alpine

docker inspect \
  --format '{{.HostConfig.LogConfig.Type}} {{json .HostConfig.LogConfig.Config}}' \
  log-demo

预期输出:

text
local {"max-file":"3","max-size":"10m"}

镜像首次拉取时会额外显示下载进度。容器 ID 也可能出现,但不影响验证结果。

配置 Docker 全局默认值

希望后续新建容器统一使用轮转策略时,可编辑 Linux 主机上的 /etc/docker/daemon.json。这是完整配置示例;若文件已有其他字段,应合并而不是直接覆盖。

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

保存后重启 Docker:

bash
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}}'

预期输出:

text
local

全局配置只影响重启 Docker 后新创建的容器,已经存在的容器不会自动更新。要让旧容器使用新策略,需要按原参数重新创建。

查看日志与磁盘占用

使用 docker logs log-demo 读取由 Docker 管理的日志。检查整体空间时,可执行 docker system df;检查宿主机分区时,可执行 df -h。不要直接修改 Docker 管理的日志文件,否则可能破坏日志状态。

集中式日志平台通常使用 fluentd、syslog 或第三方日志插件转发日志。无论采用哪种方式,都应同时考虑本地缓存上限和远端不可用时的堆积风险。

常见错误

把 max-size 写成数字会导致配置不符合日志选项格式,应写成字符串,例如 "10m"。修改 daemon.json 后若 Docker 无法启动,可先执行 sudo dockerd --validate --config-file=/etc/docker/daemon.json 检查语法,再查看 journalctl -u docker。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置日志驱动与日志轮转

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

登录哪都通