容器与云原生 / 系统课时

docker logs 读取的是哪里的日志

docker logs 读取的是哪里的日志

docker logs 并不会自动搜索容器里的所有日志文件。它读取的是容器进程写到标准输出和标准错误、再由 Docker logging driver 接收的日志记录。理解这条链路后,就能解释“文件里明明有日志,docker logs 为什么是空的”。

学习目标

  • 说清 STDOUT、STDERR、logging driver 与 docker logs 的关系
  • 用容器实验验证标准输出和标准错误都会被收集
  • 排查应用有日志文件但 docker logs 没有内容的情况

日志是怎样进入 docker logs 的

容器主进程以及它启动的子进程可以向标准输出 STDOUT 和标准错误 STDERR 写数据。Docker Engine 接收这些流,并交给该容器配置的 logging driver。执行 docker logs 时,CLI 是向 Docker Engine 请求这些日志记录,而不是直接扫描 /var/log 或应用目录。

Docker 容器日志从标准流进入 logging driver,再由 docker logs 读取的数据流

这条链路里最关键的边界是:Docker 默认关注进程的标准流,而不是容器文件系统中任意位置的日志文件。

用一个容器验证

下面显式使用 local logging driver,分别向标准输出和标准错误写一行,再读取日志并检查该容器的 driver:

bash
docker run -d --name log-source --log-driver local alpine:3.20 sh -c 'echo "stdout-line"; echo "stderr-line" >&2'
docker logs log-source
docker inspect --format '{{.HostConfig.LogConfig.Type}}' log-source
docker rm log-source

预期输出

text
<ID>
stdout-line
stderr-line
local
log-source

<ID> 是实际容器 ID。docker logs 会把两个标准流的日志记录一起展示;它们在底层仍带有流来源等元数据,具体存储格式由 logging driver 决定。

logging driver 决定日志去哪里

每个容器都会使用某个 logging driver。Docker Engine 的常见默认值是 json-file;也可以改为 local、journald 或远程日志 driver。driver 决定日志记录如何存储、转发以及是否能被本地读取。

因此,docker logs 不等于“查看某个固定宿主机文件”。即使某些 driver 最终使用本地文件保存日志,也不应绕过 Docker 直接读取或修改这些内部文件;它们属于 Docker 的实现和管理范围。

对于把日志发送到远程系统的 driver,Docker 可能通过本地读取缓存让 docker logs 仍可使用;如果相关缓存被关闭,而 driver 自身又不支持读取,本地 docker logs 就可能无法返回这些日志。若容器使用 none driver,则不会有可供该命令读取的容器日志。

为什么应用日志文件看得到,docker logs 却为空

最常见的原因是应用只把日志写进类似 /var/log/app.log 的文件,没有同时写到 STDOUT 或 STDERR。这时文件确实存在于容器文件系统,但没有进入 Docker logging driver 的输入链路。

容器化应用通常更适合把业务运行日志直接写到标准流,再让 Docker 或上层日志系统负责收集、轮转和转发。如果已有应用必须写文件,则应明确配置日志采集代理读取该文件,而不是期待 docker logs 自动发现它。

遇到“docker logs 没输出”时,先确认应用实际写向哪里,再检查容器使用的 logging driver;不要先去猜宿主机上的日志文件路径。只要先分清“应用日志产生位置”和“Docker 日志采集入口”,大多数这类问题都能很快定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

docker logs 读取的是哪里的日志

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

登录哪都通