Monitor events

/v1.33

GET

/events

System

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, export, health_status, kill, oom, pause, rename, resize, restart, start, stop, top, unpause, and update

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

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

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

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

Response Example

200 - response

{
    "Action": "create",
    "Actor": {
        "Attributes": {
            "com.example.some-label": "some-label-value",
            "image": "alpine",
            "name": "my-container"
        },
        "ID": "ede54ee1afda366ab42f824e8a5ffd195155d853ceaec74a927f249ea270c743"
    },
    "Type": "container",
    "time": 1461943101
}

Request

Query Params

since

string

optional

Show events created since this timestamp then stream new events.

until

string

optional

Show events created until this timestamp then stop streaming.

filters

string

optional

A JSON encoded value of filters (a map[string][]string) to process on the event list. Available filters:

config=<string> config name or ID
container=<string> container name or ID
daemon=<string> daemon name or ID
event=<string> event type
image=<string> image name or ID
label=<string> image or container label
network=<string> network name or ID
node=<string> node ID
plugin= plugin name or ID
scope＝ local or swarm
secret=<string> secret name or ID
service=<string> service name or ID
type=<string> object to filter by, one of container, image, volume, network, daemon, plugin, node, service, secret or config
volume=<string> volume name

Responses

🟢200no error

application/json

Body

Action

string

optional

The type of event

Actor

object

optional

Attributes

object

optional

Various key/value attributes of the object, depending on its type

string

optional

The ID of the object emitting the event

Type

string

optional

The type of object emitting the event

time

integer

optional

Timestamp of event

timeNano

integer <int64>

optional

Timestamp of event, with nanosecond accuracy

🟠400bad parameter

🔴500server error

Modified at 2022-09-10 17:56:06

Check auth configuration

Get system information