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        * 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

OPTIONS

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

EXAMPLES

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

SEE ALSO

175       podman(1), containers.conf(5)
176
177

HISTORY

179       March  2019,  Originally  compiled  by  Brent  Baude  bbaude@redhat.com
180       ⟨mailto:bbaude@redhat.com⟩
181
182
183
184                                                            podman-events(1)()
Impressum