理解进度信息和统计报告

本文档详细介绍了 MatrixBench 运行过程中的进度信息与运行完成打印出的统计报告。

注意！
目前 mxbench 已开源，欢迎你的审阅与贡献，请点击此处阅读 README。

1 进度信息

示例：

● Stdin Writer Report
  ● period start: 2022-04-29 10:08:11, end: 2022-04-29 10:08:16, period: 5.000129734s

  ● count written in total: 637025 rows/ 1500000 rows 42%, 637025 rows in this period

  ● size written in total: 160878718 bytes/ 360000003 bytes 44%, 160878718 bytes in this period

  ● size written to MxGate in total: 350075440 bytes, 350075440 bytes in this period

● Telematics Benchmark Report
  ● stats for query SINGLE_TAG_LATEST_QUERY with parallel 8: progress: 100%

  ● stats for query MULTI_TAG_LATEST_QUERY with parallel 8: progress: 43%

进度信息总共由两部分组成：Writer 和 Benchamrk。

1.1 Writer

period start, period end, period: 该统计窗口的起止时间和时间段；
count written: 已经写入的数据行数和预计数据行数，以及二者的百分比。xx in this period：该统计窗口内写入的行数；
size written: 已经写入的数据字节数和预计数据字节数，以及二者的百分比。xx in this period: 该统计窗口内写入的字节数；
size written to MxGate: 把数据转化成文本后写入 MatrixGate 的字节数。xx in this period: 该统计窗口内写入 MatrixGate 的字节数。

1.2 Benchmark

某条查询语句在某并发度 parallel 参数下的执行进度。查询语句与数据加载同时进行时，查询语句会在数据加载结束之前一直进行，因此可能会循环运行多轮。该进度报告只显示最近一轮的进度报告。

2 统计报告

2.1 Writer

┌───────────────────────────────────────────────────────┐
│            Summary Report for Stdin Writer            │
├─────────────────────────────────┬─────────────────────┤
│ start time:                     │ 2022-04-27 13:29:01 │
├─────────────────────────────────┼─────────────────────┤
│ stop time:                      │ 2022-04-27 13:29:58 │
├─────────────────────────────────┼─────────────────────┤
│ size written to MxGate (bytes): │ 848333400           │
├─────────────────────────────────┼─────────────────────┤
│ lines inserted:                 │ 1500000             │
├─────────────────────────────────┼─────────────────────┤
│ compress ratio:                 │ 1.561276 : 1        │
└─────────────────────────────────┴─────────────────────┘

start time: 数据加载起始时间；
end time: 数据加载终止时间；
size written to MxGate (bytes): 向 MatrixGate 写入数据的字节数；
lines inserted：插入数据的条数. 由于 UPSERT 可能存在，这一数字可能会高于数据库中实际的数据条数。
compress ratio: 压缩比，即向 MatrixGate 写入数据的大小和实际数据库中该表的大小的比值。

2.2 Benchmark

每条查询语句，在每个 parallel 参数下都会实时打印出一个相关报告。

┌─────────────────┬───────────────┐
│ Overall Latency │ 29.948370582s │
│ Average Latency │   13.723304ms │
│ P75 Latency     │    14.35972ms │
│ P50 Latency     │   13.654556ms │
│ P25 Latency     │   12.925912ms │
│ TPS             │           582 │
└─────────────────┴───────────────┘

Pxx 代表 xx 百分位数的延迟。例如 P75 是 14.35972ms，说明执行查询语句的次数中，有 25% 延迟高于它，75% 低于它. P50 即中位数。
TPS：每秒执行查询语句的次数.

汇总报告：

┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                Summary Report for Telematics Benchmark                                                │
├─────────────────────┬─────────────────────────────────────┬─────────────────────────────────────┬─────────────────────────────────────┤
│ Parallel\Query Name │ SINGLE_TAG_LATEST_QUERY             │ MULTI_TAG_LATEST_QUERY              │ SINGLE_TAG_DETAIL_QUERY             │
├─────────────────────┼─────────────────────────────────────┼─────────────────────────────────────┼─────────────────────────────────────┤
│ 8                   │ ┌─────────────────┬───────────────┐ │ ┌─────────────────┬───────────────┐ │ ┌─────────────────┬───────────────┐ │
│                     │ │ Overall Latency │ 30.008625133s │ │ │ Overall Latency │ 36.407016561s │ │ │ Overall Latency │ 29.948370582s │ │
│                     │ │ Average Latency │    23.81758ms │ │ │ Average Latency │  7.270212105s │ │ │ Average Latency │   13.723304ms │ │
│                     │ │ P75 Latency     │   24.911171ms │ │ │ P75 Latency     │  8.139682559s │ │ │ P75 Latency     │    14.35972ms │ │
│                     │ │ P50 Latency     │   23.411248ms │ │ │ P50 Latency     │  7.161237157s │ │ │ P50 Latency     │   13.654556ms │ │
│                     │ │ P25 Latency     │   20.899622ms │ │ │ P25 Latency     │  6.642459805s │ │ │ P25 Latency     │   12.925912ms │ │
│                     │ │ TPS             │           335 │ │ │ TPS             │             1 │ │ │ TPS             │           582 │ │
│                     │ └─────────────────┴───────────────┘ │ └─────────────────┴───────────────┘ │ └─────────────────┴───────────────┘ │
│                     │ progress: 100%                      │ progress: 100%                      │ progress: 100%                      │
└─────────────────────┴─────────────────────────────────────┴─────────────────────────────────────┴─────────────────────────────────────┘

每行代表某并发度下查询语句的执行结果。
每列代表每个查询语句在各个并发度下的执行结果。
如果查询语句集执行了多轮（混合负载的情况下，数据加载未结束，查询语句便会一直执行），则仅展示最后一轮的结果。
如果因为查询语句执行错误或者用户中断执行，进度条会显示当前进度，统计信息是根据已经执行查询语句的做出统计。

注意！
MatrixBench 快速上手请见 MatrixBench 快速上手；MatrixBench 完整的命令行参数信息请见 MatrixBench 命令行参数；主要功能介绍请见 MatrixBench 主要功能。