github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-pod-logs.1.md.in (about)

     1  % podman-pod-logs 1
     2  
     3  ## NAME
     4  podman\-pod\-logs - Display logs for pod with one or more containers
     5  
     6  ## SYNOPSIS
     7  **podman pod logs** [*options*] *pod*
     8  
     9  ## DESCRIPTION
    10  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.
    11  
    12  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.
    13  
    14  ## OPTIONS
    15  
    16  @@option color
    17  
    18  #### **--container**, **-c**
    19  
    20  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`.
    21  
    22  @@option follow
    23  
    24  @@option latest
    25  
    26  @@option names
    27  
    28  @@option since
    29  
    30  @@option tail
    31  
    32  @@option timestamps
    33  
    34  @@option until
    35  
    36  ## EXAMPLE
    37  
    38  To view a pod's logs:
    39  ```
    40  podman pod logs -t podIdorName
    41  ```
    42  
    43  To view logs of a specific container on the pod:
    44  ```
    45  podman pod logs -c ctrIdOrName podIdOrName
    46  ```
    47  
    48  To view all pod logs:
    49  ```
    50  podman pod logs -t --since 0 myserver-pod-1
    51  ```
    52  
    53  To view a pod's logs since a certain time:
    54  ```
    55  podman pod logs -t --since 2017-08-07T10:10:09.055837383-04:00 myserver-pod-1
    56  ```
    57  
    58  To view a pod's logs generated in the last 10 minutes:
    59  ```
    60  podman pod logs --since 10m myserver-pod-1
    61  ```
    62  
    63  To view a pod's logs until 30 minutes ago:
    64  ```
    65  podman pod logs --until 30m myserver-pod-1
    66  ```
    67  
    68  ## SEE ALSO
    69  **[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)**