容器与云原生 / 系统课时
怎样实时追踪容器日志
怎样实时追踪容器日志
容器启动失败、请求报错或任务卡住时,最直接的证据通常在标准输出和标准错误里。本节用 docker logs 组合行数、时间窗口与实时跟踪参数,避免一次拉取全部历史日志,并建立一套适合现场排障的查看顺序。
学习目标
- 使用
--tail和--since缩小日志范围 - 使用
-f持续追踪新日志,并知道何时停止 - 根据启动故障与运行故障选择合适的查看方式
先把日志范围缩小
docker logs <容器> 会读取 Docker 为该容器保存的日志。运行时间较长的容器可能已经积累大量输出,排障时不应先把全部历史日志刷到终端,而应先限定“最近多少行”或“最近多长时间”。
下面创建一个每秒输出一行的测试容器,再只查看最近 3 行且限定在最近 10 秒内。
docker rm -f log-demo >/dev/null 2>&1 || true
docker run -d --name log-demo alpine:3.20 sh -c 'i=1; while true; do echo tick=$i; i=$((i+1)); sleep 1; done' >/dev/null
sleep 4
docker logs --tail 3 --since 10s log-demo预期输出:
tick=<ID>
tick=<ID>
tick=<ID><ID> 表示递增序号,实际值取决于命令执行时机。--tail 3 只保留最后 3 行,--since 10s 再把范围限制到最近 10 秒;两个条件可以组合使用。--since 也可写成 5m、1h,或使用 Docker 支持的时间戳格式。
实时跟踪新日志
定位运行中的故障时,通常需要先看少量历史上下文,再观察接下来发生什么。-f 或 --follow 会保持连接,并在容器产生新日志时继续输出。
docker logs --tail 2 --since 1m -f log-demo预期输出:
tick=<ID>
tick=<ID>
tick=<ID>
...输出会持续追加,直到按 Ctrl+C 结束本地跟踪。这个操作不会停止容器,只会退出当前 docker logs 命令。
按时间点查看故障前后
当告警、监控或用户反馈给出了明确时间,可以让日志窗口围绕这个时间收缩。相对时间适合现场快速排查;绝对时间适合和监控、链路追踪或工单时间对齐。
如果只想从现在开始观察新日志,可以把 --tail 0 与 -f 组合,避免先打印已有历史内容。
docker logs --tail 0 --since 15m -f log-demo预期输出:
tick=<ID>
tick=<ID>
...命令启动后等待新的日志产生,再持续显示后续输出。若应用日志本身带时间戳,优先以应用时间戳判断业务事件;Docker 也支持 --timestamps 为每条记录附加 Docker 记录时间。
看不到日志时先检查什么
docker logs 只能读取容器通过标准输出或标准错误交给 Docker logging driver 的内容。若应用把日志只写进容器内文件,例如 /var/log/app.log,这里可能为空,此时应检查应用日志配置或进入容器查看对应文件。
另外,容器名写错、容器已被删除、应用没有输出,或当前日志驱动不支持通过 docker logs 读取,都可能造成“看不到日志”。排查时先确认容器存在,再确认应用是否把关键日志写向 stdout/stderr,最后检查日志驱动与应用自身的日志配置。
实时追踪的核心不是一直开着 -f,而是先用行数和时间把范围压小,再在复现故障时持续观察,这样终端噪声更少,也更容易把错误与触发动作对应起来。