docker / docker/compose

`docker compose events` only reports container events, and silently drops network/volume/image events

Open
#13,700 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

stale
Dominant language
Go
Stars
38.2k
Forks
5.8k
Avg merge
2d 14h
Merged PRs (30d)
55

Description

Description

docker compose events currently only reports container-level events (start, stop, die, etc.). All other event types from the Docker API - such as network, volume, and image events are silently dropped.

The Docker engine already returns these events via the project filter, but Compose discards them before they reach the consumer.

Supporting additional event types would give users better visibility into what's happening across their services - particularly useful for debugging network connectivity issues, volume lifecycle problems, and image pull/build activity.

Possible approach (open to feedback):

  • Handle network, volume, and image event types in addition to container
  • Add a Type field to api.Event so consumers can distinguish event types
  • For non-container events, derive the resource identity from event.Actor.ID and event.Actor.Attributes instead of requiring a service label
  • Add unit tests

If core maintainers are in agreement with this feature/enhancement, then I will happily work on this.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the docker compose events entry point and trace where Docker API events are filtered before reaching consumers. Review api.Event and the proposed handling for container, network, volume, and image events, then add unit tests that verify event types and resource identities are preserved.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, docker-compose, go
Domain
devops, infrastructure
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
66/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.