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