You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jmeter.apache.org by mi...@apache.org on 2015/03/08 11:22:59 UTC
svn commit: r1664961 [16/19] - in /jmeter/trunk/docs: ./ css/ usermanual/
Modified: jmeter/trunk/docs/usermanual/listeners.html
URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/listeners.html?rev=1664961&r1=1664960&r2=1664961&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/listeners.html (original)
+++ jmeter/trunk/docs/usermanual/listeners.html Sun Mar 8 10:22:58 2015
@@ -1,322 +1,109 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<!--
- 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.
--->
-
-<!-- Content Stylesheet for Site -->
-
-
-<!-- start the processing -->
-<html>
-<head>
-<link rel="stylesheet" type="text/css" href="../css/style.css"/>
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
-
-<title>Apache JMeter - User's Manual: Listeners</title>
-</head>
-
-<body bgcolor="#ffffff" text="#000000" link="#525D76">
-<table width="100%" cellspacing="0" border="0">
-<tr>
-<td width="90%" align="left">
-<table border="0" cellspacing="0">
-<tr>
-<td width="10%">
-<a href="http://www.apache.org"><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" border="0"/></a>
-</td>
-<td align="left" width="40%">
-
-<a href="http://jmeter.apache.org/"><img width="182" height="88" src="../images/logo.jpg" alt="Apache JMeter" title="Apache JMeter" border="0"/></a>
-</td>
-</tr>
-</table>
-</td>
-<td align="left" width="50%">
-<table cellspacing="0" align="right" border="0">
-<tr>
-<td align="left"> <a href="https://twitter.com/share"
-class="twitter-share-button"
-data-text="Powerful Load Testing with
-Apache #JMeter" data-via="ApacheJMeter"
-data-lang="en-gb" data-size="large">Tweet</a>
-<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
-</td>
-<td align="right"> <a
-href="https://twitter.com/ApacheJMeter"
-class="twitter-follow-button"
-data-show-count="false" data-lang="en-gb"
-data-size="large">Follow</a>
-<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
-</td>
-</tr>
-</table>
-</td></tr>
-</table>
-
-<table border="0" width="100%" cellspacing="4">
-<tr><td colspan="2">
-<hr noshade size="1"/>
-</td></tr>
-<tr>
-<!-- LEFT SIDE NAVIGATION -->
-<td width="20%" valign="top" nowrap="true">
-<table border="0" width="100%" cellspacing="0">
-<tr><td>
-<p><strong>About</strong></p>
-<ul>
-<li><a href="../index.html">Overview</a>
-</li>
-<li><a href="http://twitter.com/ApacheJMeter">JMeter on Twitter</a>
-<img src="../images/twitter.png" align="top"/></li>
-<li><a href="../issues.html">Issue Tracking</a>
-</li>
-<li><a href="http://projects.apache.org/feeds/rss/jmeter.xml">Subscribe to What's New</a>
-</li>
-<li><a href="http://www.apache.org/licenses/">License</a>
-</li>
-</ul>
-<p><strong>Download</strong></p>
-<ul>
-<li><a href="../download_jmeter.cgi">Download Releases</a>
-</li>
-<li><a href="../nightly.html">Developer (Nightly) Builds</a>
-</li>
-</ul>
-<p><strong>Documentation</strong></p>
-<ul>
-<li><a href="../changes.html">Changes per version</a>
-</li>
-<li><a href="../usermanual/get-started.html">Get Started</a>
-</li>
-<li><a href="../usermanual/index.html">User Manual</a>
-</li>
-<li><a href="../usermanual/best-practices.html">Best Practices</a>
-</li>
-<li><a href="../usermanual/component_reference.html">Component Reference</a>
-</li>
-<li><a href="../usermanual/functions.html">Functions Reference</a>
-</li>
-<li><a href="../api/index.html">Javadocs</a>
-</li>
-<li><a href="../building.html">Building JMeter and Add-Ons</a>
-</li>
-<li><a href="http://wiki.apache.org/jmeter">JMeter Wiki</a>
-</li>
-<li><a href="http://wiki.apache.org/jmeter/JMeterFAQ">FAQ (Wiki)</a>
-</li>
-</ul>
-<p><strong>Tutorials (PDF format)</strong></p>
-<ul>
-<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a>
-</li>
-<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a>
-</li>
-<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a>
-</li>
-<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a>
-</li>
-<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a>
-</li>
-</ul>
-<p><strong>Community</strong></p>
-<ul>
-<li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a>
-</li>
-<li><a href="../mail.html">Mailing Lists</a>
-</li>
-<li><a href="../svnindex.html">SVN Repositories</a>
-</li>
-</ul>
-<p><strong>Foundation</strong></p>
-<ul>
-<li><a href="http://www.apache.org/">ASF</a>
-</li>
-<li><a href="http://www.apache.org/foundation/getinvolved.html">Get Involved in the ASF</a>
-</li>
-<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
-</li>
-<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
-</li>
-</ul>
-</td></tr>
-<tr><td>
-<iframe src="http://www.apache.org/ads/button.html" style="border-width:0; float: left;" frameborder="0" scrolling="no"></iframe>
-</td></tr>
-</table>
-</td>
-<td width="80%" align="left" valign="top">
-<table>
-<tr>
-<td bgcolor="#525D76">
-<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="remote-test.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="build-monitor-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
-</tr>
-</table>
-<br>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="intro"><strong>14. Introduction to listeners</strong></a><a class="sectionlink" href="#intro" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
-A listener is a component that shows the results of the
+<!DOCTYPE html SYSTEM "about:legacy-compat">
+<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter
+ -
+ User's Manual: Listeners</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal" rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!--
+ APACHE LOGO
+ --><div><a href="http://www.apache.org"><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!--
+ PROJECT LOGO
+ --><div><a href="http://jmeter.apache.org/"><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share" class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script>
+ (function(d,s,id){
+ var js,
+ fjs=d.getElementsByTagName(s)[0],
+ p=/^http:/.test(d.location)?'http':'https';
+ if (!d.getElementById(id)) {
+ js=d.createElement(s);
+ js.id=id;
+ js.src=p+'://platform.twitter.com/widgets.js';
+ fjs.parentNode.insertBefore(js,fjs);
+ }
+ })(document, 'script', 'twitter-wjs');
+ </script></div><div><a href="https://twitter.com/ApacheJMeter" class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){
+ var js,
+ fjs=d.getElementsByTagName(s)[0],
+ p=/^http:/.test(d.location)?'http':'https';
+ if (!d.getElementById(id)) {
+ js=d.createElement(s);
+ js.id=id;
+ js.src=p+'://platform.twitter.com/widgets.js';
+ fjs.parentNode.insertBefore(js,fjs);
+ }
+ })(document, 'script', 'twitter-wjs');
+ </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html" style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter">JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml">Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html"
>Changes per version</a></li><li><a href="../usermanual/get-started.html">Get Started</a></li><li><a href="../usermanual/index.html">User Manual</a></li><li><a href="../usermanual/best-practices.html">Best Practices</a></li><li><a href="../usermanual/component_reference.html">Component Reference</a></li><li><a href="../usermanual/functions.html">Functions Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a href="../building.html">Building JMeter and Add-Ons</a></li><li><a href="http://wiki.apache.org/jmeter">JMeter Wiki</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterFAQ">FAQ (Wiki)</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Tutorials (PDF format)</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a></li><li><a href="../us
ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/">ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html">Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-monitor-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="remote-
test.html">Next ></a></li></ul><div class="section"><h1 id="intro">14. Introduction to listeners<a class="sectionlink" href="#intro" title="Link to here">¶</a></h1>
+<p>A listener is a component that shows the results of the
samples. The results can be shown in a tree, tables, graphs or simply written to a log
file. To view the contents of a response from any given sampler, add either of the Listeners "View
Results Tree" or "View Results in table" to a test plan. To view the response time graphically, add
graph results, spline results or distribution graph.
-The
-<a href="../usermanual/component_reference.html#listeners">listeners</a>
-
-section of the components page has full descriptions of all the listeners.
-</p>
-<p>
-<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
-<tr><td>
+The <a href="../usermanual/component_reference.html#listeners">listeners</a>
+section of the components page has full descriptions of all the listeners.</p>
+
+<div class="clear"></div><div class="note">
Different listeners display the response information in different ways.
However, they all write the same raw data to the output file - if one is specified.
-
-</td></tr>
-</table>
-</p>
+</div><div class="clear"></div>
<p>
-
The "Configure" button can be used to specify which fields to write to the file, and whether to
write it as CSV or XML.
CSV files are much smaller than XML files, so use CSV if you are generating lots of samples.
-
</p>
<p>
-
The file name can be specified using either a relative or an absolute path name.
Relative paths are resolved relative to the current working directory (which defaults to the bin/ directory).
Versions of JMeter after 2.4 also support paths relative to the directory containing the current test plan (JMX file).
If the path name begins with "~/" (or whatever is in the jmeter.save.saveservice.base_prefix JMeter property),
then the path is assumed to be relative to the JMX file location.
-
</p>
<p>
-
If you only wish to record certain samples, add the Listener as a child of the sampler.
Or you can use a Simple Controller to group a set of samplers, and add the Listener to that.
The same filename can be used by multiple samplers - but make sure they all use the same configuration!
-
</p>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="defaults"><strong>14.1 Default Configuration</strong></a><a class="sectionlink" href="#defaults" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
+</div><div class="section"><h1 id="defaults">14.1 Default Configuration<a class="sectionlink" href="#defaults" title="Link to here">¶</a></h1>
<p>
-
The default items to be saved can be defined in the jmeter.properties (or user.properties) file.
The properties are used as the initial settings for the Listener Config pop-up, and are also
used for the log file specified by the -l command-line flag (commonly used for non-GUI test runs).
-
</p>
+<p>To change the default format, find the following line in jmeter.properties:</p>
+<p>jmeter.save.saveservice.output_format=</p>
<p>
-To change the default format, find the following line in jmeter.properties:
-</p>
-<p>
-jmeter.save.saveservice.output_format=
-</p>
-<p>
-
The information to be saved is configurable. For maximum information, choose "xml" as the format and specify "Functional Test Mode" on the Test Plan element. If this box is not checked, the default saved
data includes a time stamp (the number of milliseconds since midnight,
January 1, 1970 UTC), the data type, the thread name, the label, the
-response time, message, and code, and a success indicator. If checked, all information, including the full response data will be logged.
-</p>
+response time, message, and code, and a success indicator. If checked, all information, including the full response data will be logged.</p>
<p>
-
The following example indicates how to set
properties to get a vertical bar ("|") delimited format that will
-output results like:.
-</p>
+output results like:.</p>
<p>
-
-
-<code>
-
-
+<span class="code">
<pre>
-
timeStamp|time|label|responseCode|threadName|dataType|success|failureMessage
02/06/03 08:21:42|1187|Home|200|Thread Group-1|text|true|
02/06/03 08:21:42|47|Login|200|Thread Group-1|text|false|Test Failed:
expected to contain: password etc.
-
</pre>
-
-
-</code>
-</p>
+</span></p>
<p>
-
The corresponding jmeter.properties that need to be set are shown below. One oddity
in this example is that the output_format is set to csv, which
typically
indicates comma-separated values. However, the default_delimiter was
set to be a vertical bar instead of a comma, so the csv tag is a
-misnomer in this case. (Think of CSV as meaning character separated values)
-</p>
+misnomer in this case. (Think of CSV as meaning character separated values)</p>
<p>
-
-
-<code>
-
-
+<span class="code">
<pre>
-
jmeter.save.saveservice.output_format=csv
jmeter.save.saveservice.assertion_results_failure_message=true
jmeter.save.saveservice.default_delimiter=|
-
</pre>
-
-
-</code>
-
-
+</span>
<p>
-
The full set of properties that affect result file output is shown below.
-
</p>
-
-
-<code>
-
-
+<span class="code">
<pre>
-
#---------------------------------------------------------------------------
# Results file configuration
#---------------------------------------------------------------------------
@@ -372,7 +159,7 @@ sampleresult.timestamp.start=true
#sampleresult.useNanoTime=true
# Use a background thread to calculate the nanoTime offset
-# Set this to <= 0 to disable the background thread
+# Set this to <= 0 to disable the background thread
#sampleresult.nanoThreadSleep=5000
# legitimate values: none, first, all
@@ -396,465 +183,186 @@ sampleresult.timestamp.start=true
# to ensure that the correct data is available at the client.
# Optional xml processing instruction for line 2 of the file:
-#jmeter.save.saveservice.xml_pi=<?xml-stylesheet type="text/xsl" href="sample.xsl"?>
+#jmeter.save.saveservice.xml_pi=<?xml-stylesheet type="text/xsl" href="sample.xsl"?>
# Prefix used to identify filenames that are relative to the current base
#jmeter.save.saveservice.base_prefix=~/
-
</pre>
-
-
-</code>
-</p>
+</span></p>
<p>
-
-The date format to be used for the timestamp_format is described in
-<a HREF="http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html">
-
-
-<b>
-SimpleDateFormat
-</b>
-</a>
-.
+The date format to be used for the timestamp_format is described in <a HREF="http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html">
+<b>SimpleDateFormat</b></a>.
The timestamp format is used for both writing and reading files.
If the format is set to "ms", and the column does not parse as a long integer,
JMeter (2.9+) will try the following formats:
-
<ul>
-
-
-<li>
-yyyy/MM/dd HH:mm:ss.SSS
-</li>
-
-
-<li>
-yyyy/MM/dd HH:mm:ss
-</li>
-
-
-<li>
-yyyy-MM-dd HH:mm:ss.SSS
-</li>
-
-
-<li>
-yyyy-MM-dd HH:mm:ss
-</li>
-
-
-<li>
-MM/dd/yy HH:mm:ss (this is for compatibility with previous versions; it is not recommended as a format)
-</li>
-
-
-</ul>
-
+<li>yyyy/MM/dd HH:mm:ss.SSS</li>
+<li>yyyy/MM/dd HH:mm:ss</li>
+<li>yyyy-MM-dd HH:mm:ss.SSS</li>
+<li>yyyy-MM-dd HH:mm:ss</li>
+<li>MM/dd/yy HH:mm:ss (this is for compatibility with previous versions; it is not recommended as a format)</li>
+</ul>
Matching is now also strict (non-lenient).
JMeter 2.8 and earlier used lenient mode which could result in timestamps with incorrect dates
-(times were usually correct).
-</p>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#828DA6">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="sample_variables"><strong>14.1.1 Sample Variables</strong></a>
-<a class="sectionlink" href="#sample_variables" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
-
-JMeter supports the
-<b>
-sample_variables
-</b>
-
+(times were usually correct).</p>
+<div class="subsection"><h2>14.1.1 Sample Variables<a class="sectionlink" href="#sample_variables" title="Link to here">¶</a></h2>
+<p>
+JMeter supports the <b>sample_variables</b>
property to define a list of additional JMeter variables which are to be saved with
each sample in the JTL files. The values are written to CSV files as additional columns,
and as additional attributes in XML files. See above for an example.
-
</p>
-</blockquote>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#828DA6">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="sample_configuration"><strong>14.1.2 Sample Result Save Configuration</strong></a>
-<a class="sectionlink" href="#sample_configuration" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
+</div>
+<div class="subsection"><h2>14.1.2 Sample Result Save Configuration<a class="sectionlink" href="#sample_configuration" title="Link to here">¶</a></h2>
+<p>
Listeners can be configured to save different items to the result log files (JTL) by using the Config popup as shown below.
-The defaults are defined as described in the
-<a href="#defaults">
-Listener Default Configuration
-</a>
- section above.
+The defaults are defined as described in the <a href="#defaults">Listener Default Configuration</a> section above.
Items with (CSV) after the name only apply to the CSV format; items with (XML) only apply to XML format.
CSV format cannot currently be used to save any items that include line-breaks.
-
</p>
-<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/sample_result_config.png"/><br>
-<font size="-1"><br>
-
-<b>
-Configuration dialogue
-</b>
-</font></td></tr></table></p>
-</blockquote>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
+<figure><a href="../images/screenshots/sample_result_config.png"><img src="../images/screenshots/sample_result_config.png" width="" height="" alt=""></a><figcaption><br><b>Configuration dialogue</b></figcaption></figure>
+</div>
<p>
-
Note that cookies, method and the query string are saved as part of the "Sampler Data" option.
-
</p>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="batch"><strong>14.2 non-GUI (batch) test runs</strong></a><a class="sectionlink" href="#batch" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
+</div><div class="section"><h1 id="batch">14.2 non-GUI (batch) test runs<a class="sectionlink" href="#batch" title="Link to here">¶</a></h1>
<p>
-
When running in non-GUI mode, the -l flag can be used to create a top-level listener for the test run.
This is in addition to any Listeners defined in the test plan.
The configuration of this listener is controlled by entries in the file jmeter.properties
as described in the previous section.
-
</p>
<p>
-
This feature can be used to specify different data and log files for each test run, for example:
-
<pre>
-
jmeter -n -t testplan.jmx -l testplan_01.jtl -j testplan_01.log
jmeter -n -t testplan.jmx -l testplan_02.jtl -j testplan_02.log
-
</pre>
-
-
</p>
<p>
-
-Note that JMeter logging messages are written to the file
-<b>
-jmeter.log
-</b>
- by default.
+Note that JMeter logging messages are written to the file <b>jmeter.log</b> by default.
This file is recreated each time, so if you want to keep the log files for each run,
you will need to rename it using the -j option as above. The -j option was added in version 2.3.
-
</p>
-<p>
-Versions of JMeter after 2.3.1 support variables in the log file name.
+<p>Versions of JMeter after 2.3.1 support variables in the log file name.
If the filename contains paired single-quotes, then the name is processed
as a SimpleDateFormat format applied to the current date, for example:
-
-<b>
-log_file='jmeter_'yyyyMMddHHmmss'.tmp'
-</b>
-.
+<b>log_file='jmeter_'yyyyMMddHHmmss'.tmp'</b>.
This can be used to generate a unique name for each test run.
-
-</p>
-</blockquote>
</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="resources"><strong>14.3 Resource usage</strong></a><a class="sectionlink" href="#resources" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
-<b>
-Listeners can use a lot of memory if there are a lot of samples.
-</b>
-
+</div><div class="section"><h1 id="resources">14.3 Resource usage<a class="sectionlink" href="#resources" title="Link to here">¶</a></h1>
+<p><b>Listeners can use a lot of memory if there are a lot of samples.</b>
Most of the listeners currently keep a copy of every sample they display, apart from:
-
</p>
<ul>
-
-
-<li>
-Simple Data Writer
-</li>
-
-
-<li>
-BeanShell/BSF Listener
-</li>
-
-
-<li>
-Mailer Visualizer
-</li>
-
-
-<li>
-Monitor Results
-</li>
-
-
-<li>
-Summary Report
-</li>
-
-
+<li>Simple Data Writer</li>
+<li>BeanShell/BSF Listener</li>
+<li>Mailer Visualizer</li>
+<li>Monitor Results</li>
+<li>Summary Report</li>
</ul>
<p>
-
The following Listeners no longer need to keep copies of every single sample.
Instead, samples with the same elapsed time are aggregated.
Less memory is now needed, especially if most samples only take a second or two at most.
-
</p>
<ul>
-
-
-<li>
-Aggregate Report
-</li>
-
-
-<li>
-Aggregate Graph
-</li>
-
-
-<li>
-Distribution Graph
-</li>
-
-
+<li>Aggregate Report</li>
+<li>Aggregate Graph</li>
+<li>Distribution Graph</li>
</ul>
+<p>To minimise the amount of memory needed, use the Simple Data Writer, and use the CSV format.</p>
+</div><div class="section"><h1 id="csvlogformat">14.4 CSV Log format<a class="sectionlink" href="#csvlogformat" title="Link to here">¶</a></h1>
<p>
-To minimise the amount of memory needed, use the Simple Data Writer, and use the CSV format.
-</p>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="csvlogformat"><strong>14.4 CSV Log format</strong></a><a class="sectionlink" href="#csvlogformat" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
-
The CSV log format depends on which data items are selected in the configuration.
Only the specified data items are recorded in the file.
The order of appearance of columns is fixed, and is as follows:
-
</p>
<ul>
-
-
-<li>
-timeStamp - in milliseconds since 1/1/1970
-</li>
-
-
-<li>
-elapsed - in milliseconds
-</li>
-
-
-<li>
-label - sampler label
-</li>
-
-
-<li>
-responseCode - e.g. 200, 404
-</li>
-
-
-<li>
-responseMessage - e.g. OK
-</li>
-
-
-<li>
-threadName
-</li>
-
-
-<li>
-dataType - e.g. text
-</li>
-
-
-<li>
-success - true or false
-</li>
-
-
-<li>
-failureMessage - if any
-</li>
-
-
-<li>
-bytes - number of bytes in the sample
-</li>
-
-
-<li>
-grpThreads - number of active threads in this thread group
-</li>
-
-
-<li>
-allThreads - total number of active threads in all groups
-</li>
-
-
-<li>
-URL
-</li>
-
-
-<li>
-Filename - if Save Response to File was used
-</li>
-
-
-<li>
-latency - time to first response
-</li>
-
-
-<li>
-connect - time to establish connection
-</li>
-
-
-<li>
-encoding
-</li>
-
-
-<li>
-SampleCount - number of samples (1, unless multiple samples are aggregated)
-</li>
-
-
-<li>
-ErrorCount - number of errors (0 or 1, unless multiple samples are aggregated)
-</li>
-
-
-<li>
-Hostname where the sample was generated
-</li>
-
-
-<li>
-IdleTime - number of milliseconds of 'Idle' time (normally 0)
-</li>
-
-
-<li>
-Variables, if specified
-</li>
-
-
+<li>timeStamp - in milliseconds since 1/1/1970</li>
+<li>elapsed - in milliseconds</li>
+<li>label - sampler label</li>
+<li>responseCode - e.g. 200, 404</li>
+<li>responseMessage - e.g. OK</li>
+<li>threadName</li>
+<li>dataType - e.g. text</li>
+<li>success - true or false</li>
+<li>failureMessage - if any</li>
+<li>bytes - number of bytes in the sample</li>
+<li>grpThreads - number of active threads in this thread group</li>
+<li>allThreads - total number of active threads in all groups</li>
+<li>URL</li>
+<li>Filename - if Save Response to File was used</li>
+<li>latency - time to first response</li>
+<li>connect - time to establish connection</li>
+<li>encoding</li>
+<li>SampleCount - number of samples (1, unless multiple samples are aggregated)</li>
+<li>ErrorCount - number of errors (0 or 1, unless multiple samples are aggregated)</li>
+<li>Hostname where the sample was generated</li>
+<li>IdleTime - number of milliseconds of 'Idle' time (normally 0)</li>
+<li>Variables, if specified</li>
</ul>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="xmlformat2.1"><strong>14.5 XML Log format 2.1</strong></a><a class="sectionlink" href="#xmlformat2.1" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
+</div><div class="section"><h1 id="xmlformat2.1">14.5 XML Log format 2.1<a class="sectionlink" href="#xmlformat2.1" title="Link to here">¶</a></h1>
+<p>
The format of the updated XML (2.1) is as follows (line breaks will be different):
-
</p>
<pre>
-
-<?xml version="1.0" encoding="UTF-8"?>
-<testResults version="1.2">
+<?xml version="1.0" encoding="UTF-8"?>
+<testResults version="1.2">
-- HTTP Sample, with nested samples
<httpSample t="1392" lt="351" ts="1144371014619" s="true"
lb="HTTP Request" rc="200" rm="OK"
- tn="Listen 1-1" dt="text" de="iso-8859-1" by="12407">
+ tn="Listen 1-1" dt="text" de="iso-8859-1" by="12407">
<httpSample t="170" lt="170" ts="1144371015471" s="true"
lb="http://www.apache.org/style/style.css" rc="200" rm="OK"
- tn="Listen 1-1" dt="text" de="ISO-8859-1" by="1002">
- <responseHeader class="java.lang.String">HTTP/1.1 200 OK
+ tn="Listen 1-1" dt="text" de="ISO-8859-1" by="1002">
+ <responseHeader class="java.lang.String">HTTP/1.1 200 OK
Date: Fri, 07 Apr 2006 00:50:14 GMT
...
Content-Type: text/css
-</responseHeader>
- <requestHeader class="java.lang.String">MyHeader: MyValue</requestHeader>
- <responseData class="java.lang.String">body, td, th {
+</responseHeader>
+ <requestHeader class="java.lang.String">MyHeader: MyValue</requestHeader>
+ <responseData class="java.lang.String">body, td, th {
font-size: 95%;
font-family: Arial, Geneva, Helvetica, sans-serif;
color: black;
background-color: white;
}
...
-</responseData>
- <cookies class="java.lang.String"></cookies>
- <method class="java.lang.String">GET</method>
- <queryString class="java.lang.String"></queryString>
- <url>http://www.apache.org/style/style.css</url>
- </httpSample>
+</responseData>
+ <cookies class="java.lang.String"></cookies>
+ <method class="java.lang.String">GET</method>
+ <queryString class="java.lang.String"></queryString>
+ <url>http://www.apache.org/style/style.css</url>
+ </httpSample>
<httpSample t="200" lt="180" ts="1144371015641" s="true"
lb="http://www.apache.org/images/asf_logo_wide.gif"
- rc="200" rm="OK" tn="Listen 1-1" dt="bin" de="ISO-8859-1" by="5866">
- <responseHeader class="java.lang.String">HTTP/1.1 200 OK
+ rc="200" rm="OK" tn="Listen 1-1" dt="bin" de="ISO-8859-1" by="5866">
+ <responseHeader class="java.lang.String">HTTP/1.1 200 OK
Date: Fri, 07 Apr 2006 00:50:14 GMT
...
Content-Type: image/gif
-</responseHeader>
- <requestHeader class="java.lang.String">MyHeader: MyValue</requestHeader>
- <responseData class="java.lang.String">http://www.apache.org/asf.gif</responseData>
- <responseFile class="java.lang.String">Mixed1.html</responseFile>
- <cookies class="java.lang.String"></cookies>
- <method class="java.lang.String">GET</method>
- <queryString class="java.lang.String"></queryString>
- <url>http://www.apache.org/asf.gif</url>
- </httpSample>
- <responseHeader class="java.lang.String">HTTP/1.1 200 OK
+</responseHeader>
+ <requestHeader class="java.lang.String">MyHeader: MyValue</requestHeader>
+ <responseData class="java.lang.String">http://www.apache.org/asf.gif</responseData>
+ <responseFile class="java.lang.String">Mixed1.html</responseFile>
+ <cookies class="java.lang.String"></cookies>
+ <method class="java.lang.String">GET</method>
+ <queryString class="java.lang.String"></queryString>
+ <url>http://www.apache.org/asf.gif</url>
+ </httpSample>
+ <responseHeader class="java.lang.String">HTTP/1.1 200 OK
Date: Fri, 07 Apr 2006 00:50:13 GMT
...
Content-Type: text/html; charset=ISO-8859-1
-</responseHeader>
- <requestHeader class="java.lang.String">MyHeader: MyValue</requestHeader>
- <responseData class="java.lang.String"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+</responseHeader>
+ <requestHeader class="java.lang.String">MyHeader: MyValue</requestHeader>
+ <responseData class="java.lang.String"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
...
&lt;html&gt;
&lt;head&gt;
@@ -864,506 +372,114 @@ Content-Type: text/html; charset=ISO-885
...
&lt;/body&gt;
&lt;/html&gt;
-</responseData>
- <cookies class="java.lang.String"></cookies>
- <method class="java.lang.String">GET</method>
- <queryString class="java.lang.String"></queryString>
- <url>http://www.apache.org/</url>
-</httpSample>
+</responseData>
+ <cookies class="java.lang.String"></cookies>
+ <method class="java.lang.String">GET</method>
+ <queryString class="java.lang.String"></queryString>
+ <url>http://www.apache.org/</url>
+</httpSample>
-- nonHTTPP Sample
<sample t="0" lt="0" ts="1144372616082" s="true" lb="Example Sampler"
- rc="200" rm="OK" tn="Listen 1-1" dt="text" de="ISO-8859-1" by="10">
- <responseHeader class="java.lang.String"></responseHeader>
- <requestHeader class="java.lang.String"></requestHeader>
- <responseData class="java.lang.String">Listen 1-1</responseData>
- <responseFile class="java.lang.String">Mixed2.unknown</responseFile>
- <samplerData class="java.lang.String">ssssss</samplerData>
-</sample>
-
-</testResults>
+ rc="200" rm="OK" tn="Listen 1-1" dt="text" de="ISO-8859-1" by="10">
+ <responseHeader class="java.lang.String"></responseHeader>
+ <requestHeader class="java.lang.String"></requestHeader>
+ <responseData class="java.lang.String">Listen 1-1</responseData>
+ <responseFile class="java.lang.String">Mixed2.unknown</responseFile>
+ <samplerData class="java.lang.String">ssssss</samplerData>
+</sample>
+</testResults>
</pre>
<p>
-
Note that the sample node name may be either "sample" or "httpSample".
-
-</p>
-</blockquote>
</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="xmlformat2.2"><strong>14.6 XML Log format 2.2</strong></a><a class="sectionlink" href="#xmlformat2.2" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
+</div><div class="section"><h1 id="xmlformat2.2">14.6 XML Log format 2.2<a class="sectionlink" href="#xmlformat2.2" title="Link to here">¶</a></h1>
<p>
-
The format of the JTL files is identical for 2.2 and 2.1. Format 2.2 only affects JMX files.
-
</p>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="attributes"><strong>14.7 Sample Attributes</strong></a><a class="sectionlink" href="#attributes" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
+</div><div class="section"><h1 id="attributes">14.7 Sample Attributes<a class="sectionlink" href="#attributes" title="Link to here">¶</a></h1>
<p>
-
The sample attributes have the following meaning:
-
</p>
<table>
-<tr>
-<td bgcolor="#039acc" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Attribute
-</font>
-</td>
-<td bgcolor="#039acc" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Content
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-by
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Bytes
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-de
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Data encoding
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-dt
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Data type
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-ec
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Error count (0 or 1, unless multiple samples are aggregated)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-hn
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Hostname where the sample was generated
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-it
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Idle Time = time not spent sampling (milliseconds) (generally 0)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-lb
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Label
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-lt
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Latency = time to initial response (milliseconds) - not all samplers support this
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-lt
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Connect Time = time to establish the connection (milliseconds) - not all samplers support this
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-na
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Number of active threads for all thread groups
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-ng
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Number of active threads in this group
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-rc
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Response Code (e.g. 200)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-rm
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Response Message (e.g. OK)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
- s
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Success flag (true/false)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-sc
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Sample count (1, unless multiple samples are aggregated)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
- t
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Elapsed time (milliseconds)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-tn
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Thread Name
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-ts
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-timeStamp (milliseconds since midnight Jan 1, 1970 UTC)
-</font>
-</td>
-</tr>
-<tr>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-varname
-</font>
-</td>
-<td bgcolor="#a0ddf0" valign="top" align="left">
-<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-Value of the named variable (versions of JMeter after 2.3.1)
-</font>
-</td>
-</tr>
+<tr><th>Attribute</th><th>Content</th></tr>
+<tr><td>by</td><td>Bytes</td></tr>
+<tr><td>de</td><td>Data encoding</td></tr>
+<tr><td>dt</td><td>Data type</td></tr>
+<tr><td>ec</td><td>Error count (0 or 1, unless multiple samples are aggregated)</td></tr>
+<tr><td>hn</td><td>Hostname where the sample was generated</td></tr>
+<tr><td>it</td><td>Idle Time = time not spent sampling (milliseconds) (generally 0)</td></tr>
+<tr><td>lb</td><td>Label</td></tr>
+<tr><td>lt</td><td>Latency = time to initial response (milliseconds) - not all samplers support this</td></tr>
+<tr><td>ct</td><td>Connect Time = time to establish the connection (milliseconds) - not all samplers support this</td></tr>
+<tr><td>na</td><td>Number of active threads for all thread groups</td></tr>
+<tr><td>ng</td><td>Number of active threads in this group</td></tr>
+<tr><td>rc</td><td>Response Code (e.g. 200)</td></tr>
+<tr><td>rm</td><td>Response Message (e.g. OK)</td></tr>
+<tr><td> s</td><td>Success flag (true/false)</td></tr>
+<tr><td>sc</td><td>Sample count (1, unless multiple samples are aggregated)</td></tr>
+<tr><td> t</td><td>Elapsed time (milliseconds)</td></tr>
+<tr><td>tn</td><td>Thread Name</td></tr>
+<tr><td>ts</td><td>timeStamp (milliseconds since midnight Jan 1, 1970 UTC)</td></tr>
+<tr><td>varname</td><td>Value of the named variable (versions of JMeter after 2.3.1)</td></tr>
</table>
<p>
-
Versions 2.1 and 2.1.1 of JMeter saved the Response Code as "rs", but read it back expecting to find "rc".
This has been corrected so that it is always saved as "rc"; either "rc" or "rs" can be read.
-
</p>
-<p>
-<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
-<tr><td>
+<div class="clear"></div><div class="note">
Versions of JMeter after 2.3.1 allow additional variables to be saved with the test plan.
Currently, the variables are saved as additional attributes.
The testplan variable name is used as the attribute name.
-See
-<a href="#sample_variables">
-Sample variables
-</a>
- (above) for more information.
-
-</td></tr>
-</table>
-</p>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="saving"><strong>14.8 Saving response data</strong></a><a class="sectionlink" href="#saving" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
+See <a href="#sample_variables">Sample variables</a> (above) for more information.
+</div><div class="clear"></div>
+</div><div class="section"><h1 id="saving">14.8 Saving response data<a class="sectionlink" href="#saving" title="Link to here">¶</a></h1>
<p>
-
As shown above, the response data can be saved in the XML log file if required.
However, this can make the file rather large, and the text has to be encoded so
that it is still valid XML. Also, images cannot be included.
-
<br>
-
-
-Another solution is to use the Post-Processor
-<a href="../usermanual/component_reference.html#Save_Responses_to_a_file">Save_Responses_to_a_file</a>
-.
+Another solution is to use the Post-Processor <a href="../usermanual/component_reference.html#Save_Responses_to_a_file">Save_Responses_to_a_file</a>.
This generates a new file for each sample, and saves the file name with the sample.
The file name can then be included in the sample log output.
The data will be retrieved from the file if necessary when the sample log file is reloaded.
-
-</p>
-</blockquote>
</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="loading"><strong>14.9 Loading (reading) response data</strong></a><a class="sectionlink" href="#loading" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
-To view an existing results file, you can use the File "Browse..." button to select a file.
+</div><div class="section"><h1 id="loading">14.9 Loading (reading) response data<a class="sectionlink" href="#loading" title="Link to here">¶</a></h1>
+<p>To view an existing results file, you can use the File "Browse..." button to select a file.
If necessary, just create a dummy testplan with the appropriate Listener in it.
-
</p>
-<p>
-Results can be read from XML or CSV format files.
+<p>Results can be read from XML or CSV format files.
When reading from CSV results files, the header (if present) is used to determine which fields were saved.
-
-<b>
-In order to interpret a header-less CSV file correctly, the appropriate JMeter properties must be set.
-</b>
-
-
+<b>In order to interpret a header-less CSV file correctly, the appropriate JMeter properties must be set.</b>
</p>
-<p>
-<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
-<tr><td>
+<div class="clear"></div><div class="note">
Versions of JMeter up to 2.3.2 used to clear any current data before loading the new file.
This is no longer done, thus allowing files to be merged.
If the previous behaviour is required,
use the menu item Run/Clear (Ctrl+Shift+E) or Run/Clear All (Ctrl+E) before loading the file.
-
-</td></tr>
-</table>
-</p>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="screencap"><strong>14.10 Saving Listener GUI data</strong></a><a class="sectionlink" href="#screencap" title="Link to here">¶</a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
-JMeter is capable of saving any listener as a PNG file. To do so, select the
-listener in the left panel. Click
-<b>
-Edit
-</b>
- >
-<b>
-Save As Image
-</b>
-. A file dialog will
+</div><div class="clear"></div>
+</div><div class="section"><h1 id="screencap">14.10 Saving Listener GUI data<a class="sectionlink" href="#screencap" title="Link to here">¶</a></h1>
+<p>JMeter is capable of saving any listener as a PNG file. To do so, select the
+listener in the left panel. Click <b>Edit</b> > <b>Save As Image</b>. A file dialog will
appear. Enter the desired name and save the listener.
-
</p>
<p>
-
The Listeners which generate output as tables can also be saved using Copy/Paste.
Select the desired cells in the table, and use the OS Copy short-cut (normally Control+C).
The data will be saved to the clipboard, from where it can be pasted into another application,
e.g. a spreadsheet or text editor.
-
</p>
-<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/save_image.png"/><br>
-<font size="-1">Figure 1 - Edit > Save As Image
-</font></td></tr></table></p>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<br>
-<table>
-<tr>
-<td bgcolor="#525D76">
-<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="remote-test.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="build-monitor-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<tr><td colspan="2">
-<hr noshade size="1"/>
-</td></tr>
-<tr><td colspan="2">
-<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2015, Apache Software Foundation
-</em></font></div>
-</td></tr>
-<tr><td colspan="2">
-<div align="center"><font color="#525D76" size="-1">
-Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are
-trademarks of the Apache Software Foundation.
-</font>
-</div>
-</td></tr>
-</table>
-</body>
-</html>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+<figure><a href="../images/screenshots/save_image.png"><img src="../images/screenshots/save_image.png" width="" height="" alt="Figure 1 - Edit > Save As Image"></a><figcaption>Figure 1 - Edit > Save As Image</figcaption></figure>
+</div><ul class="pagelinks"><li><a href="build-monitor-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="remote-test.html">Next ></a></li></ul></div><div class="footer"><div class="copyright">
+ Copyright ©
+ 1999 –
+ 2015
+ , Apache Software Foundation
+ </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache
+ feather, and the Apache JMeter logo are
+ trademarks of the
+ Apache Software Foundation.
+ </div></div></body></html>
\ No newline at end of file