Docker容器日志占满宿主磁盘,如何对照首次启动与重建后的日志配置?

发布人:A5数据发布时间:2026-11-16 10:28阅读量:22

把首次启动和重建后的磁盘占用直接放在一起比较,容易把容器年龄、业务日志量、日志驱动和轮转策略等因素混为一谈。判断配置是否变化,先对照两个容器实际保存的日志驱动与选项,再在相同业务负载和观测时长下比较日志目录的占用变化。

最关键的区别是:Docker 守护进程的默认日志配置通常只作用于新建容器;对原容器执行 docker restart,不会重新读取这些默认值。只有创建了新容器,且没有被服务级配置覆盖,才会采用当时生效的默认值。因此,“重启后还是占盘”和“重建后配置已变但磁盘仍满”是两种不同情况,需要分别验证。

先确认日志由谁管理

Docker 日志驱动接收容器进程写到标准输出和标准错误的内容。常见的 json-file 驱动会把这些内容写入宿主机上的容器日志文件;若未启用轮转,文件可能随日志持续增长。使用其他驱动时,日志的保存位置和磁盘占用方式可能不同。

应用如果把日志写入容器内的文件,而不是标准输出或标准错误,Docker 的日志驱动选项通常不会限制这些文件。此时应另行检查应用的文件日志配置、挂载卷和对应宿主机目录。也就是说,修改 Docker 日志轮转选项,并不能自动限制所有由应用产生的日志。

日志配置可能来自两个层级:

  • Docker 守护进程的默认配置,适用于未单独指定日志配置的新容器。
  • Docker Compose 等服务定义中的 logging 配置;若服务显式指定了驱动和选项,通常以服务配置为准。

容器创建时会保存自己的日志驱动与选项。更改守护进程默认值,不会追溯修改已创建容器的配置;重新构建镜像本身也不等于重建容器。排查时应以当前容器的实际配置为准,而不是只看现在的配置文件。

先确认日志由谁管理配图

建立首次启动与重建后的基线

先记录 Docker 数据目录和默认日志驱动:

docker info --format 'root={{.DockerRootDir}} default-driver={{.LoggingDriver}}'

default-driver 只能说明当前守护进程的默认驱动,不能代表某个已有容器实际使用的驱动。对待比较的容器分别记录以下信息:

C=容器名或容器ID

docker inspect --format 'id={{.Id}} created={{.Created}} driver={{.HostConfig.LogConfig.Type}} options={{json .HostConfig.LogConfig.Config}} logpath={{.LogPath}}' "$C"

重点对照 id、created、driver 和 options。容器 ID 或创建时间改变,能帮助确认是否确实创建了新容器;HostConfig.LogConfig 则用于确认该容器保存的日志配置。若要比较首次启动与重建后,最好在创建或更换容器前保存首次启动时的输出,因为容器移除后,原配置不一定还能从 Docker 中查回。

若容器提供本地日志路径,可查看它所在目录的占用和文件系统剩余空间:

LOG_PATH="$(docker inspect --format '{{.LogPath}}' "$C")"

if [ -n "$LOG_PATH" ] && [ -e "$LOG_PATH" ]; then
  sudo du -sh -- "$(dirname "$LOG_PATH")"
  df -h -- "$LOG_PATH"
else
  printf '%s\n' "该容器没有可直接核对的本地日志文件路径"
fi

LogPath 为空或找不到对应文件时,不要直接推断日志没有占用磁盘:容器可能使用其他日志驱动,或者日志存放在其他位置。先核实驱动,再检查其实际存储位置。例如,使用 journald 时应查看 systemd journal 的占用;远程日志驱动则应检查远端存储。对宿主机整体,还应检查 Docker 数据目录及其所在文件系统,而不是只盯着某一个容器文件。

为了比较日志增长速度,可在观测窗口开始和结束时记录容器日志目录的总占用,同时记录应用输出量和宿主机可用空间。若发生轮转,目录占用可能趋于稳定,但应用仍在持续产生日志;因此,目录大小不能单独替代日志输出速率指标。

每次只改变一个配置变量

要验证“轮转配置是否导致占盘差异”,尽量固定其他条件:容器镜像版本或镜像摘要、应用配置、业务请求量、运行时长、宿主机和存储位置。然后只改变日志轮转配置,并在同样的负载和观测时长下比较结果。

Compose 可以为服务明确指定 json-file 驱动及轮转选项:

services:
  app:
    image: example/app:1.2
    logging:
      driver: "json-file"
      options:
        max-size: "20m"
        max-file: "5"

这里的选项值使用字符串。max-size 表示单个日志文件达到指定大小后触发轮转;max-file 表示保留的日志文件数,通常包含当前文件。仅设置文件数而不设置轮转大小,不能构成预期的大小限制。

如果希望未单独配置日志选项的容器也采用轮转策略,可以在 Docker 守护进程配置中设置默认值,例如:

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "20m",
    "max-file": "5"
  }
}

守护进程配置的具体文件位置取决于系统安装方式。更改该配置可能需要重启 Docker 服务,会影响同一守护进程上的其他容器;操作前应确认维护窗口和服务恢复方式。即使默认值已经更改,原容器也不会因此自动更新。若 Compose 服务显式指定了其他日志配置,修改守护进程默认值也不一定会改变该服务的设置。

