github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/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   * connect
    26   * create
    27   * disconnect
    28   * exec
    29   * exec_died
    30   * exited
    31   * export
    32   * import
    33   * init
    34   * kill
    35   * mount
    36   * pause
    37   * prune
    38   * remove
    39   * rename
    40   * restart
    41   * restore
    42   * start
    43   * stop
    44   * sync
    45   * unmount
    46   * unpause
    47  
    48  The *pod* event type will report the follow statuses:
    49   * create
    50   * kill
    51   * pause
    52   * remove
    53   * start
    54   * stop
    55   * unpause
    56  
    57  The *image* event type will report the following statuses:
    58   * loadFromArchive,
    59   * mount
    60   * pull
    61   * push
    62   * remove
    63   * save
    64   * tag
    65   * unmount
    66   * untag
    67  
    68  The *system* type will report the following statuses:
    69   * refresh
    70   * renumber
    71  
    72  The *volume* type will report the following statuses:
    73   * create
    74   * prune
    75   * remove
    76  
    77  
    78  ## OPTIONS
    79  
    80  #### **--filter**=*filter*
    81  
    82  Filter events that are displayed.  They must be in the format of "filter=value".  The following
    83  filters are supported:
    84   * container=name_or_id
    85   * event=event_status (described above)
    86   * image=name_or_id
    87   * label=key=value
    88   * pod=name_or_id
    89   * volume=name_or_id
    90   * type=event_type (described above)
    91  
    92  In the case where an ID is used, the ID may be in its full or shortened form.
    93  
    94  #### **--format**
    95  
    96  Format the output to JSON Lines or using the given Go template.
    97  
    98  #### **--help**
    99  
   100  Print usage statement.
   101  
   102  #### **--no-trunc**
   103  
   104  Do not truncate the output (default *true*).
   105  
   106  #### **--since**=*timestamp*
   107  
   108  Show all events created since the given timestamp
   109  
   110  
   111  #### **--until**=*timestamp*
   112  
   113  Show all events created until the given timestamp
   114  
   115  The *since* and *until* values can be RFC3339Nano time stamps or a Go duration string such as 10m, 5h. If no
   116  *since* or *until* values are provided, only new events will be shown.
   117  
   118  ## EXAMPLES
   119  
   120  Showing Podman events
   121  ```
   122  $ podman events
   123  2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   124  2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   125  2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   126  2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   127  2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
   128  ```
   129  
   130  Show only Podman create events
   131  ```
   132  $ podman events --filter event=create
   133  2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse)
   134  2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=k8s.gcr.io/pause:3.1, name=3e701f270d54-infra)
   135  2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f)
   136  2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton)
   137  ```
   138  
   139  Show only Podman pod create events
   140  ```
   141  $ podman events --filter event=create --filter type=pod
   142  2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
   143  2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
   144  2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson)
   145  ```
   146  
   147  Show only Podman events created in the last five minutes:
   148  ```
   149  $ sudo podman events --since 5m
   150  2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=k8s.gcr.io/pause:3.1, name=1df5ebca7b44-infra)
   151  2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
   152  2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=k8s.gcr.io/pause:3.1, name=ca731231718e-infra)
   153  2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
   154  ```
   155  
   156  Show Podman events in JSON Lines format
   157  ```
   158  $ podman events --format json
   159  {"ID":"683b0909d556a9c02fa8cd2b61c3531a965db42158627622d1a67b391964d519","Image":"localhost/myshdemo:latest","Name":"agitated_diffie","Status":"cleanup","Time":"2019-04-27T22:47:00.849932843-04:00","Type":"container"}
   160  {"ID":"a0f8ab051bfd43f9c5141a8a2502139707e4b38d98ac0872e57c5315381e88ad","Image":"docker.io/library/alpine:latest","Name":"friendly_tereshkova","Status":"unmount","Time":"2019-04-28T13:43:38.063017276-04:00","Type":"container"}
   161  ```
   162  
   163  ## SEE ALSO
   164  **[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
   165  
   166  ## HISTORY
   167  March 2019, Originally compiled by Brent Baude <bbaude@redhat.com>