github.com/fcwu/docker@v1.4.2-0.20150115145920-2a69ca89f0df/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  [**--since**[=*SINCE*]]
    11  [**--until**[=*UNTIL*]]
    12  
    13  
    14  # DESCRIPTION
    15  Get event information from the Docker daemon. Information can include historical
    16  information and real-time information.
    17  
    18  Docker containers will report the following events:
    19  
    20      create, destroy, die, export, kill, pause, restart, start, stop, unpause
    21  
    22  and Docker images will report:
    23  
    24      untag, delete
    25  
    26  # OPTIONS
    27  **--help**
    28    Print usage statement
    29  
    30  **--since**=""
    31     Show all events created since timestamp
    32  
    33  **--until**=""
    34     Stream events until this timestamp
    35  
    36  # EXAMPLES
    37  
    38  ## Listening for Docker events
    39  
    40  After running docker events a container 786d698004576 is started and stopped
    41  (The container name has been shortened in the output below):
    42  
    43      # docker events
    44      [2014-04-12 18:23:04 -0400 EDT] 786d69800457: (from whenry/testimage:latest) start
    45      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) die
    46      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) stop
    47  
    48  ## Listening for events since a given date
    49  Again the output container IDs have been shortened for the purposes of this document:
    50  
    51      # docker events --since '2014-04-12'
    52      [2014-04-12 18:11:28 -0400 EDT] c655dbf640dc: (from whenry/testimage:latest) create
    53      [2014-04-12 18:11:28 -0400 EDT] c655dbf640dc: (from whenry/testimage:latest) start
    54      [2014-04-12 18:14:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) create
    55      [2014-04-12 18:14:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) start
    56      [2014-04-12 18:22:44 -0400 EDT] 786d69800457: (from whenry/testimage:latest) die
    57      [2014-04-12 18:22:44 -0400 EDT] 786d69800457: (from whenry/testimage:latest) stop
    58      [2014-04-12 18:23:04 -0400 EDT] 786d69800457: (from whenry/testimage:latest) start
    59      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) die
    60      [2014-04-12 18:23:13 -0400 EDT] 786d69800457: (from whenry/testimage:latest) stop
    61  
    62  # HISTORY
    63  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    64  based on docker.com source material and internal work.
    65  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>