名称

podman-stats - 显示一个或多个容器资源使用情况的实时流

简介

podman stats [选项] [容器]

podman container stats [选项] [容器]

描述

显示一个或多个容器资源使用情况的实时流

注意:无根(Rootless)环境无法报告其网络使用情况的统计信息。

选项

--all, -a

显示所有容器。默认仅显示正在运行的容器

--format=模板

将容器统计信息以 JSON 格式或使用 Go 模板进行美化输出

Go 模板的有效占位符如下所列

占位符

描述

.AvgCPU

平均 CPU 使用率,全精度浮点数

.AVGCPU

平均 CPU 使用率,以百分比格式显示

.BlockInput

从块设备读取的总数据量

.BlockIO

从块设备读取的总数据量 / 写入的总数据量

.BlockOutput

写入块设备的总数据量

.ContainerID

容器 ID,完整的(未截断的)哈希值

.ContainerStats …

嵌套结构,仅供专家使用

.CPU

CPU 百分比,全精度浮点数

.CPUNano

CPU 总使用量,以纳秒为单位

.CPUPerc

CPU 使用百分比

.CPUSystemNano

CPU 内核使用量,以纳秒为单位

.Duration

与 CPUNano 相同

.ID

容器 ID,已截断

.MemLimit

内存限制,以字节为单位

.MemPerc

内存使用百分比

.MemUsage

内存使用量

.MemUsageBytes

内存使用量 (IEC 标准)

.Name

容器名称

.NetIO

网络 I/O

.Network …

按网络接口分类的网络 I/O

.PIDs

PID 数量

.PIDS

PID 数量(是的,我们知道这重复了)

.SystemNano

当前系统日期时间,自 Unix 纪元以来的纳秒数

.Up

持续时间 (CPUNano),以人类可读格式显示

.UpTime

与 Up 相同

使用 Go 模板时,可在格式前加上 table 来打印标题。

--interval, -i=秒数

统计报告的时间间隔(以秒为单位),默认为 5 秒。

--latest, -l

不提供容器名称或 ID,而是使用最后创建的容器。注意:最后启动的容器可能来自主机上其他 Podman 用户。(此选项在远程 Podman 客户端中不可用,包括 Mac 和 Windows(WSL2 除外)机器)

--no-reset

在报告间隔之间不清除终端/屏幕

--no-stream

禁用统计信息流,仅获取第一个结果,默认设置为 false

--no-trunc

不截断输出

示例

列出所有正在运行的容器的统计信息,不使用流模式

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

以流模式列出指定容器的统计信息

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

以表格格式列出指定容器的特定统计信息

$ podman stats --no-trunc 3667 --format 'table {{ .ID }} {{ .MemUsage }}'
ID                                                                MEM USAGE / LIMIT
3667c6aacb06aac2eaffce914c01736420023d56ef9b0f4cfe58b6d6a78b7503  49.15kB / 67.17GB

以 JSON 格式列出指定容器的统计信息

# podman 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"
    }
]

以表格格式列出指定容器的统计信息

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

注意:当使用带有 rootlesskit 端口处理程序的无根网络时,通过端口转发发送的流量会计入 lo 设备。计入 lo 的流量不会计入统计输出。

另请参阅

podman(1)

历史

2017 年 7 月,最初由 Ryan Cole 编写 rycole@redhat.com