github.com/eikeon/docker@v1.5.0-rc4/docs/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      [2014-04-12 18:23:04 -0400 EDT] 786d69800457: (from whenry/testimage:latest) start
    49      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) die
    50      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (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 '2014-04-12'
    56      [2014-04-12 18:11:28 -0400 EDT] c655dbf640dc: (from whenry/testimage:latest) create
    57      [2014-04-12 18:11:28 -0400 EDT] c655dbf640dc: (from whenry/testimage:latest) start
    58      [2014-04-12 18:14:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) create
    59      [2014-04-12 18:14:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) start
    60      [2014-04-12 18:22:44 -0400 EDT] 786d69800457: (from whenry/testimage:latest) die
    61      [2014-04-12 18:22:44 -0400 EDT] 786d69800457: (from whenry/testimage:latest) stop
    62      [2014-04-12 18:23:04 -0400 EDT] 786d69800457: (from whenry/testimage:latest) start
    63      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) die
    64      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) stop
    65  
    66  # HISTORY
    67  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    68  based on docker.com source material and internal work.
    69  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>