?
This document uses PHP Chinese website manual Release
從服務(wù)器獲取實(shí)時(shí)事件
docker events [OPTIONS]
名字,簡寫 | 默認(rèn) | 描述 |
---|---|---|
--filter, -f | 根據(jù)提供的條件過濾輸出 | |
--format | 使用給定的Go模板格式化輸出 | |
--since | 顯示自時(shí)間戳以來創(chuàng)建的所有事件 | |
--until | 在此時(shí)間戳之前將事件流化 |
命令 | 描述 |
---|---|
docker | Docker CLI的基本命令。 |
用docker events
從服務(wù)器獲取實(shí)時(shí)事件。這些事件根據(jù)Docker對(duì)象類型而不同。
Docker容器報(bào)告以下事件:
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圖像報(bào)告了以下事件:
delete
import
load
pull
push
save
tag
untag
Docker 插件報(bào)告下列事件:
enable
disable
install
remove
Docker卷報(bào)告了下列事件:
create
destroy
mount
unmount
Docker 網(wǎng)絡(luò)報(bào)告了下列事件:
create
connect
destroy
disconnect
remove
Docker 守護(hù)進(jìn)程報(bào)告下列事件:
reload
服務(wù)碼頭服務(wù)部門報(bào)告下列事件:
create
remove
update
Docker 節(jié)點(diǎn)報(bào)告下列事件:
create
remove
update
Docker secrets 報(bào)告下列事件:
create
remove
update
Docker configs 報(bào)告了下列事件:
create
remove
update
--since
和--until
參數(shù)可以是Unix的時(shí)間戳,日期格式時(shí)間戳,或持續(xù)時(shí)間的字符串(例如10m
,1h30m
)來計(jì)算相對(duì)于客戶機(jī)的時(shí)間。如果您不提供該--since
選項(xiàng),則該命令僅返回新事件和/或現(xiàn)場事件。支持的格式為日期格式時(shí)間戳包括RFC3339Nano,RFC3339, 2006-01-02T15:04:05
,2006-01-02T15:04:05.999999999
,2006-01-02Z07:00
和2006-01-02
。如果您不提供a Z
或a ,客戶端將使用本地時(shí)區(qū)+-00:00
時(shí)間戳結(jié)束時(shí)的時(shí)區(qū)偏移量。在提供Unix時(shí)間戳?xí)r輸入seconds.nanoseconds,其中seconds是自1970年1月1日(UTC / GMT)以來經(jīng)過的秒數(shù),不包括閏秒(又名Unix紀(jì)元或Unix時(shí)間)以及可選的.nanoseconds字段是一秒不超過九位數(shù)的一小部分。
過濾標(biāo)志(-f
或--filter
)格式為“key = value”。如果你想使用多個(gè)過濾器,傳遞多個(gè)標(biāo)志(例如--filter "foo=bar" --filter "bif=baz"
)
多次使用相同的過濾器將作為 OR 處理; 例如--filter container=588a23dac085 --filter container=a8f7720b8c22
將顯示容器 588a23dac085 或容器 a8f7720b8c22 的事件
使用多個(gè)過濾器將作為 AND 處理; 例如--filter container=588a23dac085 --filter event=start
將顯示事件容器容器 588a23dac085 與事件類型是開始
目前支持的過濾器是:
容器(container=<name or id>
)
守護(hù)進(jìn)程(daemon=<name or id>
)
事件(event=<event action>
)
image(image=<tag or id>
)
標(biāo)簽(label=<key>
或label=<key>=<value>
)
網(wǎng)絡(luò)(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(),則將執(zhí)行給定模板而不是默認(rèn)格式。Go的文本/模板包描述了格式的所有細(xì)節(jié)。
如果格式設(shè)置為{{json .}}
,則事件將作為有效的JSON行進(jìn)行流式傳輸。有關(guān)JSON行的信息,請(qǐng)參閱http://jsonlines.org/。
對(duì)于這個(gè)例子,您需要兩個(gè)shell。
shell 1:偵聽事件:
$ docker events
Shell 2:啟動(dòng)和停止容器:
$ docker create --name test alpine:latest top $ docker start test $ docker stop test
Shell 1::(再次..現(xiàn)在顯示事件):
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
命令,請(qǐng)使用CTRL+C
。
您可以使用以下不同的時(shí)間語法在主機(jī)上按絕對(duì)時(shí)間戳或相對(duì)時(shí)間過濾輸出:
$ 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..