github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-events.1.md (about)

     1  % podman-events(1)
     2  
     3  ## NAME
     4  podman\-events - Monitor Podman events
     5  
     6  ## SYNOPSIS
     7  **podman events** [*options*]
     8  
     9  ## DESCRIPTION
    10  
    11  Monitor and print events that occur in Podman. Each event will include a timestamp,
    12  a type, a status, name (if applicable), and image (if applicable).  The default logging
    13  mechanism is *journald*. This can be changed in containers.conf by changing the `events_logger`
    14  value to `file`.  Only `file` and `journald` are accepted. A `none` logger is also
    15  available but this logging mechanism completely disables events; nothing will be reported by
    16  `podman events`.
    17  
    18  By default, streaming mode is used, printing new events as they occur.  Previous events can be listed via `--since` and `--until`.
    19  
    20  The *container* event type will report the follow statuses:
    21   * attach
    22   * checkpoint
    23   * cleanup
    24   * commit
    25   * create
    26   * exec
    27   * export
    28   * import
    29   * init
    30   * kill
    31   * mount
    32   * pause
    33   * prune
    34   * remove
    35   * restart
    36   * restore
    37   * start
    38   * stop
    39   * sync
    40   * unmount
    41   * unpause
    42  
    43  The *pod* event type will report the follow statuses:
    44   * create
    45   * kill
    46   * pause
    47   * remove
    48   * start
    49   * stop
    50   * unpause
    51  
    52  The *image* event type will report the following statuses:
    53   * prune
    54   * pull
    55   * push
    56   * remove
    57   * save
    58   * tag
    59   * untag
    60  
    61  The *system* type will report the following statuses:
    62   * refresh
    63   * renumber
    64  
    65  The *volume* type will report the following statuses:
    66   * create
    67   * prune
    68   * remove
    69  
    70  
    71  ## OPTIONS
    72  
    73  #### **--help**
    74  
    75  Print usage statement.
    76  
    77  #### **--format**
    78  
    79  Format the output to JSON Lines or using the given Go template.
    80  
    81  
    82  #### **--filter**=*filter*
    83  
    84  Filter events that are displayed.  They must be in the format of "filter=value".  The following
    85  filters are supported:
    86   * container=name_or_id
    87   * event=event_status (described above)
    88   * image=name_or_id
    89   * label=key=value
    90   * pod=name_or_id
    91   * volume=name_or_id
    92   * type=event_type (described above)
    93  
    94  In the case where an ID is used, the ID may be in its full or shortened form.
    95  
    96  #### **--since**=*timestamp*
    97  
    98  Show all events created since the given timestamp
    99  
   100  
   101  #### **--until**=*timestamp*
   102  
   103  Show all events created until the given timestamp
   104  
   105  The *since* and *until* values can be RFC3339Nano time stamps or a Go duration string such as 10m, 5h. If no
   106  *since* or *until* values are provided, only new events will be shown.
   107  
   108  ## EXAMPLES
   109  
   110  Showing Podman events
   111  ```
   112  $ podman events
   113  2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   114  2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   115  2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   116  2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   117  2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   118  ```
   119  
   120  Show only Podman create events
   121  ```
   122  $ podman events --filter event=create
   123  2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse)
   124  2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=k8s.gcr.io/pause:3.1, name=3e701f270d54-infra)
   125  2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f)
   126  2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton)
   127  ```
   128  
   129  Show only Podman pod create events
   130  ```
   131  $ podman events --filter event=create --filter type=pod
   132  2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
   133  2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
   134  2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson)
   135  ```
   136  
   137  Show only Podman events created in the last five minutes:
   138  ```
   139  $ sudo podman events --since 5m
   140  2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=k8s.gcr.io/pause:3.1, name=1df5ebca7b44-infra)
   141  2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
   142  2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=k8s.gcr.io/pause:3.1, name=ca731231718e-infra)
   143  2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
   144  ```
   145  
   146  Show Podman events in JSON Lines format
   147  ```
   148  $ podman events --format json
   149  {"ID":"683b0909d556a9c02fa8cd2b61c3531a965db42158627622d1a67b391964d519","Image":"localhost/myshdemo:latest","Name":"agitated_diffie","Status":"cleanup","Time":"2019-04-27T22:47:00.849932843-04:00","Type":"container"}
   150  {"ID":"a0f8ab051bfd43f9c5141a8a2502139707e4b38d98ac0872e57c5315381e88ad","Image":"docker.io/library/alpine:latest","Name":"friendly_tereshkova","Status":"unmount","Time":"2019-04-28T13:43:38.063017276-04:00","Type":"container"}
   151  ```
   152  
   153  ## SEE ALSO
   154  podman(1), containers.conf(5)
   155  
   156  ## HISTORY
   157  March 2019, Originally compiled by Brent Baude <bbaude@redhat.com>