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
聚焦特定服务或事件类型
避免信息过载，可按需过滤：
- 只监听某一个服务：
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订阅/eventsAPI，解析 JSON 流并执行逻辑 - 用 shell 脚本管道处理：
docker compose events --json | jq -r 'select(.status == "die") | .service' | xargs -r echo "ALERT:" - 注意：events 命令退出后监听即中断；长期运行需加
nohup或交由 systemd 管理
