You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jmeter-dev@jakarta.apache.org by se...@apache.org on 2008/05/27 20:06:01 UTC
svn commit: r660629 [16/18] - in /jakarta/jmeter/trunk/docs: ./ localising/
usermanual/
Modified: jakarta/jmeter/trunk/docs/usermanual/listeners.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/listeners.html?rev=660629&r1=660628&r2=660629&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/listeners.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/listeners.html Tue May 27 11:05:49 2008
@@ -1,275 +1,275 @@
-<!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 -->
- <!-- ====================================================================== -->
- <!-- Main Page Section -->
- <!-- ====================================================================== -->
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
-
-
-
- <title>JMeter - User's Manual: Listeners</title>
- </head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td>
-<!-- Need to specify height otherwise iframe seems to grab extra -->
-<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
- style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
-</td>
-<td align="left">
-<a href="http://jakarta.apache.org"><img width="505" height="48" src="../images/jakarta-logo.gif" alt="Jakarta" title="Jakarta" border="0"/></a>
-</td>
-<td align="right">
-<a href="http://jakarta.apache.org/jmeter/"><img width="221" height="102" src="../images/logo.jpg" alt="JMeter" title="JMeter" border="0"/></a>
-</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">
- <p><strong>About</strong></p>
- <ul>
- <li> <a href="../index.html">Overview</a>
-</li>
- <li> <a href="../changes.html">Changes</a>
-</li>
- <li> <a href="../known_bugs.html">Known Bugs</a>
-</li>
- <li> <a href="../license.html">License</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
-</li>
- </ul>
- <p><strong>Download</strong></p>
- <ul>
- <li> <a href="http://jakarta.apache.org/site/downloads/downloads_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="../usermanual/index.html">User Manual</a>
-</li>
- <li> <a href="../api/index.html">Javadocs</a>
-</li>
- <li> <a href="../localising/index.html">Localisation (Translator's Guide)</a>
-</li>
- <li> <a href="../building.html">Building JMeter and Add-Ons</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-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://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
-</li>
- </ul>
- </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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+<!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 -->
+ <!-- ====================================================================== -->
+ <!-- Main Page Section -->
+ <!-- ====================================================================== -->
+ <html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+
+
+ <title>JMeter - User's Manual: Listeners</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" cellspacing="0">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td>
+<!-- Need to specify height otherwise iframe seems to grab extra -->
+<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
+ style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
+</td>
+<td align="left">
+<a href="http://jakarta.apache.org"><img width="505" height="48" src="../images/jakarta-logo.gif" alt="Jakarta" title="Jakarta" border="0"/></a>
+</td>
+<td align="right">
+<a href="http://jakarta.apache.org/jmeter/"><img width="221" height="102" src="../images/logo.jpg" alt="JMeter" title="JMeter" border="0"/></a>
+</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">
+ <p><strong>About</strong></p>
+ <ul>
+ <li> <a href="../index.html">Overview</a>
+</li>
+ <li> <a href="../changes.html">Changes</a>
+</li>
+ <li> <a href="../known_bugs.html">Known Bugs</a>
+</li>
+ <li> <a href="../license.html">License</a>
+</li>
+ <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
+</li>
+ </ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/downloads/downloads_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="../usermanual/index.html">User Manual</a>
+</li>
+ <li> <a href="../api/index.html">Javadocs</a>
+</li>
+ <li> <a href="../localising/index.html">Localisation (Translator's Guide)</a>
+</li>
+ <li> <a href="../building.html">Building JMeter and Add-Ons</a>
+</li>
+ <li> <a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
+</li>
+ <li> <a href="http://wiki.apache.org/jakarta-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://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
+</li>
+ </ul>
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <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>
+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">
+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>
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>
- <p >
+
+ </td></tr>
+ </table></p>
+ <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 >
+
+ </p>
+ <p >
-
- </p>
- <p >
+
+ </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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <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 >
+
+ </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>
- <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>
- <p >
+output results like:.
+ </p>
+ <p >
-
- <code >
+
+ <code >
-
- <pre >
+
+ <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>
+
+ </pre>
-
- </code>
- </p>
- <p >
+
+ </code>
+ </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>
- <p >
+misnomer in this case. (Think of CSV as meaning character separated values)
+ </p>
+ <p >
-
- <code >
+
+ <code >
-
- <pre >
+
+ <pre >
jmeter.save.saveservice.output_format=csv
jmeter.save.saveservice.assertion_results_failure_message=true
jmeter.save.saveservice.default_delimiter=|
-
- </pre>
+
+ </pre>
-
- </code>
+
+ </code>
-
- <p >
+
+ <p >
The full set of properties that affect result file output is shown below.
-
- </p>
+
+ </p>
-
- <code >
+
+ <code >
-
- <pre >
+
+ <pre >
#---------------------------------------------------------------------------
# Results file configuration
@@ -341,309 +341,309 @@
# Optional xml processing instruction for line 2 of the file:
#jmeter.save.saveservice.xml_pi=<?xml-stylesheet type="text/xsl" href="sample.xsl"?>
-
- </pre>
+
+ </pre>
-
- </code>
- </p>
- <p >
-
-The date format to be used for the timestamp_format is described in
- <a HREF="http://java.sun.com/j2se/1.4/docs/api/java/text/SimpleDateFormat.html">
-
-
- <b >
- SimpleDateFormat
- </b>
- </a>
+
+ </code>
+ </p>
+ <p >
+
+The date format to be used for the timestamp_format is described in
+ <a HREF="http://java.sun.com/j2se/1.4/docs/api/java/text/SimpleDateFormat.html">
+
+
+ <b >
+ SimpleDateFormat
+ </b>
+ </a>
.
Bear in mind that choosing a date format other than "ms" is likely to
make it impossible for JMeter to interpret the value when it is read
-in later for viewing purposes.
- </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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
-
-Versions of JMeter after 2.3.1 allow one to use the
- <b >
- sample_variables
- </b>
+in later for viewing purposes.
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
+
+Versions of JMeter after 2.3.1 allow one to use 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>
- </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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </p>
+ </blockquote>
+ </td></tr>
+ <tr><td><br></td></tr>
+ </table>
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <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 >
+
+ </p>
+ <p >
This feature can be used to specify different data and log files for each test run, for example:
-
- <pre >
+
+ <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>
+
+ </pre>
-
- </p>
- <p >
-
-Note that JMeter logging messages are written to the file
- <b >
- jmeter.log
- </b>
+
+ </p>
+ <p >
+
+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 >
+
+ </p>
+ <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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- <b >
- Listeners can use a lot of memory if there are a lot of samples.
- </b>
+
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <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 Listener
- </li>
-
-
- <li >
- Assertion Results
- </li>
-
-
- <li >
- Mailer Visualizer
- </li>
-
-
- <li >
- Monitor Results
- </li>
-
-
- <li >
- Summary Report
- </li>
-
-
- </ul>
- <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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </p>
+ <ul >
+
+
+ <li >
+ Simple Data Writer
+ </li>
+
+
+ <li >
+ BeanShell Listener
+ </li>
+
+
+ <li >
+ Assertion Results
+ </li>
+
+
+ <li >
+ Mailer Visualizer
+ </li>
+
+
+ <li >
+ Monitor Results
+ </li>
+
+
+ <li >
+ Summary Report
+ </li>
+
+
+ </ul>
+ <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>
+ </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 >
- 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 >
- 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.0"><strong>14.5 XML Log format 2.0</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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 >
+ 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 >
+ 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.0"><strong>14.5 XML Log format 2.0</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
The format of the original XML (2.0) is as follows (line breaks will be different):
-
- </p>
- <pre >
+
+ </p>
+ <pre >
<?xml version="1.0" encoding="UTF-8"?>
<testResults version="1.2">
@@ -669,27 +669,27 @@
</sampleResult>
...
</testResults>
-
- </pre>
- </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.6 XML Log format 2.1</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </pre>
+ </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.6 XML Log format 2.1</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
The format of the updated XML (2.1) is as follows (line breaks will be different):
-
- </p>
- <pre >
+
+ </p>
+ <pre >
<?xml version="1.0" encoding="UTF-8"?>
<testResults version="1.2">
@@ -773,381 +773,381 @@
</sample>
</testResults>
-
- </pre>
- <p >
+
+ </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="attributes"><strong>14.7 Sample Attributes</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
The sample attributes have the following meaning:
-
- </p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Attribute
- </font>
-</td>
- <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Content
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- by
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Bytes
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- de
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Data encoding
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- dt
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Data type
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- ec
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- hn
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- lb
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Label
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- lt
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- na
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- ng
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- rc
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- rm
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- s
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Success flag (true/false)
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- sc
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- t
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Elapsed time (milliseconds)
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- tn
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Thread Name
- </font>
-</td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- ts
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- varname
- </font>
-</td>
- <td bgcolor="#a0ddf0" colspan="" rowspan="" 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>
- </table>
- <p >
+
+ </p>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Attribute
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Content
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ by
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Bytes
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ de
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Data encoding
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ dt
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Data type
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ec
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ hn
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ lb
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Label
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ lt
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ na
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ng
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ rc
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ rm
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ s
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Success flag (true/false)
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ sc
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ t
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Elapsed time (milliseconds)
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ tn
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Thread Name
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ts
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ varname
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" 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>
+ </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">
+
+ </p>
+ <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
<tr><td>
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.
-
- </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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <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 >
- </br>
+
+ <br >
+ </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>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <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 >
+
+ </p>
+ <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>
-
-
- </p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <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>
- </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-2008, Apache Software Foundation
- </em></font></div>
- </td></tr>
- </table>
- </body>
- </html>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+ <b >
+ In order to interpret a header-less CSV file correctly, the appropriate JMeter properties must be set.
+ </b>
+
+
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br></td></tr>
+ </table>
+ <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>
+ </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-2008, Apache Software Foundation
+ </em></font></div>
+ </td></tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Propchange: jakarta/jmeter/trunk/docs/usermanual/listeners.html
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html?rev=660629&r1=660628&r2=660629&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html Tue May 27 11:05:49 2008
@@ -1,625 +1,625 @@
-<!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 -->
- <!-- ====================================================================== -->
- <!-- Main Page Section -->
- <!-- ====================================================================== -->
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
-
-
-
- <title>JMeter - User's Manual: Regular Expressions</title>
- </head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td>
-<!-- Need to specify height otherwise iframe seems to grab extra -->
-<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
- style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
-</td>
-<td align="left">
-<a href="http://jakarta.apache.org"><img width="505" height="48" src="../images/jakarta-logo.gif" alt="Jakarta" title="Jakarta" border="0"/></a>
-</td>
-<td align="right">
-<a href="http://jakarta.apache.org/jmeter/"><img width="221" height="102" src="../images/logo.jpg" alt="JMeter" title="JMeter" border="0"/></a>
-</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">
- <p><strong>About</strong></p>
- <ul>
- <li> <a href="../index.html">Overview</a>
-</li>
- <li> <a href="../changes.html">Changes</a>
-</li>
- <li> <a href="../known_bugs.html">Known Bugs</a>
-</li>
- <li> <a href="../license.html">License</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
-</li>
- </ul>
- <p><strong>Download</strong></p>
- <ul>
- <li> <a href="http://jakarta.apache.org/site/downloads/downloads_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="../usermanual/index.html">User Manual</a>
-</li>
- <li> <a href="../api/index.html">Javadocs</a>
-</li>
- <li> <a href="../localising/index.html">Localisation (Translator's Guide)</a>
-</li>
- <li> <a href="../building.html">Building JMeter and Add-Ons</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-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://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
-</li>
- </ul>
- </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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="functions.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="regex"><strong>20. Regular Expressions</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="overview"><strong>20.1 Overview</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
-
-JMeter includes the pattern matching software
- <a href="http://jakarta.apache.org/oro/">
- Apache Jakarta ORO
- </a>
-
-
- <br >
- </br>
+<!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 -->
+ <!-- ====================================================================== -->
+ <!-- Main Page Section -->
+ <!-- ====================================================================== -->
+ <html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+
+
+ <title>JMeter - User's Manual: Regular Expressions</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" cellspacing="0">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td>
+<!-- Need to specify height otherwise iframe seems to grab extra -->
+<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
+ style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
+</td>
+<td align="left">
+<a href="http://jakarta.apache.org"><img width="505" height="48" src="../images/jakarta-logo.gif" alt="Jakarta" title="Jakarta" border="0"/></a>
+</td>
+<td align="right">
+<a href="http://jakarta.apache.org/jmeter/"><img width="221" height="102" src="../images/logo.jpg" alt="JMeter" title="JMeter" border="0"/></a>
+</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">
+ <p><strong>About</strong></p>
+ <ul>
+ <li> <a href="../index.html">Overview</a>
+</li>
+ <li> <a href="../changes.html">Changes</a>
+</li>
+ <li> <a href="../known_bugs.html">Known Bugs</a>
+</li>
+ <li> <a href="../license.html">License</a>
+</li>
+ <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
+</li>
+ </ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/downloads/downloads_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="../usermanual/index.html">User Manual</a>
+</li>
+ <li> <a href="../api/index.html">Javadocs</a>
+</li>
+ <li> <a href="../localising/index.html">Localisation (Translator's Guide)</a>
+</li>
+ <li> <a href="../building.html">Building JMeter and Add-Ons</a>
+</li>
+ <li> <a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
+</li>
+ <li> <a href="http://wiki.apache.org/jakarta-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://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
+</li>
+ </ul>
+ </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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+ </td>
+ <td bgcolor="#525D76">
+ <div align="right"><a href="functions.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="regex"><strong>20. Regular Expressions</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="overview"><strong>20.1 Overview</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
+
+JMeter includes the pattern matching software
+ <a href="http://jakarta.apache.org/oro/">
+ Apache Jakarta ORO
+ </a>
+
+
+ <br >
+ </br>
There is some documentation for this on the Jakarta web-site, for example
-
- <a href="http://jakarta.apache.org/oro/api/org/apache/oro/text/regex/package-summary.html">
+
+ <a href="http://jakarta.apache.org/oro/api/org/apache/oro/text/regex/package-summary.html">
-a summary of the pattern matching characters
- </a>
+a summary of the pattern matching characters
+ </a>
-
- </p>
- <p >
+
+ </p>
+ <p >
There is also documentation on an older incarnation of the product at
-
- <a href="http://www.savarese.org/oro/docs/OROMatcher/index.html">
- OROMatcher User's guide
- </a>
+
+ <a href="http://www.savarese.org/oro/docs/OROMatcher/index.html">
+ OROMatcher User's guide
+ </a>
, which might prove useful.
-
- </p>
- <p >
+
+ </p>
+ <p >
The pattern matching is very similar to the pattern matching in Perl.
A full installation of Perl will include plenty of documentation on regular expressions - look for perlrequick, perlretut, perlre, perlreref.
-
- </p>
- <p >
+
+ </p>
+ <p >
It is worth stressing the difference between "contains" and "matches", as used on the Response Assertion test element:
-
- </p>
- <ul >
+
+ </p>
+ <ul >
-
- <li >
+
+ <li >
"contains" means that the regular expression matched at least some part of the target,
so 'alphabet' "contains" 'ph.b.' because the regular expression matches the substring 'phabe'.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
"matches" means that the regular expression matched the whole target.
So 'alphabet' is "matched" by 'al.*t'.
-
- </li>
+
+ </li>
-
- </ul>
- <p >
+
+ </ul>
+ <p >
In this case, it is equivalent to wrapping the regular expression in ^ and $, viz '^al.*t$'.
-
- </p>
- <p >
+
+ </p>
+ <p >
However, this is not always the case.
For example, the regular expression 'alp|.lp.*' is "contained" in 'alphabet', but does not match 'alphabet'.
-
- </p>
- <p >
+
+ </p>
+ <p >
Why? Because when the pattern matcher finds the sequence 'alp' in 'alphabet', it stops trying any other combinations - and 'alp' is not the same as 'alphabet', as it does not include 'habet'.
-
- </p>
- <p >
+
+ </p>
+ <p >
Note: unlike Perl, there is no need to (i.e. do not) enclose the regular expression in //.
-
- </p>
- <p >
+
+ </p>
+ <p >
So how does one use the modifiers ismx etc if there is no trailing /?
-The solution is to use
- <i >
- extended regular expressions
- </i>
+The solution is to use
+ <i >
+ extended regular expressions
+ </i>
, i.e. /abc/i becomes (?i)abc.
-See also
- <a href="placement">
- Placement of modifiers
- </a>
+See also
+ <a href="placement">
+ Placement of modifiers
+ </a>
below.
-
- </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="examples"><strong>20.2 Examples</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="examples"><strong>20.2 Examples</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
Extract single string
-
- <br >
- </br>
+
+ <br >
+ </br>
Suppose you want to match the following portion of a web-page:
-
- <br >
- </br>
+
+ <br >
+ </br>
name="file" value="readme.txt" and you want to extract readme.txt.
-
- <br >
- </br>
+
+ <br >
+ </br>
A suitable reqular expression would be:
-
- <br >
- </br>
+
+ <br >
+ </br>
name="file" value="(.+?)"
-
- <p >
+
+ <p >
The special characters above are:
-
- </p>
+
+ </p>
-
- <ul >
+
+ <ul >
-
- <li >
- ( and ) - these enclose the portion of the match string to be returned
- </li>
+
+ <li >
+ ( and ) - these enclose the portion of the match string to be returned
+ </li>
-
- <li >
+
+ <li >
. - match any character. + - one or more times.
-? - don't be greedy, i.e. stop when first match succeeds
- </li>
+? - don't be greedy, i.e. stop when first match succeeds
+ </li>
-
- </ul>
+
+ </ul>
-
- <p >
+
+ <p >
Note: without the ?, the .+ would continue past the first " until it found the last possible " - probably not what was intended.
-
- </p>
+
+ </p>
-
- <p >
- Extract multiple strings
- </p>
+
+ <p >
+ Extract multiple strings
+ </p>
Suppose you want to match the following portion of a web-page: name="file.name" value="readme.txt" and you want to extract file.name and readme.txt.
-
- <br >
- </br>
+
+ <br >
+ </br>
A suitable reqular expression would be:
-
- <br >
- </br>
+
+ <br >
+ </br>
name="(.+?)" value="(.+?)"
-
- <br >
- </br>
+
+ <br >
+ </br>
This would create 2 groups, which could be used in the JMeter Regular Expression Extractor template as $1$ and $2$.
-
- <p >
+
+ <p >
The JMeter Regex Extractor saves the values of the groups in additional variables.
-
- </p>
+
+ </p>
-
- <p >
+
+ <p >
For example, assume:
-
- </p>
+
+ </p>
-
- <ul >
+
+ <ul >
-
- <li >
- Reference Name: MYREF
- </li>
-
-
- <li >
- Regex: name="(.+?)" value="(.+?)"
- </li>
-
-
- <li >
- Template: $1$$2$
- </li>
-
-
- </ul>
-
-
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td> Do not enclose the regular expression in / /
- </td></tr>
- </table></p>
+
+ <li >
+ Reference Name: MYREF
+ </li>
-
- <p >
+
+ <li >
+ Regex: name="(.+?)" value="(.+?)"
+ </li>
+
+
+ <li >
+ Template: $1$$2$
+ </li>
+
+
+ </ul>
+
+
+ <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+ <tr><td> Do not enclose the regular expression in / /
+ </td></tr>
+ </table></p>
+
+
+ <p >
The following variables would be set:
-
- </p>
+
+ </p>
-
- <ul >
+
+ <ul >
-
- <li >
- MYREF: file.namereadme.txt
- </li>
-
-
- <li >
- MYREF_g0: name="file.name" value="readme.txt"
- </li>
-
-
- <li >
- MYREF_g1: file.name
- </li>
-
-
- <li >
- MYREF_g2: readme.txt
- </li>
+
+ <li >
+ MYREF: file.namereadme.txt
+ </li>
+
+
+ <li >
+ MYREF_g0: name="file.name" value="readme.txt"
+ </li>
+
+
+ <li >
+ MYREF_g1: file.name
+ </li>
-
- </ul>
+
+ <li >
+ MYREF_g2: readme.txt
+ </li>
+
+
+ </ul>
These variables can be referred to later on in the JMeter test plan, as ${MYREF}, ${MYREF_g1} etc
-
- </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="line_mode"><strong>20.3 Line mode</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="line_mode"><strong>20.3 Line mode</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
The pattern matching behaves in various slightly different ways,
depending on the setting of the multi-line and single-line modifiers.
Note that the single-line and multi-line operators have nothing to do with each other;
they can be specified independently.
-
- </p>
- <h3 >
- Single-line mode
- </h3>
- <p >
+
+ </p>
+ <h3 >
+ Single-line mode
+ </h3>
+ <p >
Single-line mode only affects how the '.' meta-character is interpreted.
-
- </p>
- <p >
+
+ </p>
+ <p >
Default behaviour is that '.' matches any character except newline.
In single-line mode, '.' also matches newline.
-
- </p>
- <h3 >
- Multi-line mode
- </h3>
- <p >
+
+ </p>
+ <h3 >
+ Multi-line mode
+ </h3>
+ <p >
Multi-line mode only affects how the meta-characters '^' and '$' are interpreted.
-
- </p>
- <p >
+
+ </p>
+ <p >
Default behaviour is that '^' and '$' only match at the very beginning and end of the string.
When Multi-line mode is used, the '^' metacharacter matches at the beginning of every line,
-and the '$' metacharacter matches at the end of every line.
- </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="meta_chars"><strong>20.4 Meta characters</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+and the '$' metacharacter matches at the end of every line.
+ </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="meta_chars"><strong>20.4 Meta characters</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
Regular expressions use certain characters as meta characters - these characters have a special meaning to the RE engine.
Such characters must be escaped by preceeding them with \ (backslash) in order to treat them as ordinary characters.
Here is a list of the meta characters and their meaning (please check the ORO documentation if in doubt).
-
- </p>
- <ul >
-
-
- <li >
- ( ) - grouping
- </li>
-
-
- <li >
- [ ] - character classes
- </li>
-
-
- <li >
- { } - repetition
- </li>
-
-
- <li >
- * + ? - repetition
- </li>
-
-
- <li >
- . - wild-card character
- </li>
-
-
- <li >
- \ - escape character
- </li>
-
-
- <li >
- | - alternatives
- </li>
-
-
- <li >
- ^ $ - start and end of string or line
- </li>
-
-
- </ul>
- <p >
+
+ </p>
+ <ul >
+
+
+ <li >
+ ( ) - grouping
+ </li>
+
+
+ <li >
+ [ ] - character classes
+ </li>
+
+
+ <li >
+ { } - repetition
+ </li>
+
+
+ <li >
+ * + ? - repetition
+ </li>
+
+
+ <li >
+ . - wild-card character
+ </li>
+
+
+ <li >
+ \ - escape character
+ </li>
+
+
+ <li >
+ | - alternatives
+ </li>
+
+
+ <li >
+ ^ $ - start and end of string or line
+ </li>
+
+
+ </ul>
+ <p >
Please note that ORO does not support the \Q and \E meta-characters.
-[In other RE engines, these can be used to quote a portion of an RE so that the meta-characters stand for themselves.]
- </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="placement"><strong>20.5 Placement of modifiers</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+[In other RE engines, these can be used to quote a portion of an RE so that the meta-characters stand for themselves.]
+ </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="placement"><strong>20.5 Placement of modifiers</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
Modifiers can be placed anywhere in the regex, and apply from that point onwards.
[A bug in ORO means that they cannot be used at the very end of the regex.
However they would have no effect there anyway.]
-
- </p>
- <p >
+
+ </p>
+ <p >
The single-line (?s) and multi-line (?m) modifiers are normally placed at the start of the regex.
-
- </p>
- <p >
+
+ </p>
+ <p >
The ignore-case modifier (?i) may be usefully applied to just part of a regex,
for example:
-
- <pre >
+
+ <pre >
Match ExAct case or (?i)ArBiTrARY(?-i) case
-
- </pre>
+
+ </pre>
-
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="functions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
- </td>
- </tr>
- </table>
- <br>
- </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-2008, Apache Software Foundation
- </em></font></div>
- </td></tr>
- </table>
- </body>
- </html>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+ </p>
+ </blockquote>
+ </td></tr>
+ <tr><td><br></td></tr>
+ </table>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br></td></tr>
+ </table>
+ <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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+ </td>
+ <td bgcolor="#525D76">
+ <div align="right"><a href="functions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+ </td>
+ </tr>
+ </table>
+ <br>
+ </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-2008, Apache Software Foundation
+ </em></font></div>
+ </td></tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Propchange: jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html
------------------------------------------------------------------------------
svn:eol-style = native
---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org