podman-pod-stats(1)

💅 podman-pod-stats(1) — General Commands Manual 💅

okay bestie, welcome to the manual page for podman-pod-stats ✨ (that's the man page name right there in the header, we love a title drop)

---

🌸 NAME 🌸

podman-pod-stats — display a live stream of resource usage stats for containers in one or more pods 🫶

---

✨ SYNOPSIS ✨

podman pod stats [options] [pod]

---

🦋 DESCRIPTION 🦋

So basically? It shows you a live stream of the resource usage statistics of the containers inside one or more pods. real-time tea, constantly updating 💖

heads up: running rootless is only supported on cgroups v2. no cgroups v2, no rootless vibes, that's just how it is 😭

---

🎀 OPTIONS 🎀

• --all, -a — show all the containers. by default only running containers get shown, so this is the "I want everybody" button 👑
• --format=template — pretty-print the container statistics as JSON, or using a Go template. slay ✨

Here are the valid placeholders for the Go template, no cap:

• .BlockIO — Block IO
• .CID — Container ID
• .CPU — CPU percentage
• .Mem — Memory percentage
• .MemUsage — Memory usage
• .MemUsageBytes — Memory usage (IEC)
• .Name — Container Name
• .NetIO — Network IO
• .PIDS — Number of PIDs
• .Pod — Pod ID

and when you're using a Go template, put table in front of the format to print the headers 💅

• --latest, -l — instead of handing over the pod name or ID, just use the last created pod. convenient fr fr.

note: the last started pod can be from other users of Podman on the host machine 👀 (and this option is not available with the remote Podman client, including Mac and Windows machines — excluding WSL2 🫠)

• --no-reset — don't clear the terminal/screen in between reporting intervals. keep that scrollback, babe 🧚
• --no-stream — disables streaming pod stats and only pulls the first result. default setting is false 🌈

---

💜 EXAMPLES 💜

List statistics about all pods without streaming:

# 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   --      -- / --             --      -- / --   -- / --    --

List statistics about specified pod without streaming:

# podman pod stats --no-stream a9f80
ID             NAME             CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
a9f807ffaacd   frosty_hodgkin   --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2

List statistics about specified pod in JSON format without streaming:

# podman pod stats --no-stream --format=json a9f80
[
    {
        "id": "a9f807ffaacd",
        "name": "frosty_hodgkin",
        "cpu_percent": "--",
        "mem_usage": "3.092MB / 16.7GB",
        "mem_percent": "0.02%",
        "netio": "-- / --",
        "blocki": "-- / --",
        "pids": "2"
    }
]

List selected statistics formatted in a table about specified pod:

# podman pod stats --no-stream --format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
ID             NAME           MEM USAGE / LIMIT
6eae9e25a564   clever_bassi   3.031MB / 16.7GB

---

👑 SEE ALSO 👑

podman(1), podman-pod(1)

---

🍓 HISTORY 🍓

February 2019, Originally compiled by Dan Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩

---

and that's the whole page, bestie 🎀 it lives under the podman-pod-stats(1) name in the manual, and it's part of the podman docs, compiled way back in February 2019 by Dan Walsh. iconic, honestly. periodt 💖✨🦋