Issue tracker

JMeter uses GitHub Issues for issue tracking, i.e. for reporting bugs and requesting enhancements. Previously, the issues were tracked in Bugzilla, and all the issues, comments, and attachments have been migrated to GitHub on 2022-09-22.

Support Questions

Please do not use GitHub Issues for asking questions. It is not a support forum. Instead, please subscribe to the JMeter user mailing list and ask there. The user mailing list has a bigger audience, and you are more likely to get an answer quickly.

Known Bugs and enhancements

Requesting an enhancement

Please check if the same enhancement has already been requested previously. If you find a very similar request in the issues list, please refrain from adding "I also need this" comments to the issue. "I also need this" comments cause notifications, and the comment itself does not add much to the discussion. Instead, prefer adding reactions to the first comment of an existing issue, so the issues could be sorted (see Most voted issues).

Please make sure that you describe the enhancement in sufficient detail. It might be a good idea to start with a use-case.

There are several options to propose an enhancement request:

GitHub issue

You could file an issue on GitHub to start a discussion and gather opinions. GitHub issues allow basic formatting, advanced formatting, attaching files, syntax highlight, task lists, reactions, references to the other issues and the source code.

When you create an issue at GitHub, it suggests one of the templates (e.g. "Bug report", "Feedback about the manual", "Feature Request", "Regression"), and it guides which information is required for each case. You could read more on creating issues in GitHub documentation.

Mailing list discussion

If you are not sure if something is an enhancement, or if you are unsure regarding the possible solutions, it might be a good idea to start a discussion on JMeter dev mailing list

GitHub pull request

If you are positive regarding the solution, you could start a discussion by creating a pull request on GitHub. Pull requests are not much different from issues, however, sometimes it is easier to discuss with code at hand. For instance, if you fix a typo or make other small fixes, there's no need to create "issue and PR" for each change. The following GitHub post might be helpful for creating your perfect pull request.

There's no guarantee that your contribution will be accepted, so it might be wise to discuss your suggestions before you invest significant efforts on implementing the changes.

If you are providing a code patch, also provide a test case, and documentation on how to use the new feature (ideally as a documentation patch).

Raising an Issue

First check that the issue has not already been reported on GitHub issues and JMeter user mailing list). If reporting a bug, are you sure it really is a bug in JMeter, not just a misunderstanding of how JMeter works?

If you face a bug or regression, please create an issue on GitHub. In case you can't create an issue, you might send the bug report to JMeter dev mailing list.

Required Information for bug reporting

Please make sure you provide sufficient information for others to be able to make use of the report effectively. Use the checklist below to guide you.

See also the following Bug writing guidelines, also the terms and conditions noted on the GitHub Terms of Service

Go to top