dwww Home | Manual pages | Find package

podman-pod-logs(1)          General Commands Manual          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 dynami-
       cally; otherwise, logs of newly added containers are not visible in  the
       log stream.

OPTIONS
   --color
       Output the containers with different colors in the log.

   --container, -c
       By default, podman pod logs retrieves logs for all the containers avail-
       able  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.

   --follow, -f
       Follow log output.  Default is false.

       Note:  When following a pod which is removed by podman pod rm or removed
       on exit (podman run --rm ...), there is a chance that the  log  file  is
       removed before podman pod logs reads the final content.

   --latest, -l
       Instead  of  providing  the  pod  name  or ID, use the last created pod.
       Note: the last started pod can be from other users of Podman on the host
       machine.  (This option is not available with the remote  Podman  client,
       including Mac and Windows (excluding WSL2) machines)

   --names, -n
       Output the container names instead of the container IDs in the log.

   --since=TIMESTAMP
       Show  logs  since  TIMESTAMP. The --since option can be Unix timestamps,
       date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) com-
       puted relative to the client machine's time. Supported formats for  date
       formatted time stamps include RFC3339Nano, RFC3339, 2006-01-02T15:04:05,
       2006-01-02T15:04:05.999999999, 2006-01-02Z07:00, and 2006-01-02.

   --tail=LINES
       Output the specified number of LINES at the end of the logs.  LINES must
       be an integer.  Defaults to -1, which prints all lines

   --timestamps, -t
       Show timestamps in the log outputs.  The default is false

   --until=TIMESTAMP
       Show  logs  until  TIMESTAMP. The --until option can be Unix timestamps,
       date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) com-
       puted relative to the client machine's time. Supported formats for  date
       formatted time stamps include RFC3339Nano, RFC3339, 2006-01-02T15:04:05,
       2006-01-02T15:04:05.999999999, 2006-01-02Z07:00, and 2006-01-02.

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-pod(1), podman-pod-rm(1), podman-logs(1)

                                                             podman-pod-logs(1)

Generated by dwww version 1.16 on Tue Dec 16 06:37:59 CET 2025.