---
title: "Monitor events"
method: GET
path: "/events"
tags: ["System"]
---

# Monitor events

`GET /events`

Stream real-time events from the server.

Various objects within Docker report events when something happens to them.

Containers report these events: `attach`, `commit`, `copy`, `create`, `destroy`, `detach`, `die`, `exec_create`, `exec_detach`, `exec_start`, `exec_die`, `export`, `health_status`, `kill`, `oom`, `pause`, `rename`, `resize`, `restart`, `start`, `stop`, `top`, `unpause`, `update`, and `prune`

Images report these events: `delete`, `import`, `load`, `pull`, `push`, `save`, `tag`, `untag`, and `prune`

Volumes report these events: `create`, `mount`, `unmount`, `destroy`, and `prune`

Networks report these events: `create`, `connect`, `disconnect`, `destroy`, `update`, `remove`, and `prune`

The Docker daemon reports these events: `reload`

Services report these events: `create`, `update`, and `remove`

Nodes report these events: `create`, `update`, and `remove`

Secrets report these events: `create`, `update`, and `remove`

Configs report these events: `create`, `update`, and `remove`

The Builder reports `prune` events

## Query parameters

- `since` string
- `until` string
- `filters` string

## Response `200`

no error

- EventMessage — EventMessage represents the information an event contains.
  - `Type` 'builder' | 'config' | 'container' | 'daemon' | 'image' | 'network' | 'node' | 'plugin' | 'secret' | 'service' | 'volume' — The type of object emitting the event
  - `Action` string — The type of event
  - `Actor` EventActor — Actor describes something that generates events, like a container, network, or a volume.
    - `ID` string — The ID of the object emitting the event
    - `Attributes` object — Various key/value attributes of the object, depending on its type.
  - `scope` 'local' | 'swarm' — Scope of the event. Engine events are `local` scope. Cluster (Swarm) events are `swarm` scope.
  - `time` integer — Timestamp of event
  - `timeNano` integer — Timestamp of event, with nanosecond accuracy

## Other responses

- `400` — bad parameter
- `500` — server error

---

[API](https://skmtc.net/aliyun/apis/docker-engine-api.md) · [All operations](https://skmtc.net/aliyun/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aliyun/docker-engine-api/versions/04bb09da9ccb/schema)