容器与云原生 / 系统课时
多服务日志怎样防止占满磁盘
多服务日志怎样防止占满磁盘
Compose 项目长期运行时,磁盘往往不是被业务数据,而是被多个容器持续追加的标准输出日志吃满。本篇用 Docker 日志驱动的轮转参数给每个服务设定可预估的上限,并说明怎样验证配置已经落到实际容器上。
学习目标
- 为 Compose 服务配置日志单文件大小和保留数量
- 根据服务数量估算日志占用,并识别容易失控的配置
- 验证正在运行的容器是否真正应用了日志轮转参数
日志为什么会越积越多
容器写到标准输出和标准错误的内容会交给 Docker 日志驱动处理。常见的 json-file 驱动如果没有显式配置轮转,日志文件会持续增长;一个 Compose 项目有多个服务、多个副本时,增长量还会叠加。
控制长期占用最直接的两个参数是 max-size 与 max-file。前者限制单个日志文件达到多大后轮转,后者限制保留多少个轮转文件。以 10m 和 3 为例,可以把单个容器的日志占用控制在约 30 MB 的量级,但这只是容量规划值,不是精确磁盘配额。
给每个服务设置轮转上限
下面的 compose.yaml 是可直接运行的最小示例。app 每秒打印一行日志,便于观察轮转配置。
services:
app:
image: alpine:3.20
command: ["sh", "-c", "while true; do date; sleep 1; done"]
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"logging 是服务级配置,所以不同服务可以采用不同上限。高频访问日志服务可以给更大的总预算,低频后台任务则可以更小。若一个服务扩成多个容器,每个容器都会有自己的日志文件,因此总预算也要按副本数累加。
启动并验证实际配置
先启动服务,再直接查看容器的日志驱动配置。这样可以避免只检查 YAML,却遗漏“旧容器尚未重建”的情况。
docker compose up -d >/dev/null 2>&1
docker inspect --format '{{.HostConfig.LogConfig.Type}} {{index .HostConfig.LogConfig.Config "max-size"}} {{index .HostConfig.LogConfig.Config "max-file"}}' "$(docker compose ps -q app)"预期输出:
json-file 10m 3如果输出仍是旧值,通常说明当前容器是在修改配置之前创建的。执行 docker compose up -d 让 Compose 根据新配置重新创建受影响的服务,再次检查即可。日志参数只对采用这些参数创建出的容器生效,不会把一个既有容器的日志策略原地改写。
按项目规模做容量预算
规划时可以把每个容器的日志上限近似看成 max-size × max-file,再乘以预期副本数。例如 4 个服务、每个 2 个副本、每个容器约 30 MB,则仅这些容器日志的规划量级约为 240 MB。
实际环境还应同时关注宿主机剩余空间和业务日志速率。日志轮转解决的是“无限增长”问题,不等于日志治理本身;需要长期检索或审计的日志应发送到集中式日志系统,而不是靠不断增大本地保留数量来保存历史。