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