Files
podman/docs/source/markdown/podman-pod-logs.1.md.in
Daniel J Walsh bc5a4fbb23 Fix up example description of podman-pod commands
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2024-02-19 10:03:30 -05:00

70 lines
1.8 KiB
Markdown

% podman-pod-logs 1
## NAME
podman\-pod\-logs - Display 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: A long-running `podman pod log` command with a `-f` or `--follow` option needs to be reinvoked if a new container is added to the pod dynamically; otherwise, logs of newly added containers are not visible in the log stream.
## OPTIONS
@@option color
#### **--container**, **-c**
By default, `podman pod logs` retrieves logs for all the containers available within the pod, differentiated by the field `container`. However, there are use cases where the user wants 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)**