容器与云原生 / 系统课时
怎样一次追踪多个服务日志
怎样一次追踪多个服务日志
当一次请求会经过 Web、数据库和缓存时,分别打开三个终端很难对齐故障发生的先后顺序。本篇使用 docker compose logs 把多个 Service 的日志汇总到同一条时间线上,并通过时间戳和尾部截取快速定位启动或调用故障。
学习目标
- 同时读取多个 Compose Service 的日志,并识别每行所属容器
- 使用
--follow、--tail和--timestamps控制实时追踪范围 - 根据同一时间窗口关联 Web、数据库和缓存侧的异常
同时指定多个服务
docker compose logs 后可以直接列出多个 Service 名称。Compose 会把这些服务的输出合并到当前终端,并在每行前保留容器前缀,因此不需要分别进入容器查看日志。
下面假设 compose.yaml 中存在 web、db 和 cache 三个 Service。先只读取每个服务最近 50 行,再持续等待新日志:
docker compose logs --follow --tail=50 --timestamps web db cache预期输出(日志正文因应用而异,<TIME> 表示实际时间戳):
web-1 | <TIME> application started
db-1 | <TIME> database system is ready to accept connections
cache-1 | <TIME> Ready to accept connections
web-1 | <TIME> GET /health 200命令会持续运行,按 Ctrl+C 结束追踪。--follow 可简写为 -f;--tail=50 避免启动调试时先打印大量历史日志;--timestamps 则让不同服务产生的事件更容易按时间关联。
怎样沿着一次故障阅读日志
同时追踪并不意味着从第一行读到最后一行。更有效的方法是先找到用户操作或启动失败的大致时间,再沿同一时间附近检查各服务。
例如 Web 首先出现数据库连接失败,应继续观察紧邻时间点的 db 日志,而不是只盯着 Web 的异常堆栈。如果 Web 报缓存超时,则对照 cache 是否正在重启、尚未就绪或拒绝连接。多服务日志的价值正是把这些原本分散的现象放进同一时间轴。
缩小历史日志范围
故障已经发生而不需要继续等待时,可以去掉 --follow,再使用 --since 限定时间范围。例如只检查最近 10 分钟的三组日志:
docker compose logs --since=10m --timestamps web db cache预期输出:
web-1 | <TIME> connecting to database
db-1 | <TIME> connection received
cache-1 | <TIME> client connected实际日志内容和时间戳会不同,但输出只包含指定时间范围内这些 Service 的日志。比起把整个项目历史日志全部打印出来,这种方式更适合复盘刚刚发生的启动失败或接口异常。
多服务追踪的边界
Compose 的聚合日志适合单机或开发环境中的跨服务排障,但它不会自动生成跨服务请求链路。如果应用没有统一请求 ID,仅凭时间接近仍可能把并发请求混在一起。生产系统中的高并发关联通常还需要应用日志携带 request ID、trace ID,并交给集中式日志或链路追踪系统检索。
本地调试时,优先用“明确服务范围 + --tail 控制历史量 + --timestamps 对齐时间 + --follow 持续观察”的组合,就能覆盖大多数 Compose 多服务启动和调用故障。