github.com/ld86/docker@v1.7.1-rc3/man/docker-events.1.md (about)

     1  % DOCKER(1) Docker User Manuals
     2  % Docker Community
     3  % JUNE 2014
     4  # NAME
     5  docker-events - Get real time events from the server
     6  
     7  # SYNOPSIS
     8  **docker events**
     9  [**--help**]
    10  [**-f**|**--filter**[=*[]*]]
    11  [**--since**[=*SINCE*]]
    12  [**--until**[=*UNTIL*]]
    13  
    14  
    15  # DESCRIPTION
    16  Get event information from the Docker daemon. Information can include historical
    17  information and real-time information.
    18  
    19  Docker containers will report the following events:
    20  
    21      create, destroy, die, export, kill, pause, restart, start, stop, unpause
    22  
    23  and Docker images will report:
    24  
    25      untag, delete
    26  
    27  # OPTIONS
    28  **--help**
    29    Print usage statement
    30  
    31  **-f**, **--filter**=[]
    32     Provide filter values (i.e., 'event=stop')
    33  
    34  **--since**=""
    35     Show all events created since timestamp
    36  
    37  **--until**=""
    38     Stream events until this timestamp
    39  
    40  # EXAMPLES
    41  
    42  ## Listening for Docker events
    43  
    44  After running docker events a container 786d698004576 is started and stopped
    45  (The container name has been shortened in the output below):
    46  
    47      # docker events
    48      2015-01-28T20:21:31.000000000-08:00 59211849bc10: (from whenry/testimage:latest) start
    49      2015-01-28T20:21:31.000000000-08:00 59211849bc10: (from whenry/testimage:latest) die
    50      2015-01-28T20:21:32.000000000-08:00 59211849bc10: (from whenry/testimage:latest) stop
    51  
    52  ## Listening for events since a given date
    53  Again the output container IDs have been shortened for the purposes of this document:
    54  
    55      # docker events --since '2015-01-28'
    56      2015-01-28T20:25:38.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) create
    57      2015-01-28T20:25:38.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start
    58      2015-01-28T20:25:39.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) create
    59      2015-01-28T20:25:39.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start
    60      2015-01-28T20:25:40.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) die
    61      2015-01-28T20:25:42.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) stop
    62      2015-01-28T20:25:45.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) start
    63      2015-01-28T20:25:45.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) die
    64      2015-01-28T20:25:46.000000000-08:00 c21f6c22ba27: (from whenry/testimage:latest) stop
    65  
    66  
    67  If you do not provide the --since option, the command returns only new and/or
    68  live events.
    69  
    70  # HISTORY
    71  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    72  based on docker.com source material and internal work.
    73  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
    74  June 2015, updated by Brian Goff <cpuguy83@gmail.com>