podman/docs/source/markdown/podman-pod-logs.1.md.in

70 lines
1.8 KiB
Markdown

% podman-pod-logs 1
## NAME
podman\-pod\-logs - Displays logs for pod with one or more containers
## SYNOPSIS
**podman pod logs** [*options*] *pod*
## DESCRIPTION
The podman pod logs command batch-retrieves whatever logs are present with all the containers of a pod. Pod logs can be filtered by container name or ID using flag **-c** or **--container** if needed.
Note: Long running command of `podman pod log` with a `-f` or `--follow` needs to be reinvoked if new container is added to the pod dynamically otherwise logs of newly added containers would not be visible in log stream.
## OPTIONS
@@option color
#### **--container**, **-c**
By default `podman pod logs` retrieves logs for all the containers available within the pod differentiate by field `container`. However there are use-cases where user would want to limit the log stream only to a particular container of a pod for such cases `-c` can be used like `podman pod logs -c ctrNameorID podname`.
@@option follow
@@option latest
@@option names
@@option since
@@option tail
@@option timestamps
@@option until
## EXAMPLE
To view a pod's logs:
```
podman pod logs -t podIdorName
```
To view logs of a specific container on the pod
```
podman pod logs -c ctrIdOrName podIdOrName
```
To view all pod logs:
```
podman pod logs -t --since 0 myserver-pod-1
```
To view a pod's logs since a certain time:
```
podman pod logs -t --since 2017-08-07T10:10:09.055837383-04:00 myserver-pod-1
```
To view a pod's logs generated in the last 10 minutes:
```
podman pod logs --since 10m myserver-pod-1
```
To view a pod's logs until 30 minutes ago:
```
podman pod logs --until 30m myserver-pod-1
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **[podman-pod-rm(1)](podman-pod-rm.1.md)**, **[podman-logs(1)](podman-logs.1.md)**