文档文档

InfluxDB inch 工具

此页面记录了早期版本的 InfluxDB OSS。 InfluxDB OSS v2 是最新的稳定版本。 请参阅 InfluxDB v2 文档

使用 InfluxDB inch 工具模拟数据流式传输到 InfluxDB 并衡量您的性能(例如,基数对写入吞吐量的影响)。 为此,请完成以下任务

安装 InfluxDB inch

  1. 要安装 inch,请在您的终端中运行以下命令

    $ go install github.com/influxdata/inch/cmd/inch
    
  2. 验证 inch 是否已成功安装在您的 GOPATH/bin 中(Unix 上的默认路径为 $HOME/go/bin)。

使用 InfluxDB inch

  1. 登录到您要测试的 InfluxDB 实例(对于 InfluxDB Enterprise,登录到数据节点以进行测试)。

  2. 运行 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

  3. 要查看最后 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://127.0.0.1:8086")-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 个唯一序列。


此页面是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。 您可以继续像现在一样使用它,而无需对代码进行任何更改。

阅读更多

InfluxDB 3 开源版本现已发布公开 Alpha 版

InfluxDB 3 开源版本现已可用于 alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个产品作为 alpha 版本的一部分。

InfluxDB 3 Core 是我们的全新开源产品。 它是用于时间序列和事件数据的最新数据引擎。 InfluxDB 3 Enterprise 是一个商业版本,它建立在 Core 的基础上,增加了历史查询功能、读取副本、高可用性、可扩展性和细粒度的安全性。

有关如何开始使用的更多信息,请查看