二、怎么看这件事儿？

三、kwdb-tsbs 支持哪些测试场景？

主要分两大场景，包括平时最常见的监控和物联网数据：

1. DevOps cpu-only

测试场景关注 CPU 指标，模拟服务器 CPU 监控数据，支持各种聚合、分组、最大值、最新点查询，基本是时序库常用的查询类型。该测试场景模拟对服务器 CPU 监控生成的时序数据，针对每台设备（CPU）记录其 10 个 CPU 指标。下表是该场景中支持的查询类型：

2.IoT

IoT 测试场景主要是模拟物联网环境中的数据负载。该测试场景模拟来自一家虚构卡车公司的一组卡车的数据流。它模拟每辆卡车的诊断数据和指标，并引入环境因素，如乱序数据和批量摄取（对于一段时间离线的卡车）。它还跟踪卡车元数据，并将其用于将指标和诊断作为查询集的一部分联系起来。在该测试场景中，一部分生成的查询将涵盖实时卡车状态和分析，这些分析将查看时序数据，以更好地预测卡车行为。该测试场景的规模因素将基于跟踪的卡车数量。下表为该测试场景中支持的查询类型：

四、环境准备和编译

环境要求

编译步骤

1.克隆仓库

git clone https://gitee.com/kwdb/kwdb-tsbs.git
cd kwdb-tsbs

2.构建应用

make

kwdb-tsbs/
└── bin/
    ├── tsbs_generate_data      # 数据生成工具
    ├── tsbs_load_kwdb          # 数据导入工具
    ├── tsbs_generate_queries   # 查询生成工具
    └── tsbs_run_queries_kwdb   # 查询执行工具

五、完整使用流程（照着就能跑）

整个压测就四步：造数据→写数据→造查询→跑查询。

1.生成数据

• 1：表示插入数据（包括数据值和标签值），格式为 1,ptag名,字段数量,插入的数据。
• 3：表示写入标签值，格式为 3,表名,ptag名,标签值。

示例：

1,host_0,11,(1451606400000,58,2,24,61,22,63,6,44,80,38,'host_0')3,cpu,host_0,('host_0','eu-central-1','eu-central-1a','6','Ubuntu15.10','x86','SF','19','1','test')

./tsbs_generate_data \--format="kwdb" \
  --use-case="cpu-only" \--seed=123 \--scale=100 \
  --timestamp-start="2016-01-01T00:00:00Z" \
  --timestamp-end="2016-01-02T00:00:00Z" \
  --log-interval="10s" \--orderquantity=12 \--orderquantity=12 \--outoforder="0.0" \--outoforderwindow="0" > data.dat

参数说明：

2.导入数据

kwdb-tsbs 提供数据导入工具（ tsbs_load_data），将由 tsbs_generate_data 工具生成的数据文件导入到目标数据库。 tsbs_load_data 工具支持 INSERT 模式和 PREPARE 模式。两种数据导入模式的参数基本相同。

• INSERT 模式

./tsbs_load_kwdb \--file=data.dat \--user=root \--pass=1234 \--host=127.0.0.1 \--port=26257 \
  --insert-type=insert \
  --batch-size=1000 \
  --db-name=benchmark \--case=cpu-only \--workers=12 \--partition=false

• PREPARE 模式

./tsbs_load_kwdb \--file=data.dat \--user=root \--pass=1234 \--host=127.0.0.1 \--port=26257 \
  --insert-type=prepare \--preparesize=1000 \
  --db-name=benchmark \--case=cpu-only \--workers=12 \--partition=false

参数说明：

3.生成查询

./tsbs_generate_queries \--format=kwdb \
    --use-case="cpu-only" \--seed=123 \--scale=100 \
    --query-type=${QUERY_TYPE} \--prepare=false \--queries=100 \
    --timestamp-start="2016-01-01T08:00:00Z" \
    --timestamp-end="2016-01-05T00:00:01Z" \
    --db-name=benchmark > query.dat

4.执行查询

./tsbs_run_queries_kwdb \--file=query.dat \--user=root \--pass=1234 \--host=127.0.0.1 \--port=26257 \
    --query-type=${QUERY_TYPE} \--prepare=false \--workers=1 > query.log

参数说明：

六、自动化测试

1.前提条件

• 已安装 kwdb-tsbs 以及 Go 1.23 或更高版本。
• 具有执行自动化测试脚本的权限。

2.推荐配置

• 硬件配置

下表列出执行自动化测试推荐的硬件规格。用户可以根据实际的业务规模和性能要求规划硬件资源。

• 操作系统

下表列出执行自动化测试推荐的操作系统。未提及的操作系统版本也许可以运行自动化测试脚本，但尚未得到 KWDB 官方支持。

3.执行自动化脚本

• 配置自动化脚本参数。

workspace="$GOPATH/src/gitee.com/kwdb"

参数说明：

workspace：KWDB 工作目录的路径。有关更多自动化测试脚本的参数配置，参见 脚本文件中的详细注释说明。

• 执行自动化脚本。

cd kwdb-tsbs/scripts
./tsbs_kwdb.sh

运行完成后，生成以下相关文件：

kwdb-tsbs/
├── load_data/          # 生成的导入数据
├── query_data/         # 生成的查询数据
└── reports/            # 生成的测试结果
└── YMD_HMS_scale[scaleNum]_cluster[clusterNum]_insert[insertType]_wal[walSetting]_replica[replicaNum]_dop[degreeOfParallelism]/
├── load_data/  # 导入测试的结果
└── query_data/ # 查询测试的结果

综上，kwdb-tsbs 作为适配 KWDB 时序数据库的专属压测工具，实操门槛低、功能覆盖还是比较全面的，可以高效完成数据生成、导入、查询及自动化压测全流程。如果大家在使用过程中遇到问题，欢迎在评论区留言，我也推荐去官方仓库（https://gitee.com/kwdb/kwdb-tsbs）查看详细文档，能获取更全面的配置说明和问题解决方案。希望这份实操笔记能帮大家少踩坑，快速上手kwdb-tsbs！