Skip to content

HTTP Mirror Server

Configure the JMeter HTTP Mirror Server miscellaneous features: properties, defaults, and practical usage notes for building reliable load tests.

Difficulty
intermediate
Guide type
reference
Estimated read time
2 min read
Last verified version
Verified JMeter 5.6

Part of the Miscellaneous Features category. Also documented in context in the full Component Reference.

HTTP Mirror Server

The HTTP Mirror Server is a very simple HTTP server - it simply mirrors the data sent to it. This is useful for checking the content of HTTP requests.

It uses default port 8081.

NameRequiredDescription
PortYesPort on which Mirror server listens, defaults to 8081.
Max Number of threadsNoIf set to a value > 0, number of threads serving requests will be limited to the configured number, if set to a value ≤ 0 a new thread will be created to serve each incoming request. Defaults to 0
Max Queue sizeNoSize of queue used for holding tasks before they are executed by Thread Pool, when Thread pool is exceeded, incoming requests will be held in this queue and discarded when this queue is full. This parameter is only used if Max Number of Threads is greater than 0. Defaults to 25
NameRequiredDescription
X-SleepNoTime to sleep in ms before sending response
X-SetCookieNoCookies to be set on response
X-ResponseStatusNoResponse status, see HTTP Status responses, example 200 OK, 500 Internal Server Error, ….
X-ResponseLengthNoSize of response, this trims the response to the requested size if that is less than the total size
X-SetHeadersNoPipe separated list of headers, example: `headerA: valueA

You can also use the following query parameters:

NameRequiredDescription
redirectNoGenerates a 302 (Temporary Redirect) with the provided location, e.g. ?redirect=/path
statusNoOverrides the default status return, e.g. ?status=404 Not Found
vNoVerbose flag, writes some details to standard output, e.g. first line and redirect location if specified
On this page