Skip to main content
Back to blog
tutorials 13 May 2020 2 min read

JMeter Random CSV

Learn how to use the Random CSV Data Set Config plugin for Apache JMeter to enable random value selection from CSV files in your performance tests.

M

Mark

Performance Testing Expert

The Random CSV Data Set Config plugin for Apache JMeter extends the default CSV functionality by enabling random value selection from CSV files. This is particularly useful when you need to simulate more realistic user behavior by selecting test data in a non-sequential manner.

Installation Process

The plugin is installed through JMeter’s plugin manager:

  1. Download the plugins-manager.jar file
  2. Place it in the lib/ext directory
  3. Restart JMeter
  4. Access Options > Plugins Manager
  5. Search for and install “Random CSV Data Set Config”

Configuration Parameters

The Random CSV Data Set Config includes several key parameters:

ParameterDescription
FilenameSpecifies the CSV file path
File encodingDefaults to UTF-8
DelimiterDefaults to comma
Variable nameStores the randomly selected value
Random OrderEnabled by default
Rewind behaviorDetermines actions when reaching file end
CSV header optionIdentifies whether line 1 contains headers
Thread-specific listsAllows independent data per thread
Test functionPreviews random selections before execution

Practical Implementation

To implement random CSV data selection in your test plan:

  1. Add the Random CSV Data Set Config element to your test plan
  2. Configure the filename to point to your CSV file
  3. Set the variable name that will store the randomly selected value
  4. Enable the “Random Order” option
  5. Add a Dummy Sampler or HTTP Request that references the variable

When you run the test, you can view the results in JMeter’s View Results Tree to see how variables integrate with sampler responses.

Use Cases

This plugin is particularly useful for:

  • Simulating realistic user login patterns with random credentials
  • Testing with random product IDs or search terms
  • Load testing with varied input data
  • Avoiding sequential patterns that might not reflect real-world usage

Further Reading

Tags:

#jmeter #performance-testing #csv #plugins #test-data

Need help with performance testing?

Let's discuss how I can help improve your application's performance.

Get in Touch