1podman-events(1)() podman-events(1)()
2
6 podman-events - Monitor Podman events
7
10 podman events [options]
11
14 Monitor and print events that occur in Podman. Each event will include
15 a timestamp, a type, a status, name (if applicable), and image (if
16 applicable). The default logging mechanism is journald. This can be
17 changed in libpod.conf by changing the events_logger value to file.
18 Only file and journald are accepted. A none logger is also available
19 but this logging mechanism completely disables events; nothing will be
20 reported by podman events.
21 The container event type will report the follow statuses:
24 * attach
25 * checkpoint
26 * cleanup
27 * commit
28 * create
29 * exec
30 * export
31 * import
32 * init
33 * kill
34 * mount
35 * pause
36 * prune
37 * remove
38 * restart
39 * restore
40 * start
41 * stop
42 * sync
43 * unmount
44 * unpause
45 The pod event type will report the follow statuses:
48 * create
49 * kill
50 * pause
51 * remove
52 * start
53 * stop
54 * unpause
55 The image event type will report the following statuses:
58 * prune
59 * pull
60 * push
61 * remove
62 * save
63 * tag
64 * untag
65 The system type will report the following statuses:
68 * refresh
69 * renumber
70 The volume type will report the following statuses:
73 * create
74 * prune
75 * remove
76
79 --help
80 Print usage statement.
83 --format
86 Format the output to JSON Lines or using the given Go template.
89 --filter=filter
92 Filter events that are displayed. They must be in the format of "fil‐
95 ter=value". The following filters are supported:
96 * container=name_or_id
97 * event=event_status (described above)
98 * image=name_or_id
99 * pod=name_or_id
100 * volume=name_or_id
101 * type=event_type (described above)
102 In the case where an ID is used, the ID may be in its full or shortened
105 form.
106 --since=timestamp
109 Show all events created since the given timestamp
112 --until=timestamp
115 Show all events created until the given timestamp
118 The since and until values can be RFC3339Nano time stamps or a Go dura‐
121 tion string such as 10m, 5h. If no since or until values are provided,
122 only new events will be shown.
123
126 Showing Podman events
127 $ podman events
130 2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
131 2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
132 2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
133 2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
134 2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
135 Show only Podman create events
139 $ podman events --filter event=create
142 2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse)
143 2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=k8s.gcr.io/pause:3.1, name=3e701f270d54-infra)
144 2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f)
145 2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton)
146 Show only Podman pod create events
150 $ podman events --filter event=create --filter type=pod
153 2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
154 2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
155 2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson)
156 Show only Podman events created in the last five minutes:
160 $ sudo podman events --since 5m
163 2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=k8s.gcr.io/pause:3.1, name=1df5ebca7b44-infra)
164 2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
165 2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=k8s.gcr.io/pause:3.1, name=ca731231718e-infra)
166 2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
167 Show Podman events in JSON Lines format
171 events --format json
174 {"ID":"683b0909d556a9c02fa8cd2b61c3531a965db42158627622d1a67b391964d519","Image":"localhost/myshdemo:latest","Name":"agitated_diffie","Status":"cleanup","Time":"2019-04-27T22:47:00.849932843-04:00","Type":"container"}
175 {"ID":"a0f8ab051bfd43f9c5141a8a2502139707e4b38d98ac0872e57c5315381e88ad","Image":"docker.io/library/alpine:latest","Name":"friendly_tereshkova","Status":"unmount","Time":"2019-04-28T13:43:38.063017276-04:00","Type":"container"}
176
180 podman(1)
181
184 March 2019, Originally compiled by Brent Baude bbaude@redhat.com
185 ⟨mailto:bbaude@redhat.com⟩
186 podman-events(1)()