1podman-events(1)()                                          podman-events(1)()
2
3
4

NAME

6       podman-events - Monitor Podman events
7
8

SYNOPSIS

10       podman events [options]
11
12

DESCRIPTION

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        * 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
55
56       The pod event type will report the follow statuses:
57        * create
58        * kill
59        * pause
60        * remove
61        * start
62        * stop
63        * unpause
64
65
66       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
77
78       The system type will report the following statuses:
79        * refresh
80        * renumber
81
82
83       The volume type will report the following statuses:
84        * create
85        * prune
86        * remove
87
88

OPTIONS

90   --filter=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
101
102       In the case where an ID is used, the ID may be in its full or shortened
103       form.
104
105
106   --format
107       Format the output to JSON Lines or using the given Go template.
108
109
110   --help
111       Print usage statement.
112
113
114   --no-trunc
115       Do not truncate the output (default true).
116
117
118   --since=timestamp
119       Show all events created since the given timestamp
120
121
122   --until=timestamp
123       Show all events created until the given timestamp
124
125
126       The since and until values can be RFC3339Nano time stamps or a Go dura‐
127       tion  string such as 10m, 5h. If no since or until values are provided,
128       only new events will be shown.
129
130

EXAMPLES

132       Showing Podman events
133
134
135              $ podman events
136              2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
137              2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
138              2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
139              2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
140              2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
141
142
143
144       Show only Podman create events
145
146
147              $ podman events --filter event=create
148              2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse)
149              2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=k8s.gcr.io/pause:3.1, name=3e701f270d54-infra)
150              2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f)
151              2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton)
152
153
154
155       Show only Podman pod create events
156
157
158              $ podman events --filter event=create --filter type=pod
159              2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
160              2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
161              2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson)
162
163
164
165       Show only Podman events created in the last five minutes:
166
167
168              $ sudo podman events --since 5m
169              2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=k8s.gcr.io/pause:3.1, name=1df5ebca7b44-infra)
170              2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
171              2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=k8s.gcr.io/pause:3.1, name=ca731231718e-infra)
172              2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
173
174
175
176       Show Podman events in JSON Lines format
177
178
179              $ podman events --format json
180              {"ID":"683b0909d556a9c02fa8cd2b61c3531a965db42158627622d1a67b391964d519","Image":"localhost/myshdemo:latest","Name":"agitated_diffie","Status":"cleanup","Time":"2019-04-27T22:47:00.849932843-04:00","Type":"container"}
181              {"ID":"a0f8ab051bfd43f9c5141a8a2502139707e4b38d98ac0872e57c5315381e88ad","Image":"docker.io/library/alpine:latest","Name":"friendly_tereshkova","Status":"unmount","Time":"2019-04-28T13:43:38.063017276-04:00","Type":"container"}
182
183
184

SEE ALSO

186       podman(1), containers.conf(5)
187
188

HISTORY

190       March  2019,  Originally  compiled  by  Brent  Baude  bbaude@redhat.com
191       ⟨mailto:bbaude@redhat.com⟩
192
193
194
195                                                            podman-events(1)()
Impressum