1podman-events(1)            General Commands Manual           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 the accepted.
19
20
21       The container event type will report the follow statuses:
22        * attach
23        * checkpoint
24        * cleanup
25        * commit
26        * create
27        * exec
28        * export
29        * import
30        * init
31        * kill
32        * mount
33        * pause
34        * prune
35        * remove
36        * restart
37        * restore
38        * start
39        * stop
40        * sync
41        * unmount
42        * unpause
43
44
45       The pod event type will report the follow statuses:
46        * create
47        * kill
48        * pause
49        * remove
50        * start
51        * stop
52        * unpause
53
54
55       The image event type will report the following statuses:
56        * prune
57        * pull
58        * push
59        * remove
60        * save
61        * tag
62        * untag
63
64
65       The volume type will report the following statuses:
66        * create
67        * prune
68        * remove
69
70

OPTIONS

72       --help
73
74
75       Print usage statement.
76
77
78       --format
79
80
81       Format the output using the given Go template.  An output value of json
82       is not supported.
83
84
85       --filter=[]
86
87
88       Filter events that are displayed.  They must be in the format of
89       "filter=value".  The following filters are supported:
90        * container=name_or_id
91        * event=event_status (described above)
92        * image=name_or_id
93        * pod=name_or_id
94        * volume=name_or_id
95        * type=event_type (described above)
96
97
98       In the case where an ID is used, the ID may be in its full or shortened
99       form.
100
101
102       --since=[]
103
104
105       Show all events created since the given timestamp
106
107
108       --until=[]
109
110
111       Show all events created until the given timestamp
112
113
114       The since and until values can be RFC3339Nano time stamps or a Go
115       duration string such as 10m, 5h. If no since or until values are
116       provided, only new events will be shown.
117
118

EXAMPLES

120       Showing podman events
121
122
123              $ podman events
124              2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
125              2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
126              2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
127              2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
128              2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
129
130
131
132       Show only podman create events
133
134
135              $ podman events --filter event=create
136              2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse)
137              2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=k8s.gcr.io/pause:3.1, name=3e701f270d54-infra)
138              2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f)
139              2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton)
140
141
142
143       Show only podman pod create events
144
145
146              $ podman events --filter event=create --filter type=pod
147              2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
148              2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
149              2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson)
150
151
152
153       Show only podman events created in the last five minutes:
154
155
156              $ sudo podman events --since 5m
157              2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=k8s.gcr.io/pause:3.1, name=1df5ebca7b44-infra)
158              2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
159              2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=k8s.gcr.io/pause:3.1, name=ca731231718e-infra)
160              2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
161
162
163

SEE ALSO

165       podman(1)
166
167

HISTORY

169       March 2019, Originally compiled by Brent Baude ⟨bbaude@redhat.com⟩
170
171
172
173                                                              podman-events(1)