.nh .TH podman-events 1 .SH NAME .PP podman-events - Monitor Podman events .SH SYNOPSIS .PP \fBpodman events\fP [\fIoptions\fP] .SH DESCRIPTION .PP Monitor and print events that occur in Podman. Each event will include a timestamp, a type, a status, name (if applicable), and image (if applicable). The default logging mechanism is \fIjournald\fP\&. This can be changed in containers.conf by changing the \fB\fCevents_logger\fR value to \fB\fCfile\fR\&. Only \fB\fCfile\fR and \fB\fCjournald\fR are accepted. A \fB\fCnone\fR logger is also available but this logging mechanism completely disables events; nothing will be reported by \fB\fCpodman events\fR\&. .PP By default, streaming mode is used, printing new events as they occur. Previous events can be listed via \fB\fC--since\fR and \fB\fC--until\fR\&. .PP The \fIcontainer\fP event type will report the follow statuses: * attach * checkpoint * cleanup * commit * connect * create * disconnect * exec * exec_died * exited * export * import * init * kill * mount * pause * prune * remove * rename * restart * restore * start * stop * sync * unmount * unpause .PP The \fIpod\fP event type will report the follow statuses: * create * kill * pause * remove * start * stop * unpause .PP The \fIimage\fP event type will report the following statuses: * loadFromArchive, * mount * pull * push * remove * save * tag * unmount * untag .PP The \fIsystem\fP type will report the following statuses: * refresh * renumber .PP The \fIvolume\fP type will report the following statuses: * create * prune * remove .SH OPTIONS .SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP .PP Filter events that are displayed. They must be in the format of "filter=value". The following filters are supported: * container=name_or_id * event=event_status (described above) * image=name_or_id * label=key=value * pod=name_or_id * volume=name_or_id * type=event_type (described above) .PP In the case where an ID is used, the ID may be in its full or shortened form. .SS \fB--format\fP .PP Format the output to JSON Lines or using the given Go template. .TS allbox; l l l l . \fB\fC\fBPlaceholder\fP\fR \fB\fC\fBDescription\fP\fR \&.Attributes T{ created_at, _by, labels, and more (map[]) T} \&.ContainerExitCode Exit code (int) \&.Details ... T{ Internal structure, not actually useful T} \&.HealthStatus Health Status (string) \&.ID Container ID (full 64-bit SHA) \&.Image T{ Name of image being run (string) T} \&.Name Container name (string) \&.Network T{ Name of network being used (string) T} \&.Status T{ Event status (e.g., create, start, died, ...) T} \&.Time Event timestamp (string) \&.Type T{ Event type (e.g., image, container, pod, ...) T} .TE .SS \fB--help\fP .PP Print usage statement. .SS \fB--no-trunc\fP .PP Do not truncate the output (default \fItrue\fP). .SS \fB--since\fP=\fItimestamp\fP .PP Show all events created since the given timestamp .SS \fB--until\fP=\fItimestamp\fP .PP Show all events created until the given timestamp .PP The \fIsince\fP and \fIuntil\fP values can be RFC3339Nano time stamps or a Go duration string such as 10m, 5h. If no \fIsince\fP or \fIuntil\fP values are provided, only new events will be shown. .SH EXAMPLES .PP Showing Podman events .PP .RS .nf $ podman events 2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen) 2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen) 2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen) 2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen) 2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen) .fi .RE .PP Show only Podman create events .PP .RS .nf $ podman events -f event=create 2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse) 2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=k8s.gcr.io/pause:3.1, name=3e701f270d54-infra) 2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f) 2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton) .fi .RE .PP Show only Podman pod create events .PP .RS .nf $ podman events --filter event=create --filter type=pod 2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking) 2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp) 2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson) .fi .RE .PP Show only Podman events created in the last five minutes: .PP .RS .nf $ sudo podman events --since 5m 2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=k8s.gcr.io/pause:3.1, name=1df5ebca7b44-infra) 2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking) 2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=k8s.gcr.io/pause:3.1, name=ca731231718e-infra) 2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp) .fi .RE .PP Show Podman events in JSON Lines format .PP .RS .nf $ podman events --format json {"ID":"683b0909d556a9c02fa8cd2b61c3531a965db42158627622d1a67b391964d519","Image":"localhost/myshdemo:latest","Name":"agitated_diffie","Status":"cleanup","Time":"2019-04-27T22:47:00.849932843-04:00","Type":"container"} {"ID":"a0f8ab051bfd43f9c5141a8a2502139707e4b38d98ac0872e57c5315381e88ad","Image":"docker.io/library/alpine:latest","Name":"friendly_tereshkova","Status":"unmount","Time":"2019-04-28T13:43:38.063017276-04:00","Type":"container"} .fi .RE .SH SEE ALSO .PP \fBpodman(1)\fP, \fBcontainers.conf(5)\fP .SH HISTORY .PP March 2019, Originally compiled by Brent Baude bbaude@redhat.com \[la]mailto:bbaude@redhat.com\[ra]