mirror of
https://github.com/containers/podman.git
synced 2025-06-17 06:57:43 +08:00
Add event logging to libpod, even display to podman
In lipod, we now log major events that occurr. These events can be displayed using the `podman events` command. Each event contains: * Type (container, image, volume, pod...) * Status (create, rm, stop, kill, ....) * Timestamp in RFC3339Nano format * Name (if applicable) * Image (if applicable) The format of the event and the varlink endpoint are to not be considered stable until cockpit has done its enablement. Signed-off-by: baude <bbaude@redhat.com>
This commit is contained in:
baude
139
docs/podman-events.1.md
Normal file
139
docs/podman-events.1.md
Normal file
@ -0,0 +1,139 @@
|
||||
% 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
|
||||
* wait
|
||||
|
||||
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>
|
||||
Reference in New Issue
Block a user