Apache JMeter Documentation

Find the JMeter guide that matches the job in front of you: first load test, record traffic, run real load, fix errors, or open a calculator.

I'm new →I know JMeter →Plugins

jmeter - bash

$ jmeter -n -t test-plan.jmx -l results.jtl

Creating summariser <main>

Created the tree successfully

Starting the test @ Aug 23, 2026 02:21:12 PM

summary + 1247 in 00:00:12 = 103.9/s Avg: 245 Min: 12 Max: 1823 Err: 0 (0.00%)

summary = 1247 in 00:00:12 = 103.9/s Avg: 245 Min: 12 Max: 1823 Err: 0 (0.00%)

$ ▋

Choose the workflow

Stuck or sizing a test? Start with tools and error playbooks. Otherwise pick the task you need to finish.

Quick helpI need a calculatorSize threads and heap, build a CLI command, check coordinated omission, filter properties, or build regex extractors.Open tools hubQuick helpRun a CLI testAssemble jmeter -n -t with results, HTML report, HEAP, and -J properties for a terminal or CI job.Open CLI builderFor agentsConnect my AI agentAdd these JMeter docs to Claude Code, Qwen Code, or Cursor via MCP: grounded answers with a source link, no API key.Get the MCP endpointFix nowI'm stuck on an error33 playbooks for every common JMeter failure: connection and TLS errors, HTTP status codes, OOM and resource limits, startup crashes, scripting issues, and distributed testing.Open error playbooksRecord HTTP trafficCapture browser journeys, filter noise, and turn real requests into a maintainable test plan.Open recorder guideBuild a test planModel users with thread groups, samplers, config elements, assertions, and realistic data.Build from basicsRun distributed loadScale beyond one injector with controller-worker setup, RMI ports, and result aggregation.Scale the runAnalyze dashboard resultsGenerate HTML reports and interpret APDEX, percentiles, throughput, and errors after a run.Read reportsTune propertiesAdjust JMeter and system properties for load generation, reporting, networking, and plugins.Review propertiesExtend JMeterCreate custom samplers, listeners, timers, and dashboard components for your testing stack.Extend behavior

Video learning

Learn JMeter with QAInsights

Curated YouTube playlists walk through recording, test plans, distributed runs, and analysis. Watch alongside the docs.

Browse playlists

Start from your goal

Pick the closest target and jump to the guide that gets you moving fastest.

Web appBrowser-style HTTP flows with cookies, defaults, and assertions.Open guideAPIREST, SOAP, GraphQL, headers, payloads, and CI-friendly reports.Open guideDatabaseJDBC connection setup, SQL requests, and database test plans.Open guideDistributedMulti-machine load generation with controller and workers.Open guideCINon-GUI execution, report artifacts, and performance gates.Open guidePlugin devCustom elements, UI integration, and extension points.Open guide

Interactive tools

JMeter Tools Hub

Solve sizing and configuration choices instantly. Estimate threads and ramp-up, size heap, build a CLI command, draft regex extractors, and cheat-sheet high-impact properties.

Open the Tools Hub

Explore the docs map

Find related JMeter topics - hover to highlight connections, click to navigate, drag to rearrange.

+−↺

Documentation links by section

Getting Started (1 pages)

• Get Started

Error Playbooks (34 pages)

• Error Playbooks Index
• ConnectException
• SocketTimeoutException
• NoHttpResponseException
• Premature EOF / Connection Aborted
• UnknownHostException
• BindException / Port Exhaustion
• SSLHandshakeException
• SSLPeerUnverifiedException
• Socket closed / reset
• Non HTTP response code
• HTTP 401/403 after recording
• Works in Browser, Fails in JMeter
• HTTP 400 / 415 Bad Request
• HTTP 429 & WAF Rate Limits
• HTTP 500 / 502 / 503 / 504
• HTTP 407 Proxy Authentication
• OutOfMemoryError heap
• OOM: Native Thread Limit
• OOM: Metaspace & GC
• Too Many Open Files (ulimit)
• Throughput stuck
• Freezing, CPU & CLI Hangs
• JMeter Won't Start / Crash on Launch
• Test Stops Early / Unexpectedly
• JSR223 Groovy Script Errors
• ClassNotFound & Missing JARs
• JMX Won't Load / Corrupt Plan
• Extractor Default Value (NOT_FOUND)
• CSV Data Set & Sharing Issues
• Distributed RMI Errors
• JDBC Connection Pool Errors
• GUI works, CLI fails
• HTML Dashboard Errors

