容器与云原生 / 系统课时
配置日志驱动与日志轮转
配置日志驱动与日志轮转
本课解决容器日志持续增长导致磁盘被占满的问题。完成后,你将能选择合适的日志驱动,为日志设置大小与文件数量上限,并验证新容器是否使用了预期配置。
学习目标
- 理解 Docker 日志驱动负责什么
- 配置单容器和全局日志轮转
- 验证日志驱动及轮转参数是否生效
日志为什么会占满磁盘
容器写入标准输出和标准错误后,Docker 会交给日志驱动保存。默认配置如果没有限制大小,长期运行的应用可能不断累积日志,最终占满 Docker 数据目录所在磁盘。
日志轮转的核心是同时限制单个日志文件大小和保留文件数量。例如每个文件最多 10 MB,最多保留 3 个文件,则单个容器的日志占用会被控制在约 30 MB 附近,实际值可能因切换时机略有差异。
为单个容器配置轮转
下面启动一个 Nginx 容器,使用 local 日志驱动,并显式设置轮转上限。
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预期输出:
local {"max-file":"3","max-size":"10m"}镜像首次拉取时会额外显示下载进度。容器 ID 也可能出现,但不影响验证结果。
配置 Docker 全局默认值
希望后续新建容器统一使用轮转策略时,可编辑 Linux 主机上的 /etc/docker/daemon.json。这是完整配置示例;若文件已有其他字段,应合并而不是直接覆盖。
{
"log-driver": "local",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}保存后重启 Docker:
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}}'预期输出:
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。