容器与云原生 / 系统课时
查看容器日志
查看容器日志
本课解决容器启动失败或运行异常时如何快速获取输出。你将使用 docker logs 查看历史日志、持续跟踪新日志,并按行数与时间范围缩小排查范围。
学习目标
- 查看容器已经产生的标准输出和标准错误
- 使用
--tail、--since、--timestamps和-f过滤日志 - 理解
docker logs的数据来源与适用边界
日志从哪里来
docker logs 读取容器主进程写入标准输出和标准错误的内容。应用若只把日志写入容器内文件,docker logs 可能看不到这些记录。
因此,容器化应用通常把运行日志输出到控制台,再由 Docker 日志驱动或外部采集系统统一处理。docker logs 适合单机快速排查,但不等同于完整的集中日志平台。
查看历史日志
直接执行 docker logs <容器名> 会输出当前可读取的历史日志。日志很多时,应先使用 --tail <行数> 查看末尾内容,避免一次输出过多。
--timestamps 会在每行前增加时间戳。时间是动态值,格式和时区显示取决于 Docker 输出。结合应用日志自身时间时,要确认两者采用的时区。
下面创建一个会输出五行日志的容器,等待任务结束后查看最后两行和带时间戳的最后一行。
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预期输出
<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 一起判断。
若日志末尾没有明显错误,也要检查容器启动命令、挂载、环境变量和健康检查。日志只是证据之一,不应作为唯一判断依据。