名称

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 的流量不计入统计输出。

另请参阅

podman(1)

历史

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