docker stats命令讲解

jiakai

# Docker Stats命令详解

`docker stats`是Docker提供的一个命令行工具，用于实时显示容器的资源使用情况，包括CPU、内存、网络I/O和磁盘I/O等指标 [5](https://docs.docker.com/engine/containers/runmetrics/)。

## 基本语法

```bash
docker stats [选项] [容器...]
```

如果不指定具体容器，该命令会显示所有运行中容器的资源使用情况 [4](https://docker-docs.uclv.cu/engine/reference/commandline/stats/)。

## 命令功能

`docker stats`命令会返回一个实时数据流，持续显示容器的运行时指标 [5](https://docs.docker.com/engine/containers/runmetrics/)。它提供的主要信息包括：

- CPU使用率百分比
- 内存使用量及限制
- 内存使用百分比
- 网络I/O（输入/输出）
- 磁盘I/O（读/写）
- 容器创建的进程数量(PIDs)

## 主要参数

以下是`docker stats`命令的主要参数：

| 参数 | 描述 |
|------|------|
| `--all`, `-a` | 显示所有容器（默认只显示运行中的容器） |
| `--format` | 使用Go模板格式化输出 |
| `--no-stream` | 禁用流模式，仅显示当前状态后退出 |
| `--no-trunc` | 不截断输出 |

## 使用示例

### 基本使用

```bash
docker stats
```

输出示例：
```
CONTAINER ID  NAME     CPU %  MEM USAGE / LIMIT  MEM %  NET I/O       BLOCK I/O      PIDS
c9d5b23b6a0a  redis    0.07%  796 KB / 64 MB     1.21%  788 B / 648 B  3.56 MB / 512 KB  1
```

### 查看指定容器的状态

```bash
docker stats container1 container2
```

### 使用自定义格式输出

```bash
docker stats --format "表格 {{.Container}}: {{.CPUPerc}}"
```

### 只显示一次当前状态

```bash
docker stats --no-stream
```

## 格式化选项

使用`--format`参数时，可用的占位符包括：

- `{{.Container}}`: 容器ID/名称
- `{{.Name}}`: 容器名称
- `{{.ID}}`: 容器ID
- `{{.CPUPerc}}`: CPU使用百分比
- `{{.MemUsage}}`: 内存使用量
- `{{.NetIO}}`: 网络I/O
- `{{.BlockIO}}`: 块设备I/O
- `{{.MemPerc}}`: 内存使用百分比
- `{{.PIDs}}`: 进程数量

## 相关扩展

对于需要查看一段时间内资源使用趋势的用户，Docker Desktop提供了Resource Usage扩展，它可以：

1. 分析最耗资源的容器或Docker Compose项目
2. 观察容器资源使用随时间的变化
3. 显示全局资源使用概览（CPU核心使用、内存使用、运行容器数量）
4. 提供表格视图和图表视图来分析数据 [3](https://www.docker.com/blog/how- ... -in-docker-desktop/)

## 总结

`docker stats`命令是监控Docker容器资源使用的有效工具，它提供实时数据流以便快速了解容器性能状况。对于更复杂的监控需求，可以考虑使用Docker Desktop的Resource Usage扩展或其他专业的容器监控工具 [6](https://openobserve.ai/resources ... itoring-performance)。

via: https://devv.ai/search?threadId=efhlirqvvaww