为避免把“换驱动”和“开启轮转”混为一谈,首次对照宜保持驱动相同,只改变 max-size、max-file 这类轮转选项。若同时从 json-file 改成其他驱动,日志位置、查询行为和保留机制都可能变化,需要把驱动变化作为单独变量验证。

用同一负载做对照

下面是一组模拟数据,用来说明怎样解释结果,不代表特定环境的实测值。假设应用在两个观测窗口中都持续输出约 1.6 MB/min,窗口为 180 分钟,则应用输出量约为 1.6 × 180 = 288 MB。json-file 文件还包含日志封装信息,落盘字节数可能高于应用输出的原始字节数。

观测组日志驱动与选项观测条件容器日志目录增量判断
首次创建json-file,未配置轮转相同负载,180 分钟约 310 MB若持续增长,符合未限制日志文件的表现
重建后json-file,max-size: 20m、max-file: 5相同负载,180 分钟约 100 MB 上下占用趋于受控,支持轮转配置生效的判断

20m 和 5 个文件可粗略估算为每个容器约 100 MB 的日志保留量,但不应视为精确上限。实际占用会受到文件轮转时机、单条日志大小和文件系统分配等因素影响;多副本服务还要按容器数量估算总量。例如,8 个副本按每个约 100 MB 估算,总保留量约为 800 MB,此外还要给镜像、容器可写层和其他数据留出空间。

如果调整守护进程默认值后只重启了原容器,检查结果仍可能显示原有的 json-file 配置和未设置轮转选项。这并不说明新默认值没有写入,而是说明它没有应用到该容器。对照时还要确认新容器确实读取了预期的镜像版本和配置;镜像标签若可变,仅凭标签相同不能证明镜像内容相同。

重建前后的验证与风险控制

创建新容器前,先保存首次启动时的检查结果,并确认需要保留的日志有备份位置。若容器使用支持 docker logs 的驱动,可在确认目标文件系统容量充足、访问权限合适后,将需要留存的日志导出到 Docker 数据目录之外:

docker logs --timestamps "$C" > /mnt/log-archive/container.log 2>&1

导出内容可能包含账号、请求参数或其他敏感信息,应按业务要求限制访问。远端驱动或不支持 docker logs 的驱动,不能假设该命令可以完整导出历史日志;先核实日志驱动及现有保留方式。

Compose 中的 logging 配置确认无误后,可以只重建指定服务:

docker compose up -d --no-deps --force-recreate app

执行前要确认服务影响范围、数据挂载和恢复方式。重建会替换容器,容器可写层中的数据可能随旧容器移除而丢失,旧容器的日志也可能不再可查;命名卷通常独立于容器,但仍应核对实际挂载。单副本服务还可能出现短暂中断。若不能接受这些影响,应先在测试环境验证,或采用符合服务架构的滚动替换方式。

新容器启动后,重新执行 docker inspect,确认实际驱动和选项与预期一致,再观察相同业务负载下的日志目录、宿主机可用空间和应用日志输出量。复测时长应足以覆盖多次轮转;只观察几分钟,可能看不到轮转后的稳定占用。若测试服务负载明显低于生产环境,结果也不能直接代表生产磁盘需求。

出现下列差异时,应分别解释,而不是马上重复修改配置:

  • 检查结果仍显示旧选项:确认操作对象是新容器,并检查 Compose 服务是否显式覆盖守护进程默认值。
  • 选项正确但磁盘仍增长:检查应用写入文件的日志、其他容器和 Docker 数据目录中的其他文件;日志驱动选项不控制这些对象。
  • 目录占用下降但文件系统仍接近满载:检查同一文件系统上的镜像、容器可写层、卷及其他服务数据;日志限额不会清理这些内容。
  • 重建后当前日志目录很小:这可能只是因为新容器日志从零开始,不足以证明原有日志问题已解决。

不要直接删除或截断 Docker 管理的活动日志文件来代替配置验证。这样做可能导致日志丢失、观察结果失真,也可能影响 Docker 对日志文件的管理。重建前保存的配置、日志和运行条件,既是排查依据,也是恢复时判断影响范围的必要材料。回滚时应恢复原服务配置并再次按计划重建;已经移除且没有备份的旧日志,不能通过回滚配置恢复。

复测结果适用到什么范围

一次受控对照能说明:在已记录的镜像、应用负载、日志驱动和观测窗口下,改变的轮转选项是否影响了容器日志目录占用。它不能单独证明宿主机所有磁盘增长都由容器日志引起,也不能保证不同业务负载、不同副本数或不同日志驱动下会得到相同结果。

因此,复测报告应保留首次启动和重建后的容器 ID、驱动与选项、镜像版本、观测时长、应用输出量、日志目录占用及宿主机剩余空间。若后续又更改了镜像、业务流量、驱动或存储位置,就应把变化作为新的变量重新对照;否则,先前的比较结论只适用于原有测试条件。

面向容器化业务的宿主机部署,A5idc数据提供香港、美国、日本等多地区物理服务器租用,覆盖Xeon与AMD平台及不同内存、NVMe存储配置,可为应用运行和日志写入提供相应的计算与存储资源。香港另有多盘大容量存储方案,可用于日志归档等数据容量需求,支持结合部署区域与数据规模配置基础设施。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9712.html

相关推荐