mirror of
https://github.com/containers/podman.git
synced 2025-09-10 08:22:23 +08:00
52a8694705
Change the docs markdown so that flag names will be h4 headers. Sphinx will automatically add anchors to headers. Add css to make sure the flag names are not to big compared to the text. The man pages also still renders fine but it looks a bit different. Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
158 lines
5.0 KiB
Markdown
158 lines
5.0 KiB
Markdown
% 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 default logging
|
|
mechanism is *journald*. This can be changed in containers.conf by changing the `events_logger`
|
|
value to `file`. Only `file` and `journald` are accepted. A `none` logger is also
|
|
available but this logging mechanism completely disables events; nothing will be reported by
|
|
`podman events`.
|
|
|
|
By default, streaming mode is used, printing new events as they occur. Previous events can be listed via `--since` and `--until`.
|
|
|
|
The *container* event type will report the follow statuses:
|
|
* attach
|
|
* checkpoint
|
|
* cleanup
|
|
* commit
|
|
* create
|
|
* exec
|
|
* export
|
|
* import
|
|
* init
|
|
* kill
|
|
* mount
|
|
* pause
|
|
* prune
|
|
* remove
|
|
* restart
|
|
* 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 *system* type will report the following statuses:
|
|
* refresh
|
|
* renumber
|
|
|
|
The *volume* type will report the following statuses:
|
|
* create
|
|
* prune
|
|
* remove
|
|
|
|
|
|
## OPTIONS
|
|
|
|
#### **--help**
|
|
|
|
Print usage statement.
|
|
|
|
#### **--format**
|
|
|
|
Format the output to JSON Lines or using the given Go template.
|
|
|
|
|
|
#### **--filter**=*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
|
|
* label=key=value
|
|
* 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**=*timestamp*
|
|
|
|
Show all events created since the given timestamp
|
|
|
|
|
|
#### **--until**=*timestamp*
|
|
|
|
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)
|
|
```
|
|
|
|
Show Podman events in JSON Lines format
|
|
```
|
|
$ 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"}
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1), containers.conf(5)
|
|
|
|
## HISTORY
|
|
March 2019, Originally compiled by Brent Baude <bbaude@redhat.com>
|