other versions
- jessie-backports 1.6.2~dfsg1-1~bpo8+1
- testing 18.09.1+dfsg1-5+b10
- unstable 18.09.1+dfsg1-5+b10
- experimental 18.09.3+dfsg1-1
DOCKER(1) | JUNE 2014 | DOCKER(1) |
NAME¶
docker-events - Get real time events from the serverSYNOPSIS¶
docker events [ --help] [ -f|--filter[=[]]] [ --since[=SINCE]] [ --until[=UNTIL]]DESCRIPTION¶
Get event information from the Docker daemon. Information can include historical information and real-time information. Docker containers will report the following events:create, destroy, die, export, kill, pause, restart, start, stop, unpause
untag, delete
OPTIONS¶
--helpPrint usage statement -f, --filter=[]
Provide filter values (i.e., 'event=stop') --since=""
Show all events created since timestamp --until=""
Stream events until this timestamp
EXAMPLES¶
Listening for Docker events¶
After running docker events a container 786d698004576 is started and stopped (The container name has been shortened in the output below):# docker events 2015-01-28T20:21:31.000000000-08:00 59211849bc10: (from whenry/testimage:latest) start 2015-01-28T20:21:31.000000000-08:00 59211849bc10: (from whenry/testimage:latest) die 2015-01-28T20:21:32.000000000-08:00 59211849bc10: (from whenry/testimage:latest) stop
Listening for events since a given date¶
Again the output container IDs have been shortened for the purposes of this document:# docker events --since '2015-01-28' 2015-01-28T20:25:38.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) create 2015-01-28T20:25:38.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start 2015-01-28T20:25:39.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) create 2015-01-28T20:25:39.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start 2015-01-28T20:25:40.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) die 2015-01-28T20:25:42.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) stop 2015-01-28T20:25:45.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start 2015-01-28T20:25:45.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) die 2015-01-28T20:25:46.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) stop
HISTORY¶
April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. June 2014, updated by Sven Dowideit ⟨SvenDowideit@home.org.au⟩Docker User Manuals | Docker Community |