Troubleshooting
A thread group is missing from my results
The usual cause is a data file path that can't be resolved. Every thread in that group fails before sending a request, so there are no errors to report — the group simply isn't there.
Check the CSV Data Set Config entries in that thread group and make each one a relative path (./data.csv), then confirm the file is uploaded. See Test Plan Requirements.
The test finished in seconds with no results
Usually the plan didn't start properly. Check:
- The plan runs locally:
jmeter -n -t plan.jmx - Every referenced file is uploaded
- The machine is big enough — an undersized generator can fail to start JMeter at all rather than running slowly
Max Users is lower than I expected
Max Users adds up the concurrent users reported by every machine. If you ran on 5 generators and it shows roughly one machine's worth, the others weren't producing load.
Check the Fleet page: were all the machines connected? Open Watch during a run to see per-machine activity live.
A machine shows as on, but not connected
The machine is running but its agent isn't reaching Atlas. On the machine:
- Confirm the Atlas agent service is running
- Confirm it can reach your Atlas instance over outbound HTTPS
- Check for a proxy or firewall rule blocking outbound connections
The agent reconnects on its own once the connection is restored.
My test is queued and hasn't started
A load generator runs one test at a time. If the machines you asked for are busy, your run waits and starts automatically when they free up. Either wait, or choose different machines.
Stop said it couldn't reach a machine
Atlas only marks a machine stopped once it has confirmed the process actually ended. If it can't reach one, it tells you and the run stays open — deliberately, so a test can't keep running unnoticed while the record says it stopped.
Retry the stop when the machine is reachable again.
Error rate is high but I can't see why
Click the Error % cell for a request in the aggregation report. That opens the actual errors — response codes, messages, and the full request and response for each distinct failure.
If errors are concentrated in one endpoint, click its Label to chart that request on its own and see when it started failing.
Results look wrong for one request
Check whether the same sampler name exists in more than one thread group. Atlas keeps them as separate rows attributed to the right group — if you expected them combined, that's why the numbers differ from a single-machine JMeter run.
A recorded plan fails on the second run
Usually a dynamic value that wasn't correlated — a token that was valid when you recorded and isn't now. Re-record with correlation enabled (the default), and check that the step which issues the token is part of the recording.
If the value is sent but never appeared in an earlier response, the browser brought it with it — a cart or sign-in token remembered from a previous visit. Record again from a browser with no history for the site.
JMeter won't open a recorded plan: CannotResolveClassException: eu.luminis…
The plan talks to a WebSocket (live notifications, SignalR), and the JMeter that is opening it doesn't have the plugin those steps need. Install WebSocket Samplers by Peter Doornbosch — from JMeter's Plugins Manager, or jmeter-websocket-samplers-<version>.jar into lib/ext — and restart JMeter.
A jar you already have may be a different plugin with a similar name ("JMeter WebSocket Sampler"); that one can't open these plans. The same applies to every machine that runs the test — see WebSockets and SignalR.
Every request gets a blank page or a "Request Not Allowed" response
The site is protected against bots, and the load generators look like one. The recorder's browser can be turned away the same way. This is not something to work around in the plan: ask the site's owner to allow the load generators' addresses (and yours, for recording), or to give you a test environment without the protection. A captcha on sign-in needs the same treatment — a recorded captcha answer is single-use and expires within minutes.
Getting help
When reporting a problem, include the test ID (SHOP-20260818-K3F9). It identifies the run and everything recorded about it.