InfluxDB inch 工具
此页面记录了早期版本的 InfluxDB OSS。 InfluxDB OSS v2 是最新的稳定版本。 请参阅 InfluxDB v2 文档。
使用 InfluxDB inch 工具模拟数据流式传输到 InfluxDB 并衡量您的性能(例如,基数对写入吞吐量的影响)。 为此,请完成以下任务
安装 InfluxDB inch
要安装
inch
,请在您的终端中运行以下命令$ go install github.com/influxdata/inch/cmd/inch
验证
inch
是否已成功安装在您的GOPATH/bin
中(Unix 上的默认路径为$HOME/go/bin
)。
使用 InfluxDB inch
登录到您要测试的 InfluxDB 实例(对于 InfluxDB Enterprise,登录到数据节点以进行测试)。
运行
inch
,指定要测试的options
(指标)(请参阅下面的 选项 表)。 例如,您的语法可能如下所示inch -v -c 8 -b 10000 -t 2,5000,1 -p 100000 -consistency any
此示例开始生成以下工作负载:
- 8 个并发 (
-c
) 写入流 - 每个批次 10000 个点 (
-b
) - 标签基数 (
-t
) 为 10000 个唯一序列 (2x5000x1) - 每个序列 10000 个点 (
-p
) - 任何写入
-consistency
注意: 默认情况下,
inch
将生成的测试结果写入名为stress
的数据库。 要更改 inch 数据库的名称,请包含-db string
选项,例如,inch -db test
。- 8 个并发 (
要查看最后 50 个
inch
结果,请对 inch 数据库运行以下查询> select * from stress limit 50
选项
按字母顺序排列的 inch
选项。
选项 | 描述 | 示例 |
---|---|---|
-b int | 批处理大小(默认 5000;建议在 5000-10000 点之间) | -b 10000 |
-c int | 并发写入的流数(默认 1) | -c 8 |
-consistency string | 写入一致性(默认 “any”); Influxdb API 支持的值包括 “all”、“quorum” 或 “one”。 | -consistency any |
-db string | 要写入的数据库名称(默认 “stress”) | -db stress |
-delay duration | 写入之间的延迟(以秒 s 、分钟 m 或小时 h 为单位) | -delay 1s |
-dry | 空运行(指定数据库上可能的最大写入性能 perf ) | -dry |
-f int | 每个点的唯一字段键值对总数(默认 1) | -f 1 |
-host string | 主机(默认 http | -host https://127.0.0.1:8086 |
-m int | 指标数量(默认 1) | -m 1 |
-max-errors int | 在终止 inch 命令之前可能发生的 InfluxDB 错误数 | -max-errors 5 |
-p int | 每个序列的点数(默认 100) | -p 100 |
-report-host string | 用于发送指标的主机 | report-host https://127.0.0.1:8086 |
-report-tags string | 逗号分隔的 k=v(键值?)标签,用于与指标一起报告 | -report-tags cpu=cpu1 |
-shard-duration string | 分片持续时间(默认 7d) | -shard-duration 7d |
-t [string] ** | 逗号分隔的整数,表示标签。 | -t [100,20,4] |
-target-latency duration | 如果指定,则尝试调整写入延迟以满足目标。 | |
-time duration | 写入时间跨度。 | -time 1h |
-v | 详细模式;在您运行测试时打印出详细信息。 | -v |
** -t [string]
每个整数代表一个标签键和要为该键生成的标签值的数量(默认 [10,10,10])。 将每个整数相乘即可计算标签基数。 例如,-t [100,20,4]
的标签基数为 8000 个唯一序列。
此页面是否对您有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一份子! 我们欢迎并鼓励您对 InfluxDB 和本文档提供反馈和错误报告。 要获得支持,请使用以下资源
拥有年度合同或支持合同的客户 可以联系 InfluxData 支持。