名称¶
podman-stats - 显示一个或多个容器资源使用统计的实时流
简介¶
podman stats [选项] [容器]
podman container stats [选项] [容器]
描述¶
显示一个或多个容器资源使用统计的实时流
注意:Podman stats 在使用 CGroups V1 的无根环境中不起作用。Podman stats 依赖 CGroup 信息进行统计,而 CGroup v1 不支持无根用例。
注意:使用 CGroups V2 的无根环境无法报告其网络使用情况的统计信息。
选项¶
--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 |
网络 IO |
.Network … |
网络 I/O,按网络接口分隔 |
.PerCPU |
所有任务消耗的 CPU 时间 [1] |
.PIDs |
PID 数量 |
.PIDS |
PID 数量(是的,我们知道这是一个重复) |
.SystemNano |
当前系统日期时间,自纪元以来的纳秒数 |
.Up |
持续时间 (CPUNano),以人类可读的形式 |
.UpTime |
同 Up |
[1] 仅适用于 Cgroups V1
使用 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 端口处理程序的 slirp4netns 网络时,通过端口转发发送的流量会计入 lo
设备。计入 lo
的流量不计入统计输出。
另请参阅¶
历史¶
2017 年 7 月,最初由 Ryan Cole rycole@redhat.com 编译