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
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
22
23       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
46
47       The pod event type will report the follow statuses:
48        * create
49        * kill
50        * pause
51        * remove
52        * start
53        * stop
54        * unpause
55
56
57       The image event type will report the following statuses:
58        * prune
59        * pull
60        * push
61        * remove
62        * save
63        * tag
64        * untag
65
66
67       The system type will report the following statuses:
68        * refresh
69        * renumber
70
71
72       The volume type will report the following statuses:
73        * create
74        * prune
75        * remove
76
77

OPTIONS

79       --help
80
81
82       Print usage statement.
83
84
85       --format
86
87
88       Format the output to JSON Lines or using the given Go template.
89
90
91       --filter=filter
92
93
94       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
103
104       In the case where an ID is used, the ID may be in its full or shortened
105       form.
106
107
108       --since=timestamp
109
110
111       Show all events created since the given timestamp
112
113
114       --until=timestamp
115
116
117       Show all events created until the given timestamp
118
119
120       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
124

EXAMPLES

126       Showing Podman events
127
128
129              $ 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
136
137
138       Show only Podman create events
139
140
141              $ 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
147
148
149       Show only Podman pod create events
150
151
152              $ 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
157
158
159       Show only Podman events created in the last five minutes:
160
161
162              $ 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
168
169
170       Show Podman events in JSON Lines format
171
172
173              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
177
178

SEE ALSO

180       podman(1)
181
182

HISTORY

184       March  2019,  Originally  compiled  by  Brent  Baude  bbaude@redhat.com
185       ⟨mailto:bbaude@redhat.com⟩
186
187
188
189                                                            podman-events(1)()
Impressum