Table Of Contents

5.6. quasardb benchmarking tool

5.6.1. Introduction

The quasardb benchmarking tool (qdb-benchmark) enables you to evaluate the performance of your quasardb cluster. To do so, it runs chosen tests on the specified cluster and measures the time taken to process the commands as accurately as the operating systems allows it.

5.6.2. Quick Reference

Option

Usage

Default

-h, --help

display help

-v, --version

display version

--show-tests

display all available tests

-n, --dry-run

display tests to be executed and exit

--no-cleanup

turn off cleaning up after each test

-c, --cluster

cluster URI

qdb://127.0.0.1:2836

-p, --pause

pause duration between tests (in seconds)

1

-d, --duration

duration of each test (in seconds)

4

--sizes

sizes of entry contents to test (in bytes)

1,1k,1M

--threads

numbers of concurrent threads used for tests

1,2,4

--user-credentials-file

path to the user security file

--cluster-public-file

path to a file with cluster public key

--tests

tests to run

*

5.6.3. Usage scenarii

  • Identifying hardware limits in a quasardb cluster (network bandwidth, server processing power, etc.).

  • Determining the maximum throughput of your cluster.

  • Comparing to other databases.

  • Tuning your system: network, disk, OS, etc.

5.6.4. Parameters reference

-h, --help

Displays basic usage information.

Example

To display the online help, type:

qdb-benchmark --help
-v, --version

Displays tool version information.

--show-tests

Displays all available tests.

-n, --dry-run

Displays tests to be executed and exit

--no-cleanup

Turn off cleaning up after each test

-c=<address>:<port>, --cluster=<address>:<port>

Specifies the address and port of the quasardb cluster to which the benchmark tool must connect.

Argument

The URI (list of comma-separated endpoints, i.e. addresses and ports, preceded by qdb://) of a cluster on which the tests will be run.

Default value

qdb://127.0.0.0:2836, the IPv4 localhost address and the port 2836

Example

If the daemon listens on localhost and on the port 5009:

qdb-benchmark --cluster=qdb://localhost:5009
-p, --pause=<pause_duration>

Specifies the time waited between tests (in seconds).

Argument

A positive integer.

Default value

1

Example

Make a 10 seconds pause between two tests:

qdb-benchmark --pause=10
--duration=<duration>

Specifies the duration of each test (in seconds).

Argument

A positive integer.

Default value

4

Example

Make the tests last 60 seconds each:

qdb-benchmark --duration=60
--threads=<threads>

Specifies the number of threads that qdb-benchmark should use to run the test. This function is helpful to simulate multiple clients from a single test instance.

Argument

A list of positive integers representing the number of threads to use.

Default value

1,2,4

Example

Run each test two times, once in one thread and once in two threads:

qdb-benchmark --threads=1,2
--sizes=<sizes>

Specifies the sizes of the content elements (in bytes).

Argument

A list of positive integers representing the content sizes. You can use the following literals: k, M, G

Default value

1,1K,1M

Example

Run each test three times, once with each size:

qdb-benchmark --sizes=128,2k,2M
--user-credentials-file=<user-credentials-file>

Specifies the user credential file to use while authenticating to the server.

Argument

The path of the user credentials.

Default value

“”

Example

Connect to a secured server:

qdb-benchmark --user-credentials-file=user_private.key --cluster-public-file=cluster_public.key
--cluster-public-file=<cluster-public-file>

Specifies the cluster public key file to use while authenticating to the server.

Argument

The path of the cluster public key.

Default value

“”

Example

Connect to a secured server:

qdb-benchmark --user-credentials-file=user_private.key --cluster-public-file=cluster_public.key
--tests=<tests_regex>

Specifies which tests to run. It accepts wildcard at start and end of input.

Argument

The tests needed.

Default value

All tests.

Example

Run specific tests:

qdb-benchmark --tests=qdb_blob_*
arrow_backPrevious
5.5. quasardb database tool
Next arrow_forward
5.7. quasardb insertion tool