mirror of https://github.com/containers/podman.git
				
				
				
			
		
			
				
	
	
		
			70 lines
		
	
	
		
			1.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
			
		
		
	
	
			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)**
 |