容器与云原生 / 系统课时

查看服务日志与状态

查看服务日志与状态

本课解决 Compose 项目运行后“哪个服务异常、日志说了什么、容器里进程是否正常”这类问题。你将用服务名统一查看状态、日志和进程,并进入运行中的服务执行最小诊断命令。

学习目标

  • 查看 Compose 项目内全部服务的运行状态
  • 按服务筛选近期日志并持续跟踪输出
  • 检查容器进程并进入指定服务执行诊断命令

一次确认整体状态

在 compose.yaml 所在目录执行以下命令。--all 会同时显示运行中和已退出的容器,适合先判断问题属于“未启动”“反复重启”还是“运行中但不可用”。

bash
docker compose ps --all

预期输出

text
NAME                  IMAGE          SERVICE   STATUS                    PORTS
<PROJECT>-api-1       <IMAGE>        api       Up <TIME>                 0.0.0.0:<PORT>->8080/tcp
<PROJECT>-worker-1    <IMAGE>        worker    Exited (<ID>) <TIME> ago

名称、时间、端口和退出码会随环境变化。重点查看 SERVICE 与 STATUS:Up 表示容器仍在运行,Exited 后的数字是主进程退出码,Restarting 通常说明启动命令持续失败。

按服务查看日志

Compose 命令优先使用服务名,而不是自动生成的容器名。下面只读取 api 最近十分钟内的最后 100 行日志,并保持跟踪。

bash
docker compose logs --since=10m --tail=100 --timestamps --follow api

预期输出

text
<PROJECT>-api-1  | <TIME> INFO  application started
<PROJECT>-api-1  | <TIME> ERROR connection refused

命令会持续等待新日志,按 Ctrl+C 只会退出日志查看,不会停止容器。排查多服务调用链时,可以在命令末尾同时写入多个服务名,例如 api worker。

检查服务内进程

日志只能反映应用主动输出的信息。需要确认主进程、子进程或启动参数时,使用 top 查看指定服务容器中的进程列表。

bash
docker compose top api

预期输出

text
UID    PID    PPID   C   STIME   TTY   TIME       CMD
root   <ID>   <ID>   0   <TIME>  ?     00:00:01   <COMMAND>

PID 等动态值以实际结果为准。若服务存在多个副本,输出会按容器分组;此时应结合 docker compose ps 先确认异常副本。

进入服务执行诊断

exec 在已经运行的服务容器中启动新进程,不会创建新容器。以下示例验证镜像中是否存在 sh,并确认命令可以在 api 服务内执行。

bash
docker compose exec api sh -lc 'echo service-shell-ok'

预期输出

text
service-shell-ok

如果提示服务未运行,先用 docker compose ps --all 检查状态,再执行 docker compose up -d api。如果镜像不包含 sh,应改用镜像实际提供的诊断命令,不能假设所有精简镜像都有完整 Shell 工具。

推荐的定位顺序

先看 ps --all 确认生命周期状态,再看近期日志定位应用错误,然后用 top 检查进程,最后才进入容器执行针对性命令。这个顺序能避免一开始就进入容器盲目试错,也能保留更清晰的故障证据。

本课总结

  • docker compose ps --all 用于快速判断服务是否运行、退出或重启
  • docker compose logs 支持按服务、时间和行数过滤,并可持续跟踪
  • top 与 exec 分别用于检查进程和执行容器内诊断命令

下一课预告

下一课将使用 Compose Profiles 控制调试、监控和辅助服务是否参与当前环境的启动。

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

目录与阅读设置

阅读设置

17

记录一个想法

查看服务日志与状态

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

登录哪都通