<?xml version="1.0"?>
<!--
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at
 
       http://www.apache.org/licenses/LICENSE-2.0
 
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-->
<!DOCTYPE document [
  <!ENTITY trade  "&#x02122;">
  <!ENTITY hellip "&#x02026;">
]>
<document>
  <properties>
     <title>Apache JMeter&trade;</title>
  </properties>
  <body>
    <section name="Apache JMeter&trade;">
    <p>
      The <b>Apache JMeter&trade;</b> application is open source software,
      a 100% pure Java application designed
      to load test functional behavior and measure performance.  It was
      originally designed for testing Web Applications but has
      since expanded to other test functions.
    </p>
    <h2>What can I do with it?</h2>
    <p>
      Apache JMeter may be used to test performance both on static and dynamic
      resources, Web dynamic applications. <br/> 
      It can be used to simulate a heavy load on a server, group of servers, 
      network or object to test its strength or to analyze overall performance 
      under different load types.<br/> 
    </p>
<p>Apache JMeter features include:</p>
<ul>
    <li>Ability to load and performance test many different applications/server/protocol types:
        <ul>
        <li>Web - HTTP, HTTPS (Java, NodeJS, PHP, ASP.NET, &hellip;)</li>
        <li>SOAP / REST Webservices</li>
        <li>FTP</li>
        <li>Database via JDBC</li>
        <li>LDAP</li>
        <li>Message-oriented middleware (MOM) via JMS</li>
        <li>Mail - SMTP(S), POP3(S) and IMAP(S)</li>
        <li>Native commands or shell scripts</li>
        <li>TCP</li>
        <li>Java Objects</li>
        </ul>
    </li>
    <li>Full featured Test IDE that allows fast Test Plan <b>recording (from Browsers or native applications), building and debugging</b>.</li>
    <li><b><a href="usermanual/get-started.html#non_gui">CLI mode (Command-line mode (previously called Non GUI) / headless mode)</a></b> to load test from any Java compatible OS (Linux, Windows, Mac OSX, &hellip;)</li>
    <li>A complete and <b><a href="usermanual/generating-dashboard.html" >ready to present dynamic HTML report</a></b></li>
    <li>Easy correlation through ability to extract data from most popular response formats, <b><a href="usermanual/component_reference.html#CSS/JQuery_Extractor" >HTML</a>, <a href="usermanual/component_reference.html#JSON_Extractor" >JSON </a>, 
        <a href="usermanual/component_reference.html#XPath_Extractor" >XML</a> or <a href="usermanual/component_reference.html#Regular_Expression_Extractor" >any textual format</a></b></li>
    <li>Complete portability and <b>100% Java purity</b>.</li>
    <li>Full <b>multi-threading</b> framework allows concurrent sampling by many threads and
        simultaneous sampling of different functions by separate thread groups.</li>
    <li>Caching and offline analysis/replaying of test results.</li>
    <li><b>Highly Extensible core:</b>
      <ul>
        <li>Pluggable Samplers allow unlimited testing capabilities.</li>
        <li><b>Scriptable Samplers</b> (JSR223-compatible languages like <a href="http://groovy-lang.org">Groovy</a> and BeanShell)</li>
        <li>Several load statistics may be chosen with <b>pluggable timers</b>.</li>
        <li>Data analysis and <b>visualization plugins</b> allow great extensibility
        as well as personalization.</li>
        <li>Functions can be used to provide dynamic input to a test or provide data manipulation.</li>
        <li>Easy Continuous Integration through 3<sup>rd</sup> party Open Source libraries for Maven, Gradle and Jenkins.</li>
      </ul>
    </li>
</ul>
<h2>How do I do it?</h2>
<ul>
<li><a href="usermanual/index.html">Using JMeter</a> to understand how to use it</li>
<li><a href="usermanual/component_reference.html">Component reference</a> to have detailed information for every Test element</li>
<li><a href="usermanual/functions.html">Functions reference</a> to have detailed information and examples for every function</li>
<li><a href="usermanual/properties_reference.html">Properties reference</a> for all properties that allow you to customize JMeter</li>
<li><a href="api/index.html">Javadoc API documentation</a></li>
<li><a href="https://wiki.apache.org/jmeter/JMeterFAQ">JMeter FAQ (Wiki)</a></li>
<li><a href="https://wiki.apache.org/jmeter/">JMeter Wiki</a></li>
<li><a href="building.html">Building JMeter and Add-Ons</a> for advanced usage</li>
</ul>

<h2>JMeter is not a browser</h2>
<p>
JMeter is not a browser, it works at protocol level.
As far as web-services and remote services are concerned, JMeter looks like a browser (or rather, multiple browsers);
however JMeter does not perform all the actions supported by browsers.
In particular, JMeter does not execute the Javascript found in HTML pages.
Nor does it render the HTML pages as a browser does 
(it's possible to view the response as HTML etc., but the timings are not included in any samples, and only one sample in one thread is ever displayed at a time).
</p>

<h2>Tutorials</h2>
<ul>
<li><a href="usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li>
<li><a href="usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li>
<li><a href="usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li>
<li><a href="usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log Sampler</a></li>
<li><a href="usermanual/jmeter_tutorial.html">Extending JMeter</a></li>
</ul>
<h2>Further Information About JMeter</h2>
<ul>
<li><a href="changes.html">Changes List</a></li>
<li><a href="issues.html">Read about existing Issues (Bugs or Enhancements) or reporting new ones (please do it !)</a></li>
<li><a href="https://www.apache.org/licenses/">License</a></li>
<li><a href="mail.html">Mailing Lists</a></li>
<li><a href="svnindex.html">Source Repositories</a></li>
<li><a href="https://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li>
</ul>
</section>
</body>
</document>
