©
本文档使用 PHP中文网手册 发布
从服务器获取实时事件
docker events [OPTIONS]
名字，简写 | 默认 | 描述 |
|---|---|---|
--filter, -f | 根据提供的条件过滤输出 | |
--format | 使用给定的Go模板格式化输出 | |
--since | 显示自时间戳以来创建的所有事件 | |
--until | 在此时间戳之前将事件流化 |
命令 | 描述 |
|---|---|
docker | Docker CLI的基本命令。 |
用docker events从服务器获取实时事件。这些事件根据Docker对象类型而不同。
Docker容器报告以下事件：
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
update
Docker图像报告了以下事件：
delete
import
load
pull
push
save
tag
untag
Docker 插件报告下列事件：
enable
disable
install
remove
Docker卷报告了下列事件：
create
destroy
mount
unmount
Docker 网络报告了下列事件：
create
connect
destroy
disconnect
remove
Docker 守护进程报告下列事件：
reload服务码头服务部门报告下列事件：
create
remove
update
Docker 节点报告下列事件：
create
remove
update
Docker secrets 报告下列事件：
create
remove
update
Docker configs 报告了下列事件：
create
remove
update
--since和--until参数可以是Unix的时间戳，日期格式时间戳，或持续时间的字符串（例如10m，1h30m）来计算相对于客户机的时间。如果您不提供该--since选项，则该命令仅返回新事件和/或现场事件。支持的格式为日期格式时间戳包括RFC3339Nano，RFC3339， 2006-01-02T15:04:05，2006-01-02T15:04:05.999999999，2006-01-02Z07:00和2006-01-02。如果您不提供a Z或a ，客户端将使用本地时区+-00:00时间戳结束时的时区偏移量。在提供Unix时间戳时输入seconds.nanoseconds，其中seconds是自1970年1月1日（UTC / GMT）以来经过的秒数，不包括闰秒（又名Unix纪元或Unix时间）以及可选的.nanoseconds字段是一秒不超过九位数的一小部分。
过滤标志（-f或--filter）格式为“key = value”。如果你想使用多个过滤器，传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）
多次使用相同的过滤器将作为 OR 处理; 例如--filter container=588a23dac085 --filter container=a8f7720b8c22将显示容器 588a23dac085 或容器 a8f7720b8c22 的事件
使用多个过滤器将作为 AND 处理; 例如--filter container=588a23dac085 --filter event=start将显示事件容器容器 588a23dac085 与事件类型是开始
目前支持的过滤器是：
容器（container=<name or id>）
守护进程（daemon=<name or id>）
事件（event=<event action>）
image（image=<tag or id>）
标签（label=<key>或label=<key>=<value>）
网络（network=<name or id>）
plugin（plugin=<name or id>）
范围（scope=<local or swarm>）
type（type=<container or image or volume or network or daemon or plugin or service or node or secret or config>）
volume（volume=<name or id>）
如果--format指定了format（），则将执行给定模板而不是默认格式。Go的文本/模板包描述了格式的所有细节。
如果格式设置为{{json .}}，则事件将作为有效的JSON行进行流式传输。有关JSON行的信息，请参阅http://jsonlines.org/。
对于这个例子，您需要两个shell。
shell 1：侦听事件：
$ docker events
Shell 2：启动和停止容器：
$ docker create --name test alpine:latest top $ docker start test $ docker stop test
Shell 1:：（再次..现在显示事件）：
2017-01-05T00:35:58.859401177+08:00 container create 0fdb48addc82871eb34eb23a847cfd033dedd1a0a37bef2e6d9eb3870fc7ff37 (image=alpine:latest, name=test)2017-01-05T00:36:04.703631903+08:00 network connect e2e1f5ceda09d4300f3a846f0acfaa9a8bb0d89e775eb744c5acecd60e0529e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:04.795031609+08:00 container start 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:36:09.830268747+08:00 container kill 0fdb...ff37 (image=alpine:latest, name=test, signal=15)2017-01-05T00:36:09.840186338+08:00 container die 0fdb...ff37 (exitCode=143, image=alpine:latest, name=test)2017-01-05T00:36:09.880113663+08:00 network disconnect e2e...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:09.890214053+08:00 container stop 0fdb...ff37 (image=alpine:latest, name=test)
要退出docker events命令，请使用CTRL+C。
您可以使用以下不同的时间语法在主机上按绝对时间戳或相对时间过滤输出：
$ docker events --since 14832838042017-01-05T00:35:41.241772953+08:00 volume create testVol (driver=local)2017-01-05T00:35:58.859401177+08:00 container create d9cd...4d70 (image=alpine:latest, name=test)2017-01-05T00:36:04.703631903+08:00 network connect e2e1...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:04.795031609+08:00 container start 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:36:09.830268747+08:00 container kill 0fdb...ff37 (image=alpine:latest, name=test, signal=15)2017-01-05T00:36:09.840186338+08:00 container die 0fdb...ff37 (exitCode=143, image=alpine:latest, name=test)2017-01-05T00:36:09.880113663+08:00 network disconnect e2e...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:09.890214053+08:00 container stop 0fdb...ff37 (image=alpine:latest, name=test)$ docker events --since '2017-01-05'2017-01-05T00:35:41.241772953+08:00 volume create testVol (driver=local)2017-01-05T00:35:58.859401177+08:00 container create d9cd...4d70 (image=alpine:latest, name=test)2017-01-05T00:36:04.703631903+08:00 network connect e2e1...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:04.795031609+08:00 container start 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:36:09.830268747+08:00 container kill 0fdb...ff37 (image=alpine:latest, name=test, signal=15)2017-01-05T00:36:09.840186338+08:00 container die 0fdb...ff37 (exitCode=143, image=alpine:latest, name=test)2017-01-05T00:36:09.880113663+08:00 network disconnect e2e...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:09.890214053+08:00 container stop 0fdb...ff37 (image=alpine:latest, name=test)$ docker events --since '2013-09-03T15:49:29'2017-01-05T00:35:41.241772953+08:00 volume create testVol (driver=local)2017-01-05T00:35:58.859401177+08:00 container create d9cd...4d70 (image=alpine:latest, name=test)2017-01-05T00:36:04.703631903+08:00 network connect e2e1...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:04.795031609+08:00 container start 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:36:09.830268747+08:00 container kill 0fdb...ff37 (image=alpine:latest, name=test, signal=15)2017-01-05T00:36:09.840186338+08:00 container die 0fdb...ff37 (exitCode=143, image=alpine:latest, name=test)2017-01-05T00:36:09.880113663+08:00 network disconnect e2e...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:09.890214053+08:00 container stop 0fdb...ff37 (image=alpine:latest, name=test)$ docker events --since '10m'2017-01-05T00:35:41.241772953+08:00 volume create testVol (driver=local)2017-01-05T00:35:58.859401177+08:00 container create d9cd...4d70 (image=alpine:latest, name=test)2017-01-05T00:36:04.703631903+08:00 network connect e2e1...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:04.795031609+08:00 container start 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:36:09.830268747+08:00 container kill 0fdb...ff37 (image=alpine:latest, name=test, signal=15)2017-01-05T00:36:09.840186338+08:00 container die 0fdb...ff37 (exitCode=143, image=alpine:latest, name=test)2017-01-05T00:36:09.880113663+08:00 network disconnect e2e...29e2 (container=0fdb...ff37, name=bridge, type=bridge)2017-01-05T00:36:09.890214053+08:00 container stop 0fdb...ff37 (image=alpine:latest, name=test)
以下命令显示了几种不同的方法来过滤docker event输出。
$ docker events --filter 'event=stop'2017-01-05T00:40:22.880175420+08:00 container stop 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:41:17.888104182+08:00 container stop 2a8f...4e78 (image=alpine, name=kickass_brattain)$ docker events --filter 'image=alpine'2017-01-05T00:41:55.784240236+08:00 container create d9cd...4d70 (image=alpine, name=happy_meitner)2017-01-05T00:41:55.913156783+08:00 container start d9cd...4d70 (image=alpine, name=happy_meitner)2017-01-05T00:42:01.106875249+08:00 container kill d9cd...4d70 (image=alpine, name=happy_meitner, signal=15)2017-01-05T00:42:11.111934041+08:00 container kill d9cd...4d70 (image=alpine, name=happy_meitner, signal=9)2017-01-05T00:42:11.119578204+08:00 container die d9cd...4d70 (exitCode=137, image=alpine, name=happy_meitner)2017-01-05T00:42:11.173276611+08:00 container stop d9cd...4d70 (image=alpine, name=happy_meitner)$ docker events --filter 'container=test'2017-01-05T00:43:00.139719934+08:00 container start 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:43:09.259951086+08:00 container kill 0fdb...ff37 (image=alpine:latest, name=test, signal=15)2017-01-05T00:43:09.270102715+08:00 container die 0fdb...ff37 (exitCode=143, image=alpine:latest, name=test)2017-01-05T00:43:09.312556440+08:00 container stop 0fdb...ff37 (image=alpine:latest, name=test)$ docker events --filter 'container=test' --filter 'container=d9cdb1525ea8'2017-01-05T00:44:11.517071981+08:00 container start 0fdb...ff37 (image=alpine:latest, name=test)2017-01-05T00:44:17.685870901+08:00 container start d9cd...4d70 (image=alpine, name=happy_meitner)2017-01-05T00:44:29.757658470+08:00 container kill 0fdb...ff37 (image=alpine:latest, name=test, signal=9)2017-01-05T00:44:29.767718510+08:00 container die 0fdb...ff37 (exitCode=137, image=alpine:latest, name=test)2017-01-05T00:44:29.815798344+08:00 container destroy 0fdb...ff37 (image=alpine:latest, name=test)$ docker events --filter 'container=test' --filter 'event=stop'2017-01-05T00:46:13.664099505+08:00 container stop a9d1...e130 (image=alpine, name=test)$ docker events --filter 'type=volume'2015-12-23T21:05:28.136212689Z volume create test-event-volume-local (driver=local)2015-12-23T21:05:28.383462717Z volume mount test-event-volume-local (read/write=true, container=562f...5025, destination=/foo, driver=local, propagation=rprivate)2015-12-23T21:05:28.650314265Z volume unmount test-event-volume-local (container=562f...5025, driver=local)2015-12-23T21:05:28.716218405Z volume destroy test-event-volume-local (driver=local)$ docker events --filter 'type=network'2015-12-23T21:38:24.705709133Z network create 8b11...2c5b (name=test-event-network-local, type=bridge)2015-12-23T21:38:25.119625123Z network connect 8b11...2c5b (name=test-event-network-local, container=b4be...c54e, type=bridge)$ docker events --filter 'container=container_1' --filter 'container=container_2'2014-09-03T15:49:29.999999999Z07:00 container die 4386fb97867d (image=ubuntu-1:14.04)2014-05-10T17:42:14.999999999Z07:00 container stop 4386fb97867d (image=ubuntu-1:14.04)2014-05-10T17:42:14.999999999Z07:00 container die 7805c1d35632 (imager=redis:2.8)2014-09-03T15:49:29.999999999Z07:00 container stop 7805c1d35632 (image=redis:2.8)$ docker events --filter 'type=volume'2015-12-23T21:05:28.136212689Z volume create test-event-volume-local (driver=local)2015-12-23T21:05:28.383462717Z volume mount test-event-volume-local (read/write=true, container=562fe10671e9273da25eed36cdce26159085ac7ee6707105fd534866340a5025, destination=/foo, driver=local, propagation=rprivate)2015-12-23T21:05:28.650314265Z volume unmount test-event-volume-local (container=562fe10671e9273da25eed36cdce26159085ac7ee6707105fd534866340a5025, driver=local)2015-12-23T21:05:28.716218405Z volume destroy test-event-volume-local (driver=local)$ docker events --filter 'type=network'2015-12-23T21:38:24.705709133Z network create 8b111217944ba0ba844a65b13efcd57dc494932ee2527577758f939315ba2c5b (name=test-event-network-local, type=bridge)2015-12-23T21:38:25.119625123Z network connect 8b111217944ba0ba844a65b13efcd57dc494932ee2527577758f939315ba2c5b (name=test-event-network-local, container=b4be644031a3d90b400f88ab3d4bdf4dc23adb250e696b6328b85441abe2c54e, type=bridge)$ docker events --filter 'type=plugin'2016-07-25T17:30:14.825557616Z plugin pull ec7b87f2ce84330fe076e666f17dfc049d2d7ae0b8190763de94e1f2d105993f (name=tiborvass/sample-volume-plugin:latest)2016-07-25T17:30:14.888127370Z plugin enable ec7b87f2ce84330fe076e666f17dfc049d2d7ae0b8190763de94e1f2d105993f (name=tiborvass/sample-volume-plugin:latest)$ docker events -f type=service2017-07-12T06:34:07.999446625Z service create wj64st89fzgchxnhiqpn8p4oj (name=reverent_albattani)2017-07-12T06:34:21.405496207Z service remove wj64st89fzgchxnhiqpn8p4oj (name=reverent_albattani)$ docker events -f type=node2017-07-12T06:21:51.951586759Z node update 3xyz5ttp1a253q74z1thwywk9 (name=ip-172-31-23-42, state.new=ready, state.old=unknown)$ docker events -f type=secret2017-07-12T06:32:13.915704367Z secret create s8o6tmlnndrgzbmdilyy5ymju (name=new_secret)2017-07-12T06:32:37.052647783Z secret remove s8o6tmlnndrgzbmdilyy5ymju (name=new_secret)$ docker events -f type=config2017-07-12T06:44:13.349037127Z config create u96zlvzdfsyb9sg4mhyxfh3rl (name=abc)2017-07-12T06:44:36.327694184Z config remove u96zlvzdfsyb9sg4mhyxfh3rl (name=abc)$ docker events --filter 'scope=swarm'2017-07-10T07:46:50.250024503Z service create m8qcxu8081woyof7w3jaax6gk (name=affectionate_wilson)2017-07-10T07:47:31.093797134Z secret create 6g5pufzsv438p9tbvl9j94od4 (name=new_secret)
$ docker events --filter 'type=container' --format 'Type={{.Type}} Status={{.Status}} ID={{.ID}}'Type=container Status=create ID=2ee349dac409e97974ce8d01b70d250b85e0ba8189299c126a87812311951e26
Type=container Status=attach ID=2ee349dac409e97974ce8d01b70d250b85e0ba8189299c126a87812311951e26
Type=container Status=start ID=2ee349dac409e97974ce8d01b70d250b85e0ba8189299c126a87812311951e26
Type=container Status=resize ID=2ee349dac409e97974ce8d01b70d250b85e0ba8189299c126a87812311951e26
Type=container Status=die ID=2ee349dac409e97974ce8d01b70d250b85e0ba8189299c126a87812311951e26
Type=container Status=destroy ID=2ee349dac409e97974ce8d01b70d250b85e0ba8189299c126a87812311951e26 $ docker events --format '{{json .}}' {"status":"create","id":"196016a57679bf42424484918746a9474cd905dd993c4d0f4.. {"status":"attach","id":"196016a57679bf42424484918746a9474cd905dd993c4d0f4.. {"Type":"network","Action":"connect","Actor":{"ID":"1b50a5bf755f6021dfa78e.. {"status":"start","id":"196016a57679bf42424484918746a9474cd905dd993c4d0f42.. {"status":"resize","id":"196016a57679bf42424484918746a9474cd905dd993c4d0f4..