JMX Converter

The JMX Converter tool by BlazeMeter lets you convert various testing scripts and logs into JMeter-compatible JMX files. This enables you to leverage existing test artifacts and integrate them into JMeter-based testing workflows seamlessly. The JMX Converter supports multiple input formats, including Selenium, PCAP, and specific JSON formats, making it a versatile tool for test conversion.

To convert an existing API Monitoring test (JSON) into JMX, see Convert API Monitoring Test to Performance Test.

Supported Input Formats

The JMX Converter supports the following input formats:

  • HAR (HTTP Archive)

  • Selenium Builder Scripts

  • PCAP (Packet Capture) Files

  • JSON from the BlazeMeter Chrome Extension, HAR, and Selenium Builder. If your JSON file is an API Monitoring test, see Convert API Monitoring Test to Performance Test instead.

    The converter does not accept arbitrary JSON files. Only JSON files generated by the BlazeMeter Chrome Extension or similar sources are supported.

Converting from HAR to JMX

When using the converter to convert your HAR scripts to JMX, note the following limitations:

  • No Page Splitting: If there is a delay of several seconds between URLs, page splitting will not occur.
  • No Pause Between Pages: Timers, such as the Uniform Random Timer, will be placed under each request rather than pausing between pages.
  • No HTTP Defaults: Hostname, scheme, and port will be hardcoded in all HTTP samplers, with no use of HTTP Default settings.
  • No URL Filtering: There are no options to include or exclude specific URLs during the conversion process.
  • No URL Numbering: URLs will not be numbered or prefixed.
  • No record.xml File: This file, crucial for future correlations, is not generated during the conversion.
  • HAR File Size Limit: There is a limit on the upload size for the HAR file.
  • Sensitive Data Transmission: Sensitive data contained in the HAR file may be transmitted to the BlazeMeter site.

Consider the limitations listed above when preparing your scripts for conversion to ensure they meet your testing requirements.

How to Use the JMX Converter

Steps

  1. In your browser, navigate to https://converter.blazemeter.com/.
  2. Click Choose file and select the file you wish to convert from your local system. Ensure the file is in one of the supported formats (HAR, Selenium, PCAP, or supported JSON).
  3. To upload the file, click Open.

  4. Click Convert.

    The conversion process will begin, and you will see a progress indicator. Once the conversion is complete, a download link for the JMX file will appear.

  5. Click the download link to save the converted JMX file to your local system.

Result

You can now use this JMX file in BlazeMeter or JMeter for further testing.

Example Use Case

Converting a HAR File to JMX:

  1. Capture HAR Data: Use your browser's developer tools to capture HAR data during a web session.
  2. Upload HAR File: Upload the captured HAR file to the JMX Converter.
  3. Convert and Download: Convert the HAR file and download the resulting JMX file.
  4. Run in JMeter/BlazeMeter: Import the JMX file into JMeter/BlazeMeter and configure it for your testing needs.

Common Issues and Troubleshooting

Unsupported JSON Error

If you receive an error stating that the JSON file is unsupported, ensure that your JSON file is generated by the BlazeMeter Chrome Extension or similar supported sources.

Conversion Errors

If the conversion process fails, check the following:

  • Ensure your input file is in one of the supported formats.
  • Verify that the file is not corrupted and is correctly formatted.
  • If the issue persists, contact BlazeMeter support for assistance.