Skip to content

Latest commit

 

History

History
138 lines (107 loc) · 3.94 KB

podman-events.1.md

File metadata and controls

138 lines (107 loc) · 3.94 KB
Raw

% podman-events(1)

NAME

podman-events - Monitor Podman events

SYNOPSIS

podman events [options]

DESCRIPTION

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 container event type will report the follow statuses:

  • attach
  • checkpoint
  • cleanup
  • commit
  • create
  • exec
  • export
  • import
  • init
  • kill
  • mount
  • pause
  • prune
  • remove
  • restore
  • start
  • stop
  • sync
  • unmount
  • unpause

The pod event type will report the follow statuses:

  • create
  • kill
  • pause
  • remove
  • start
  • stop
  • unpause

The image event type will report the following statuses:

  • prune
  • pull
  • push
  • remove
  • save
  • tag
  • untag

The volume type will report the following statuses:

  • create
  • prune
  • remove

OPTIONS

--help

Print usage statement.

--format

Format the output using the given Go template. An output value of json is not supported.

--filter=[]

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
  • pod=name_or_id
  • volume=name_or_id
  • type=event_type (described above)

In the case where an ID is used, the ID may be in its full or shortened form.

--since=[]

Show all events created since the given timestamp

--until=[]

Show all events created until the given timestamp

The since and until values can be RFC3339Nano time stamps or a Go duration string such as 10m, 5h. If no since or until values are provided, only new events will be shown.

EXAMPLES

Showing podman events

$ 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)

Show only podman create events

$ podman events --filter 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)

Show only podman pod create events

$ 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)

Show only podman events created in the last five minutes:

$ 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)

SEE ALSO

podman(1)

HISTORY

March 2019, Originally compiled by Brent Baude bbaude@redhat.com