Interactive Tools (10 pages)

• Tools Hub
• cURL & HAR to JMX
• Thread Calculator
• Heap Estimator
• CLI Command Builder
• Distributed Testing Planner
• Linux OS & Kernel Tuning
• Coordinated Omission
• Properties Cheat Sheet
• Regex Extractor Builder

Topic Guides (33 pages)

• JMeter for Beginners
• API Load Testing
• JWT / OAuth / SSO
• Mutual TLS (mTLS) & Client Certs
• Correlation & Dynamic Values
• HTTP Recorder
• Functions & Variables
• CSV Data Set & Parameterization
• JSR223 Groovy Scripting
• Assertions & SLA Validation
• Logic Controllers & Flow Control
• Timers, Think Time & Pacing
• Thread Groups & Workload Modeling
• JDBC Database Load Testing
• JVM & OS Performance Tuning
• Plugins Essentials
• WebSocket Load Testing
• gRPC / Kafka / MQTT
• Grafana / Influx / Backend Listener
• APDEX / SLOs / Percentiles
• HTML Dashboard & APDEX Customization
• Docker / Kubernetes
• CI/CD Load Testing
• Distributed Testing
• Programmatic / DSL Plans
• Troubleshooting
• Interview Questions
• Tool Comparison Hub
• JMeter vs k6
• JMeter vs Locust
• JMeter vs Gatling
• JMeter vs LoadRunner / NeoLoad
• GUI vs Code-First

User Manual (25 pages)

• Building a Test Plan
• Elements of a Test Plan
• Building a Web Test Plan
• Advanced Web Test Plan
• Database Test Plan
• FTP Test Plan
• LDAP Test Plan
• Extended LDAP Test Plan
• Webservice Test Plan
• JMS Point-to-Point
• JMS Topic Test Plan
• Programmatic Test Plan
• Listeners
• Remote Testing
• Dashboard Report
• Real-time Results
• Best Practices
• Boss
• cURL
• Hints and Tips
• Glossary
• Regular Expressions
• Functions and Variables
• Properties Reference
• Component Reference

Extending JMeter (2 pages)

• Extending JMeter
• Dashboard Generator

Reference (11 pages)

• Release Notes
• MCP Server
• Changes
• Changes History
• History & Future
• Building JMeter
• Creating Templates
• Download JMeter
• Security
• Issue Tracking
• Mailing Lists

Legal (2 pages)

• Disclaimer
• NOTICE

Explore the Documentation

Component Reference

Detailed reference for all JMeter components - samplers, controllers, listeners, timers, assertions, config elements.

Thread Group → HTTP Request → View Results Tree

→

Building Test Plans

Step-by-step guides for web, database, FTP, LDAP, JMS, and more.

Test Plan → Thread Group → Sampler → Listener

→

Functions & Variables

Built-in functions for dynamic values, scripting, and property access.

${__time(YMD)}

→

Properties Reference

Complete jmeter.properties configuration options.

jmeter.save.saveservice.output_format=csv

→

Extending JMeter

Developer guide for custom samplers and plugins.

public SampleResult sample(Entry e)

→

Best Practices

Guidelines for scalable, maintainable test plans.

Reuse → Parameterize → Modularize

→

Glossary

Key JMeter terminology explained.

Sampler, Controller, Listener

→

Remote Testing

Distributed load testing setup.

jmeter -r -n -t test.jmx

→