Apache JMeter Documentation

Find the JMeter guide that matches the job in front of you: record traffic, build a plan, run real load, analyze results, tune configuration, or extend the tool.

Get Started →Plugins →

jmeter - bash

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

Creating summariser <main>

Created the tree successfully

Starting the test @ Jul 7, 2026 04:16:50 AM

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

Start with the task you need to finish, then move into the deeper manual pages when the plan is ready.

Record 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

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

Topic Guides (6 pages)

• API Load Testing
• Distributed Testing
• HTTP Recorder
• Functions & Variables
• CI/CD Load Testing
• JMeter vs Alternatives

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 (9 pages)

• 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

→