InfluxDB inch tool

Use the InfluxDB inch tool to simulate streaming data to InfluxDB and measure your performance (for example, the impact of cardinality on write throughput). To do this, complete the following tasks:

• Install InfluxDB inch
• Use InfluxDB inch

Install InfluxDB inch

1. To install inch, run the following command in your terminal:

   $ go install github.com/influxdata/inch/cmd/inch
   

2. Verify inch is successfully installed in your GOPATH/bin (default on Unix $HOME/go/bin).

Use InfluxDB inch

1. Log into the InfluxDB instance you want to test (for InfluxDB Enterprise, log into the data node(s) to test).

2. Run inch, specifying options (metrics) to test (see Options table below). For example, your syntax may look like this:

   inch -v -c 8 -b 10000 -t 2,5000,1 -p 100000 -consistency any
   

   This example starts generating a workload with:

   • 8 concurrent (-c) write streams
   • 10000 points per batch (-b)
   • tag cardinality (-t) of 10000 unique series (2x5000x1)
   • 10000 points (-p) per series
   • any write -consistency

   Note: By default, inch writes generated test results to a database named stress. To change the name of the inch database, include the -db string option, for example, inch -db test.

3. To view the last 50 inch results, run the following query against the inch database:

    > select * from stress limit 50
   

Options

inch options listed in alphabetical order.

** -t [string] each integer represents a tag key and the number of tag values to generate for the key (default [10,10,10]). Multiply each integer to calculate the tag cardinality. For example, -t [100,20,4] has a tag cardinality of 8000 unique series.