How to Use mongo-perf to Test Database Performance on a Linux Server

How to Use MONGO-PERF to Test Database Performance

When it comes to database management, performance testing is crucial. It helps administrators understand the efficiency of database operations and evaluate query performance and latency. One of the tools that can be employed for this purpose, especially for MongoDB, is mongo-perf. This tool is designed to benchmark MongoDB deployments, providing insights into how different operations perform under various conditions.

In this guide, we will walk you through the process of using mongo-perf on a Linux machine. By the end, you’ll be well-equipped to assess the efficiency of your MongoDB operations.

Let’s get started.


  • A Linux machine with MongoDB installed.
  • Basic knowledge of MongoDB operations.
  • Root or sudo access to the machine.

1. Installation

1.1. First, ensure that you have the necessary dependencies installed. These include git, scons, and python.

sudo apt-get install git scons python

1.2. Clone the mongo-perf repository:

git clone

1.3. Navigate to the cloned directory:

cd mongo-perf

1.4. Build the tool:



scons: Reading SConscript files ...
scons: done reading SConscript files.
scons: Building targets ...
g++ -o src/mongo/client/dbclient_rs.o -c -Wnon-virtual-dtor -Woverloaded-virtual -std=c++11 -fPIC -fno-strict-aliasing -ggdb -pthread -Wall -Wsign-compare -Wno-unknown-pragmas -Winvalid-pch -O2 -Wno-unused-local-typedefs -Wno-unused-function -Wno-deprecated-declarations -Wno-unused-but-set-variable -Wno-missing-braces -fno-builtin-memcmp src/mongo/client/dbclient_rs.cpp
scons: done building targets.

2. Running Benchmarks

2.1. Start the MongoDB server:



2023-10-14T12:34:56.789+0000 I CONTROL  [initandlisten] MongoDB starting : pid=12345 port=27017 dbpath=/data/db 64-bit host=my-linux-machine
2023-10-14T12:34:56.790+0000 I CONTROL  [initandlisten] db version v4.4.1
2023-10-14T12:34:56.790+0000 I CONTROL  [initandlisten] git version: 1234567890abcdef1234567890abcdef12345678
2023-10-14T12:34:56.999+0000 I NETWORK  [initandlisten] waiting for connections on port 27017

2.2. In a new terminal, navigate to the mongo-perf directory and run the benchmark:


2.3. The tool will now run a series of benchmarks and display the results. These results will provide insights into query performance, latency, and other vital metrics.


Connecting to MongoDB at localhost:27017...
Running benchmarks...
Benchmarking query: { find: "testCollection", filter: { x: 1 } }
Throughput: 5000 ops/sec, Latency: 0.2 ms
Benchmarking query: { find: "testCollection", filter: { y: { $gt: 10 } } }
Throughput: 4500 ops/sec, Latency: 0.22 ms
All benchmarks completed.

3. Interpreting Results

The results will be presented in a tabular format, showcasing the performance of various operations. Look for operations with high latency or low throughput, as these might be areas requiring optimization.

  • Query Details: The benchmark is testing a query on the testCollection where it’s looking for documents where the field x has a value of 1.
  • Throughput: The query can be executed 5000 times per second. This indicates the number of operations that the MongoDB server can handle per second for this specific query.
  • Latency: The average time taken for each of these operations (or queries) to complete is 0.2 milliseconds. This is a measure of the delay between the time the query is sent and the time the result is received.
  • Query Details: This benchmark tests a query on the testCollection where it’s searching for documents where the field y has a value greater than 10.
  • Throughput: The query can be executed 4500 times per second.
  • Latency: The average time taken for each of these operations to complete is 0.22 milliseconds.

From our example:

  • The MongoDB instance is capable of handling 5000 queries per second when filtering on the field x with a value of 1, with an average latency of 0.2 ms per query.
  • When filtering on the field y with values greater than 10, the throughput slightly decreases to 4500 queries per second, and the latency increases marginally to 0.22 ms.
See also  How to Use ‘Sysbench’ to Measure the Speed of Data Reads/Writes on Storage Devices in Linux

These results provide insights into the efficiency and performance of the MongoDB instance for the specific queries tested. Such benchmarks are essential for database administrators to understand potential bottlenecks, optimize queries, and ensure smooth database operations.

4. Custom Benchmarks

mongo-perf allows you to run custom benchmarks tailored to your specific needs. You can create a custom JSON file with your desired operations and use the –testfile flag to run them:

./mongo-perf --testfile /path/to/custom/testfile.json

Commands Mentioned

  • sudo apt-get install git scons python – Installs necessary dependencies for mongo-perf.
  • git clone – Clones the mongo-perf repository.
  • cd mongo-perf – Navigates to the cloned directory.
  • scons – Builds the mongo-perf tool.
  • mongod – Starts the MongoDB server.
  • ./mongo-perf – Runs the mongo-perf benchmark.
  • ./mongo-perf –testfile /path/to/custom/testfile.json – Runs a custom benchmark using a specified test file.
See also  How to Use HammerDB to Test Database Performance on a Linux Machine


  1. What is mongo-perf?

    Mongo-perf is a benchmarking tool specifically designed for MongoDB. It helps in assessing the efficiency of database operations by evaluating query performance and latency.

  2. Why is performance testing important for databases?

    Performance testing is crucial as it provides insights into how the database operates under various conditions. It helps in identifying bottlenecks, optimizing queries, and ensuring that the database can handle real-world loads efficiently.

  3. Can I run custom benchmarks with mongo-perf?

    Yes, mongo-perf allows users to run custom benchmarks. You can create a custom JSON file with desired operations and use the `–testfile` flag to execute them.

  4. Do I need any specific prerequisites to use mongo-perf?

    Yes, you need a Linux machine with MongoDB installed, basic knowledge of MongoDB operations, and root or sudo access to the machine.

  5. How do I interpret the results from mongo-perf?

    The results from mongo-perf are presented in a tabular format, showcasing the performance of various operations. Look for operations with high latency or low throughput as these might be areas requiring optimization.


Performance testing is an integral aspect of database management. With tools like mongo-perf, administrators can gain a deeper understanding of how their MongoDB deployments perform under various conditions. By regularly benchmarking and analyzing the results, one can optimize queries, reduce latency, and ensure that the database is primed for real-world loads. Whether you’re a seasoned database administrator or just starting out, tools like mongo-perf are invaluable in ensuring that your MongoDB instances run efficiently and effectively.

See also  How to Setup Monit to Monitor Server Uptime and Record Downtimes on Linux

The need for robust and high-performing databases becomes even more critical. Websites and applications rely heavily on databases to deliver content, store user data, and perform various other tasks. Any delay or inefficiency in database operations can lead to a subpar user experience, which can have detrimental effects on user retention and engagement.

For those who manage or host websites, understanding the intricacies of your database’s performance is just one piece of the puzzle. It’s equally important to have a grasp on web hosting solutions. Whether it’s understanding the nuances of dedicated server hosting, the flexibility of VPS server hosting, the scalability of cloud hosting, or the shared resources of shared hosting, each hosting solution offers its own set of advantages and challenges.

In conclusion, the world of databases and web hosting is vast and complex. By leveraging tools like mongo-perf and staying informed about the latest trends and best practices in web hosting, you can ensure that your digital assets are optimized for performance, security, and scalability. Always remember, in the digital age, the efficiency of your backend operations directly impacts the experience of your end-users. Invest time and resources in understanding and optimizing your infrastructure, and you’ll be well-positioned for success in the digital landscape.


Leave a Reply

Your email address will not be published. Required fields are marked *