容器与云原生 / 系统课时

查看容器日志

查看容器日志

本课解决容器启动失败或运行异常时如何快速获取输出。你将使用 docker logs 查看历史日志、持续跟踪新日志,并按行数与时间范围缩小排查范围。

学习目标

  • 查看容器已经产生的标准输出和标准错误
  • 使用 --tail、--since、--timestamps 和 -f 过滤日志
  • 理解 docker logs 的数据来源与适用边界

日志从哪里来

docker logs 读取容器主进程写入标准输出和标准错误的内容。应用若只把日志写入容器内文件,docker logs 可能看不到这些记录。

因此,容器化应用通常把运行日志输出到控制台,再由 Docker 日志驱动或外部采集系统统一处理。docker logs 适合单机快速排查,但不等同于完整的集中日志平台。

查看历史日志

直接执行 docker logs <容器名> 会输出当前可读取的历史日志。日志很多时,应先使用 --tail <行数> 查看末尾内容,避免一次输出过多。

--timestamps 会在每行前增加时间戳。时间是动态值,格式和时区显示取决于 Docker 输出。结合应用日志自身时间时,要确认两者采用的时区。

下面创建一个会输出五行日志的容器,等待任务结束后查看最后两行和带时间戳的最后一行。

bash
docker run -d --name logs-demo alpine:3.20 sh -c 'for i in 1 2 3 4 5; do echo "event-$i"; sleep 1; done'
docker wait logs-demo >/dev/null
docker logs --tail 2 logs-demo
docker logs --timestamps --tail 1 logs-demo
docker rm logs-demo

预期输出

text
<CONTAINER_ID>
event-4
event-5
<TIME> event-5
logs-demo

<CONTAINER_ID> 和 <TIME> 会随运行变化。docker wait 保证示例中的五行日志已经全部产生,再进行筛选。

实时跟踪与时间过滤

docker logs -f <容器名> 会先输出已有日志,再持续等待新日志,效果类似跟踪文件追加内容。按 Ctrl+C 只会结束日志跟踪命令,不会停止容器。

--since 10m 表示查看最近十分钟日志,--since <时间> 可从指定时间开始读取。还可以配合 --until 限定结束时间。排查已知故障窗口时,时间过滤比全文输出更高效。

常用组合是 docker logs -f --tail 100 <容器名>:先显示最后一百行,再持续跟踪新增内容。它适合观察应用重启、请求进入或错误是否继续出现。

常见问题

若命令提示容器不存在,应先用 docker ps -a 确认名称或 ID。若容器存在但没有日志,可能是应用未向标准输出写入、进程尚未启动、日志驱动不支持读取,或容器启动前就发生了 Docker 层错误。

容器删除后,其本地日志通常也随之失去直接访问入口。重要日志应及时采集到外部系统,不应只保留在单个 Docker 主机上。

日志与状态联合排查

日志回答“应用输出了什么”,状态回答“进程是否运行以及如何退出”。遇到启动失败时,应结合 docker ps -a、docker inspect 的退出码和 docker logs 一起判断。

若日志末尾没有明显错误,也要检查容器启动命令、挂载、环境变量和健康检查。日志只是证据之一,不应作为唯一判断依据。

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

目录与阅读设置

阅读设置

17

记录一个想法

查看容器日志

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

登录哪都通