# 内存带宽时延检测工具说明

内存带宽时延检测工具（Memory Latency Tester）是鲲鹏场景下的内存带宽压测工具，用于检测内存带宽与时延的关系，获取时延随带宽增加的速率变化的情况，帮助评估鲲鹏服务器内存子系统的整体性能，建议在环境空载时使用以获取准确指标。工具支持部分基于鲲鹏920新型号处理器和鲲鹏950处理器的服务器。

#### 前提条件

- 已安装内存带宽时延检测工具。
- 工具为单独压缩包承载（KunpengMemoryLatencyTester-x.x.x-Linux-aarch64.tar.gz），请解压后切换至工具目录使用。
- 工具依赖numactl命令，使用前需确认安装numactl，若未安装可使用如下指令安装。

```
yum install numactl
```


#### 命令功能

采集并展示内存带宽和时延数据。


#### 目录说明

工具包解压后目录结构如下：

```
KunpengMemoryLatencyTester
├── 鲲鹏开发套件DevKit许可协议 1.0.txt
├── bin
│   ├── kmlt_bw
│   └── latency
├── kmlt
├── Kunpeng DevKit License Agreement 1.0.txt
└── lib
├── libkperf_collect.so
├── libkperf.so
└── libsym.so
```

bin、lib目录为工具运行时依赖，kmlt为命令行工具入口。


#### 命令格式

根据压测的对象维度不同，分为以下两种情况进行采集数据：

- 指定压测的CPU所在NUMA节点或指定压测分配内存的NUMA节点：

```
./kmlt [-h | --help] [-c | --cpu-node <node_cpu>] [-m | --mem-node <node_mem>] [-M | --mode <mode>[,<mode>...]] [-d | --detail <nops>[,<nops>...]]
```


- 指定压测的Socket：

```
./kmlt [-h | --help] -s | --socket <socket> [-M | --mode <mode>[,<mode>...]] [-d | --detail <nops>[,<nops>...]]
```


#### 参数说明


**表1 公共参数说明**

| 参数 | 参数选项 | 参数说明 |
| --- | --- | --- |
| \-h/\-\-help | \- | 可选参数，获取帮助信息。 |
| \-M/\-\-mode | rd/wr/rdwr/rdwr21/all | 可选参数，指定压测模式（如读、写、混合模式等），缺省时默认为all。 rd：读模式压测 wr：写模式压测 rdwr：读/写模式压测 rdwr21：读/写以2：1占比模式压测 all：所有模式压测 |
| \-d/\-\-detail | nops | 可选参数，用户可根据需要自定义不同nops下的带宽与时延的压测数据。缺省时默认结果报告为8组数据（nops默认设定为2000，1000，600，300，100，40，10，0）。不同nops参数用逗号连接，nops取值范围为0 ≤ nops < 10000，最多支持100组数据。使用示例./kmlt \-d 2000,1000,500。 |


**表2 指定CPU或分配内存的NUMA节点参数说明**

| 参数 | 参数选项 | 参数说明 |
| --- | --- | --- |
| \-c/\-\-cpu\-node | node\_cpu | 可选参数，指定压测的CPU所在NUMA节点，默认为0。（该参数不能与\-s参数同时使用）。 |
| \-m/\-\-mem\-node | node\_mem | 可选参数，指定压测分配内存的NUMA节点，默认为0。（该参数不能与\-s参数同时使用）。 |


**表3 指定Socket参数说明**

| 参数 | 参数选项 | 参数说明 |
| --- | --- | --- |
| \-s/\-\-socket | socket | 指定压测的Socket时为必选参数，内存默认使用本地内存。（该选项不能与\-c或者\-m参数同时使用）。 |


#### 使用示例

- 以读模式压测CPU和分配内存所在NUMA节点，采集并展示内存带宽和时延数据。

```
./kmlt -c 1 -m 1 -M rd
```


  参数“-c 1”、“-m 1”表示指定压测的CPU和分配内存所在NUMA节点都是NUMA 1，请将“-c”、“-m”参数替换为实际要压测的NUMA节点。 工具使用时直接返回失败，可参考工具使用时显示“unsupport CPU type”的解决方法。

  工具会按顺序显示不同内存访问间隔下的带宽与时延，返回结果信息如下图所示。

  可以看到时延随带宽增加而平缓上升，但在带宽达到特定阈值后时延剧增，可以看到Bandwidth在132.957~235.950GB/s之间发生剧增。通过工具捕捉这一时延剧增的临界点，从而界定内存控制器的高效工作区间。

**表4 报告说明**

| 类别 | 说明 |
| --- | --- |
| nops | 代表内存访问的间隔大小，数字越大带宽越小。 |
| Bandwidth | 带宽大小，单位为GB/s。 |
| Latency | 当前带宽下的内存访问时延，单位为ns。 |


- 以all模式压测指定Socket，采集并展示内存带宽和时延数据。

```
./kmlt -s 0
```


  参数“-s 0”表示指定压测的Socket，请将“-s”参数替换为实际要压测的Socket节点。 工具使用时直接返回失败，可参考工具使用时显示“unsupport CPU type”的解决方法。

  工具会按顺序显示运行命令时指定的压测模式结果，返回结果信息如图。

  可以看到时延随带宽增加而平缓上升，但在带宽达到特定阈值后时延剧增，此处结合所有模式的数据参考，可以看到Bandwidth在315GB/s左右~440GB/s左右发生剧增。通过工具捕捉这一时延剧增的临界点，从而界定内存控制器的高效工作区间。

**表5 报告说明**

| 类别 | 说明 |
| --- | --- |
| nops | 代表内存访问的间隔大小，数字越大带宽越小。 |
| Bandwidth | 带宽大小，单位为GB/s。 |
| Latency | 当前带宽下的内存访问时延，单位为ns。 |
