docker compose events命令可实时监听容器生命周期事件，支持按服务、事件类型过滤及json结构化输出，用于调试依赖、验证就绪与排查重启问题。

直接用 docker compose events 命令就能实时监听当前 compose 项目的容器事件，它会持续输出容器创建、启动、停止、销毁等生命周期动作，是调试依赖顺序、验证服务就绪状态、排查反复重启问题的实用手段。

基础监听：默认行为与项目定位

在包含 docker-compose.yml（或 compose.yaml）的目录下执行：

• docker compose events —— 监听当前目录推导出的项目中所有服务的事件
• 若项目名非默认（比如用 --project-name myapp 启动过），需显式指定：docker compose --project-name myapp events
• 若配置文件不在当前目录或用了自定义名称（如 docker-compose.prod.yml），必须加 -f 参数：docker compose -f docker-compose.prod.yml events

聚焦特定服务或事件类型

避免信息过载，可按需过滤：

Learn Docker

通过 LabEx 容器基础课程和镜像/编排实验学习 Docker。Docker 课程和实验通过 LabEx MCP 获取，返回 labex.io 链接以继续。

下载

• 只监听某一个服务：docker compose events web（web 是 service 名）
• 同时监听多个服务：docker compose events api db worker
• 以结构化方式输出（便于脚本解析）：docker compose events --json，每行是一个 JSON 对象，含 status（如 "start"、"die"）、service、id、time 等字段

结合健康检查理解“真正就绪”

单纯看 start 事件容易误判——容器进程启动了，但服务未必可用。这时 events 可帮你验证健康检查是否生效：

• 确保依赖服务（如数据库）已定义 healthcheck，例如：
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U postgres"]
    interval: 5s
• 运行 docker compose events，观察是否出现 health_status: healthy 类事件（部分版本通过 docker events 更易捕获该细节，Compose events 当前主要反映容器层动作）
• 若看到 start 后长时间无 healthy，说明健康检查失败，应检查检测命令、权限或初始化耗时

实战提示：别只靠 events 做自动化响应

events 是只读通知流，本身不触发操作。如需自动处理（比如容器 die 后发告警），需配合外部工具：

• 用 Python + docker-py 订阅 /events API，解析 JSON 流并执行逻辑
• 用 shell 脚本管道处理：docker compose events --json | jq -r 'select(.status == "die") | .service' | xargs -r echo "ALERT:"
• 注意：events 命令退出后监听即中断；长期运行需加 nohup 或交由 systemd 管理