1podman-events(1) General Commands Manual 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 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 By default, streaming mode is used, printing new events as they occur.
24 Previous events can be listed via --since and --until.
25 The container event type will report the follow statuses:
28 * attach
29 * checkpoint
30 * cleanup
31 * commit
32 * connect
33 * create
34 * disconnect
35 * exec
36 * exec_died
37 * exited
38 * export
39 * import
40 * init
41 * kill
42 * mount
43 * pause
44 * prune
45 * remove
46 * rename
47 * restart
48 * restore
49 * start
50 * stop
51 * sync
52 * unmount
53 * unpause
54 The pod event type will report the follow statuses:
57 * create
58 * kill
59 * pause
60 * remove
61 * start
62 * stop
63 * unpause
64 The image event type will report the following statuses:
67 * loadFromArchive,
68 * mount
69 * pull
70 * push
71 * remove
72 * save
73 * tag
74 * unmount
75 * untag
76 The system type will report the following statuses:
79 * refresh
80 * renumber
81 The volume type will report the following statuses:
84 * create
85 * prune
86 * remove
87
90 --filter, -f=filter
91 Filter events that are displayed. They must be in the format of "fil‐
92 ter=value". The following filters are supported:
93 * container=name_or_id
94 * event=event_status (described above)
95 * image=name_or_id
96 * label=key=value
97 * pod=name_or_id
98 * volume=name_or_id
99 * type=event_type (described above)
100 In the case where an ID is used, the ID may be in its full or shortened
103 form.
104 --format
107 Format the output to JSON Lines or using the given Go template.
108 ┌───────────────────┬────────────────────────────────┐
111 │Placeholder │ Description │
112 ├───────────────────┼────────────────────────────────┤
113 │.Attributes │ created_at, _by, labels, and │
114 │ │ more (map[]) │
115 ├───────────────────┼────────────────────────────────┤
116 │.ContainerExitCode │ Exit code (int) │
117 ├───────────────────┼────────────────────────────────┤
118 │.Details ... │ Internal structure, not actu‐ │
119 │ │ ally useful │
120 ├───────────────────┼────────────────────────────────┤
121 │.HealthStatus │ Health Status (string) │
122 ├───────────────────┼────────────────────────────────┤
123 │.ID │ Container ID (full 64-bit SHA) │
124 ├───────────────────┼────────────────────────────────┤
125 │.Image │ Name of image being run │
126 │ │ (string) │
127 ├───────────────────┼────────────────────────────────┤
128 │.Name │ Container name (string) │
129 ├───────────────────┼────────────────────────────────┤
130 │.Network │ Name of network being used │
131 │ │ (string) │
132 ├───────────────────┼────────────────────────────────┤
133 │.Status │ Event status (e.g., create, │
134 │ │ start, died, ...) │
135 ├───────────────────┼────────────────────────────────┤
136 │.Time │ Event timestamp (string) │
137 ├───────────────────┼────────────────────────────────┤
138 │.Type │ Event type (e.g., image, con‐ │
139 │ │ tainer, pod, ...) │
140 └───────────────────┴────────────────────────────────┘
141 --help
143 Print usage statement.
144 --no-trunc
147 Do not truncate the output (default true).
148 --since=timestamp
151 Show all events created since the given timestamp
152 --until=timestamp
155 Show all events created until the given timestamp
156 The since and until values can be RFC3339Nano time stamps or a Go dura‐
159 tion string such as 10m, 5h. If no since or until values are provided,
160 only new events will be shown.
161
164 Showing Podman events
165 $ podman events
168 2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
169 2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
170 2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
171 2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
172 2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
173 Show only Podman create events
177 $ podman events -f event=create
180 2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse)
181 2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=k8s.gcr.io/pause:3.1, name=3e701f270d54-infra)
182 2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f)
183 2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton)
184 Show only Podman pod create events
188 $ podman events --filter event=create --filter type=pod
191 2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
192 2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
193 2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson)
194 Show only Podman events created in the last five minutes:
198 $ sudo podman events --since 5m
201 2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=k8s.gcr.io/pause:3.1, name=1df5ebca7b44-infra)
202 2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
203 2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=k8s.gcr.io/pause:3.1, name=ca731231718e-infra)
204 2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
205 Show Podman events in JSON Lines format
209 $ podman events --format json
212 {"ID":"683b0909d556a9c02fa8cd2b61c3531a965db42158627622d1a67b391964d519","Image":"localhost/myshdemo:latest","Name":"agitated_diffie","Status":"cleanup","Time":"2019-04-27T22:47:00.849932843-04:00","Type":"container"}
213 {"ID":"a0f8ab051bfd43f9c5141a8a2502139707e4b38d98ac0872e57c5315381e88ad","Image":"docker.io/library/alpine:latest","Name":"friendly_tereshkova","Status":"unmount","Time":"2019-04-28T13:43:38.063017276-04:00","Type":"container"}
214
218 podman(1), containers.conf(5)
219
222 March 2019, Originally compiled by Brent Baude bbaude@redhat.com
223 ⟨mailto:bbaude@redhat.com⟩
224 podman-events(1)