Display pod information

View details about your pods, including status and associated containers. This helps you monitor the health and configuration of your pod groups.

Before you begin

  • The container-tools meta-package is installed.
  • The pod has been created. For details, see section Creating pods.

About this task

Note

Beginning with Podman v5.0.0, pod output is always a JSON array, regardless of the number of pods.

For more information, see the podman-pod-top(1), podman-pod-stats(1), and podman-pod-inspect(1) man pages on your system.

Procedure

Display active processes running in a pod:
  • To display the running processes of containers in a pod, enter: 
    $ podman pod top mypod
     
    USER   PID   PPID   %CPU    ELAPSED         TTY     TIME   COMMAND
0      1     0      0.000   24.077433518s   ?       0s     /pause
root   1     0      0.000   24.078146025s   pts/0   0s     /bin/bash
  • To display a live stream of resource usage stats for containers in one or more pods, enter: 
    $ podman pod stats -a --no-stream
     
    ID             NAME              CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
a9f807ffaacd   frosty_hodgkin    --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
3b33001239ee   sleepy_stallman   --      -- / --             --      -- / --   -- / --    --
  • To display information describing the pod, enter: 
    $ podman pod inspect --format json <POD_ID_1> <POD_ID_2> <POD_ID_3>
     
    [
  {
      "CgroupParent": "/libpod_parent",
      "Containers": [
        {
          "ID": "...",
          "State": "..."
        }
      ],
      "Created": "2025-10-16T12:00:00.000000000Z",
      "ID": "673f326c9f69b0d24c0847f97a544c79532817d2a713917812f865f1e8e52a8a",
      "InfraContainerID": "...",
      "Labels": {},
      "Name": "web_pod",
      "State": "Running",
    },
    {
      "CgroupParent": "/libpod_parent",
      "Containers": [
        {
          "ID": "...",
          "State": "..."
        }
      ],
      "Created": "2025-10-16T12:01:00.000000000Z",
      "ID": "a1b2c3d4e5f678901234567890abcdef1234567890abcdef1234567890abcdef",
      "InfraContainerID": "...",
      "Labels": {},
      "Name": "db_pod",
      "State": "Running",
    }
]

    You can see information about containers in the pod.