文档文档

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,指定要测试的 选项(指标)(请参阅下面的 选项 表)。例如,您的语法可能如下所示

    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://localhost:8086")-host http://localhost:8086
-m int测量数(默认 1)-m 1
-max-errors int在终止 inch 命令之前可能发生的 InfluxDB 错误数-max-errors 5
-p int每个序列的点数(默认 100)-p 100
-report-host string要将指标发送到的主机report-host http://localhost: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
-vverbose;在您运行测试时打印出详细信息。-v

** -t [string] 每个整数表示一个标签键和要为该键生成的标签值的数量(默认 [10,10,10])。将每个整数相乘即可计算标签基数。例如,-t [100,20,4] 的标签基数为 8000 个唯一序列。


此页内容是否对您有帮助?

感谢您的反馈!


Flux 的未来

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

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一个开源、高速、近实时数据引擎,可实时收集和处理数据,并将其持久化到本地磁盘或对象存储。InfluxDB 3 Enterprise 构建在 Core 的基础上,增加了高可用性、只读副本、增强的安全性以及数据压缩,以实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看