Modified: jmeter/trunk/docs/usermanual/ldapanswer_xml.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/ldapanswer_xml.html?rev=1808646&r1=1808645&r2=1808646&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/ldapanswer_xml.html (original) +++ jmeter/trunk/docs/usermanual/ldapanswer_xml.html Sun Sep 17 18:22:16 2017 @@ -1,11 +1,191 @@ <!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 +<html lang="en"> +<head> +<META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"> +<title>Apache JMeter - - User's Manual: LDAP answer XML description</title><meta name="author" value="Apache JMeter developers"><meta name="email" value="d...@jmeter.apache.org"><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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + User's Manual: LDAP answer XML description</title> +<meta name="author" value="Apache JMeter developers"> +<meta name="email" value="d...@jmeter.apache.org"> +<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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css"; rel="stylesheet" type="text/css"> +<link rel="stylesheet" type="text/css" href="../css/new-style.css"> +<link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"> +<link rel="icon" href="../images/favicon.png"> +<meta name="msapplication-TileColor" content="#ffffff"> +<meta name="msapplication-TileImage" content="../images/mstile-144x144.png"> +<meta name="theme-color" content="#ffffff"> +</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" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!-- + --> +<div> +<a href="http://www.apache.org";><img title="Apache Software Foundation" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a> +</div> +<!-- PROJECT LOGO - --><div><a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html";><img src="http://www.apache.org/events/current-event-234x60.png"; alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter";>Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter"; title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter"; title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><div class="section"><h1 id="ldapans_xml">description of the ldapanswer XML definition<a class="sectionlink" href="#ldapans_xml" title="Link to here">¶</a></h1> + --> +<div> +<a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a> +</div> +<div class="banner"> +<a href="http://www.apache.org/events/current-event.html";><img src="http://www.apache.org/events/current-event-234x60.png"; alt="Current Apache event teaser"></a> +<div class="clear"></div> +</div> +</div> +<div class="nav"> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">About</div> +<ul> +<li> +<a href="../index.html">Overview</a> +</li> +<li> +<a href="http://www.apache.org/licenses/";>License</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Download</div> +<ul> +<li> +<a href="../download_jmeter.cgi">Download Releases</a> +</li> +<li> +<a href="../changes.html">Release Notes</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Documentation</div> +<ul> +<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="../usermanual/properties_reference.html">Properties Reference</a> +</li> +<li> +<a href="../changes_history.html">Change History</a> +</li> +<li> +<a href="../api/index.html">Javadocs</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 onClick="return true"> +<div class="menu-title">Tutorials</div> +<ul> +<li> +<a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a> +</li> +<li> +<a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a> +</li> +<li> +<a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a> +</li> +<li> +<a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log Sampler</a> +</li> +<li> +<a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Community</div> +<ul> +<li> +<a href="../issues.html">Issue Tracking</a> +</li> +<li> +<a href="http://www.apache.org/security/";>Security</a> +</li> +<li> +<a href="../mail.html">Mailing Lists</a> +</li> +<li> +<a href="../svnindex.html">Source Repositories</a> +</li> +<li> +<a href="../building.html">Building and Contributing</a> +</li> +<li> +<a href="https://projects.apache.org/project.html?jmeter";>Project info at Apache</a> +</li> +<li> +<a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Foundation</div> +<ul> +<li> +<a href="http://www.apache.org/";>The Apache Software Foundation (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"> +<div class="social-media"> +<ul class="social-media-links"> +<li class="twitter"> +<a href="https://twitter.com/ApacheJMeter"; title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a> +</li> +<li class="github"> +<a href="https://github.com/apache/jmeter"; title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a> +</li> +</ul> +</div> +<div class="section"> +<h1 id="ldapans_xml">description of the ldapanswer XML definition<a class="sectionlink" href="#ldapans_xml" title="Link to here">¶</a> +</h1> + <p> The extended LDAP sampler was built to support testing for very complex testpurposes. It was aimed at supporting the LDAP operations as close as possible. @@ -13,55 +193,100 @@ construct an answer in xml encoding, so the results may be parsed with regextracter or alike functions. </p> -<div class="subsection"><h2 id="overview">1 Global overview<a class="sectionlink" href="#overview" title="Link to here">¶</a></h2> + +<div class="subsection"> +<h2 id="overview">1 Global overview<a class="sectionlink" href="#overview" title="Link to here">¶</a> +</h2> + <p> The global structure is as follows:<br> + </p> -<div class="subsection"><h2 id="operation">1.1 The operation section<a class="sectionlink" href="#operation" title="Link to here">¶</a></h2> + +<div class="subsection"> +<h2 id="operation">1.1 The operation section<a class="sectionlink" href="#operation" title="Link to here">¶</a> +</h2> + <p> The operation section defines the operation as it is sent to the LDAP Server. The following tags (with a short explanation) are used </p> + </div> -<div class="subsection"><h2 id="response_message">1.2 Response message section<a class="sectionlink" href="#response_message" title="Link to here">¶</a></h2> + +<div class="subsection"> +<h2 id="response_message">1.2 Response message section<a class="sectionlink" href="#response_message" title="Link to here">¶</a> +</h2> + <p> As the response code, the official LDAP error definitions are used, so this section contains the error message as returned from the server. -A succesfull request always returns "Success" as the responsmessage. +A successful request always returns "Success" as the response message. The following tag is used: </p> + </div> -<div class="subsection"><h2 id="response_code">1.3 Response code section<a class="sectionlink" href="#response_code" title="Link to here">¶</a></h2> + +<div class="subsection"> +<h2 id="response_code">1.3 Response code section<a class="sectionlink" href="#response_code" title="Link to here">¶</a> +</h2> + <p> As the response code, the official LDAP error definitions are used, so this section contains the error number as returned from the server. -A succesfull request always returns 0 (zero) as the responscode. +A successful request always returns 0 (zero) as the response code. The following tag is used: </p> + </div> -<div class="subsection"><h2 id="search">1.4 Search Result section<a class="sectionlink" href="#search" title="Link to here">¶</a></h2> + +<div class="subsection"> +<h2 id="search">1.4 Search Result section<a class="sectionlink" href="#search" title="Link to here">¶</a> +</h2> + <p> The following tag is used: </p> + +</div> + </div> + </div> -</div><div class="share-links"> +<div class="share-links"> Share this page: - <ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u="; title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url="; title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url="; title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright"> + <ul> +<li class="fb"> +<a data-social-url="https://facebook.com/sharer/sharer.php?u="; title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a> +</li> +<li class="twitter"> +<a data-social-url="https://twitter.com/intent/tweet?url="; title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a> +</li> +<li class="gplus"> +<a data-social-url="https://plus.google.com/share?url="; title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a> +</li> +</ul> +</div> +</div> +<div class="footer"> +<div class="copyright"> Copyright © 1999 – 2017 , Apache Software Foundation - </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache + </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><script>(function(){ + </div> +</div> +<script>(function(){ // fill in the current location into social links on this page. "use strict"; var as = document.getElementsByTagName('a'); @@ -75,4 +300,6 @@ The following tag is used: as[i].href = href + encodeURIComponent(loc); } } - })();</script></body></html> \ No newline at end of file + })();</script> +</body> +</html>
Modified: jmeter/trunk/docs/usermanual/ldapops_tutor.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/ldapops_tutor.html?rev=1808646&r1=1808645&r2=1808646&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/ldapops_tutor.html (original) +++ jmeter/trunk/docs/usermanual/ldapops_tutor.html Sun Sep 17 18:22:16 2017 @@ -1,12 +1,190 @@ <!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 +<html lang="en"> +<head> +<META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"> +<title>Apache JMeter - - JMeter - User's Manual: LDAP Operations</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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + JMeter - User's Manual: LDAP Operations</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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css"; rel="stylesheet" type="text/css"> +<link rel="stylesheet" type="text/css" href="../css/new-style.css"> +<link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"> +<link rel="icon" href="../images/favicon.png"> +<meta name="msapplication-TileColor" content="#ffffff"> +<meta name="msapplication-TileImage" content="../images/mstile-144x144.png"> +<meta name="theme-color" content="#ffffff"> +</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" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!-- + --> +<div> +<a href="http://www.apache.org";><img title="Apache Software Foundation" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a> +</div> +<!-- PROJECT LOGO - --><div><a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html";><img src="http://www.apache.org/events/current-event-234x60.png"; alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter";>Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter"; title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter"; title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><div class="section"><h1 id="ops">A short LDAP Operations tutorial<a class="sectionlink" href="#ops" title="Link to here">¶</a></h1> - <p> + --> +<div> +<a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a> +</div> +<div class="banner"> +<a href="http://www.apache.org/events/current-event.html";><img src="http://www.apache.org/events/current-event-234x60.png"; alt="Current Apache event teaser"></a> +<div class="clear"></div> +</div> +</div> +<div class="nav"> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">About</div> +<ul> +<li> +<a href="../index.html">Overview</a> +</li> +<li> +<a href="http://www.apache.org/licenses/";>License</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Download</div> +<ul> +<li> +<a href="../download_jmeter.cgi">Download Releases</a> +</li> +<li> +<a href="../changes.html">Release Notes</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Documentation</div> +<ul> +<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="../usermanual/properties_reference.html">Properties Reference</a> +</li> +<li> +<a href="../changes_history.html">Change History</a> +</li> +<li> +<a href="../api/index.html">Javadocs</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 onClick="return true"> +<div class="menu-title">Tutorials</div> +<ul> +<li> +<a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a> +</li> +<li> +<a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a> +</li> +<li> +<a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a> +</li> +<li> +<a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log Sampler</a> +</li> +<li> +<a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Community</div> +<ul> +<li> +<a href="../issues.html">Issue Tracking</a> +</li> +<li> +<a href="http://www.apache.org/security/";>Security</a> +</li> +<li> +<a href="../mail.html">Mailing Lists</a> +</li> +<li> +<a href="../svnindex.html">Source Repositories</a> +</li> +<li> +<a href="../building.html">Building and Contributing</a> +</li> +<li> +<a href="https://projects.apache.org/project.html?jmeter";>Project info at Apache</a> +</li> +<li> +<a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Foundation</div> +<ul> +<li> +<a href="http://www.apache.org/";>The Apache Software Foundation (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"> +<div class="social-media"> +<ul class="social-media-links"> +<li class="twitter"> +<a href="https://twitter.com/ApacheJMeter"; title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a> +</li> +<li class="github"> +<a href="https://github.com/apache/jmeter"; title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a> +</li> +</ul> +</div> +<div class="section"> +<h1 id="ops">A short LDAP Operations tutorial<a class="sectionlink" href="#ops" title="Link to here">¶</a> +</h1> + +<p> The extended LDAP sampler was built to support testing for very complex testpurposes. It was aimed at supporting the LDAP operations as close as possible. In this short tutorial, I will explain which LDAP operations exist and what they do. @@ -20,70 +198,120 @@ The type of an object is determined by the "structural objectClass" eg person, organizationalUnit or country.<br> The attributes contain the data of an object, eg mailaddress, name, streetaddress etc. Each attribute can have 0, 1 or more values. </p> -<div class="subsection"><h2 id="bind">1 Bind operation<a class="sectionlink" href="#bind" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="bind">1 Bind operation<a class="sectionlink" href="#bind" title="Link to here">¶</a> +</h2> + +<p> Any contact with an LDAP server MUST start with a bind request. LDAP is a state dependent protocol. Without opening a session to a LDAP server, no additional request can be made. Due to some peculiarities in the JAVA libraries, 2 different bind operations are implemented. </p> -<div class="subsection"><h2 id="thread_bind">1.1 Thread Bind<a class="sectionlink" href="#thread_bind" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="thread_bind">1.1 Thread Bind<a class="sectionlink" href="#thread_bind" title="Link to here">¶</a> +</h2> + +<p> This bind is meant to open a session to a LDAP server. Any testplan should use this operation as the starting point from a session. For each Thread (each virtual user) a separate connection with the LDAP server is build, and so a separate Thread bind is performed. </p> + </div> -<div class="subsection"><h2 id="single">1.2 Single bind/unbind<a class="sectionlink" href="#single" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="single">1.2 Single bind/unbind<a class="sectionlink" href="#single" title="Link to here">¶</a> +</h2> + +<p> This bind is used for user authentication verification. A proper developed LDAP client, who needs an authenticated user, perform a bind with a given distinguished name and password. This Single bind/unbind operation is for this purpose. It builds it own separate connection to the LDAP server, performs a bind operation, and ends the connection again (by sending an unbind). </p> + </div> + </div> -<div class="subsection"><h2 id="unbind">2 Unbind<a class="sectionlink" href="#unbind" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="unbind">2 Unbind<a class="sectionlink" href="#unbind" title="Link to here">¶</a> +</h2> + +<p> To close a connection to a LDAP server, an unbind operation is needed. As the Single bind/unbind operation already (implicitly) performs an unbind, only a Thread unbind operation is needed. This Thread unbind just closes the connection and cleans up any resources it has used. </p> + </div> -<div class="subsection"><h2 id="compare">3 Compare<a class="sectionlink" href="#compare" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="compare">3 Compare<a class="sectionlink" href="#compare" title="Link to here">¶</a> +</h2> + +<p> The compare operation needs the full distinguished name from a LDAP object, as well as a attribute and a value for the attribute. It will simply check: "Has this object really this attribute with this value?". Typical use is checking the membership of a certain user with a given group. </p> + </div> -<div class="subsection"><h2 id="search">4 Search<a class="sectionlink" href="#search" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="search">4 Search<a class="sectionlink" href="#search" title="Link to here">¶</a> +</h2> + +<p> The search test simply searches for all objects which comply with a given search filter, e.g. all persons with a "employeeType=inactive" or "all persons with a userID equals user1" </p> + </div> -<div class="subsection"><h2 id="add">5 Add<a class="sectionlink" href="#add" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="add">5 Add<a class="sectionlink" href="#add" title="Link to here">¶</a> +</h2> + +<p> This simply add an object to the LDAP directory. Off course the combination of attributes and distinguishedName must be valid! </p> + </div> -<div class="subsection"><h2 id="modify">6 Modify<a class="sectionlink" href="#modify" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="modify">6 Modify<a class="sectionlink" href="#modify" title="Link to here">¶</a> +</h2> + +<p> This operation modifies one or more attributes from a given object. It needs the distinguished name from the object, as well as the attributes and the new values for this attribute.<br> Three versions are available, add, for adding an attribute value<br> replace, for overwriting the old attribute value with a new value<br> delete, to delete a value form an attribute, or to delete all the values of an attribute<br> - </p> + +</p> + </div> -<div class="subsection"><h2 id="delete">7 Delete<a class="sectionlink" href="#delete" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="delete">7 Delete<a class="sectionlink" href="#delete" title="Link to here">¶</a> +</h2> + +<p> This operation deletes an object from the LDAP server. It needs the distinguished name from the object. </p> + </div> -<div class="subsection"><h2 id="moddn">8 modDN<a class="sectionlink" href="#moddn" title="Link to here">¶</a></h2> - <p> + +<div class="subsection"> +<h2 id="moddn">8 modDN<a class="sectionlink" href="#moddn" title="Link to here">¶</a> +</h2> + +<p> This operation modifies the distinguished name from an object (it "moves" the object).<br> It comes in two flavours, just renaming an entry, then you specify a new RDN (relative distinguished name, this is the lowest part of the DN)<br> e.g. you can rename "cn=admin,dc=test,dc=com" to cn=administrator,dc=test,dc=com"<br> @@ -91,19 +319,39 @@ e.g. you can move a complete subtree "ou=retired,ou=people,dc=test,dc=com" to a new subtree "ou=retired people,dc=test,dc=com" by specifying a new rdn "ou=retired people" and a new superior of "dc=test,dc=com" </p> + +</div> + </div> -</div><div class="share-links"> +<div class="share-links"> Share this page: - <ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u="; title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url="; title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url="; title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright"> + <ul> +<li class="fb"> +<a data-social-url="https://facebook.com/sharer/sharer.php?u="; title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a> +</li> +<li class="twitter"> +<a data-social-url="https://twitter.com/intent/tweet?url="; title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a> +</li> +<li class="gplus"> +<a data-social-url="https://plus.google.com/share?url="; title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a> +</li> +</ul> +</div> +</div> +<div class="footer"> +<div class="copyright"> Copyright © 1999 – 2017 , Apache Software Foundation - </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache + </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><script>(function(){ + </div> +</div> +<script>(function(){ // fill in the current location into social links on this page. "use strict"; var as = document.getElementsByTagName('a'); @@ -117,4 +365,6 @@ as[i].href = href + encodeURIComponent(loc); } } - })();</script></body></html> \ No newline at end of file + })();</script> +</body> +</html> Modified: jmeter/trunk/docs/usermanual/listeners.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/listeners.html?rev=1808646&r1=1808645&r2=1808646&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/listeners.html (original) +++ jmeter/trunk/docs/usermanual/listeners.html Sun Sep 17 18:22:16 2017 @@ -1,11 +1,200 @@ <!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 +<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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + 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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css"; rel="stylesheet" type="text/css"> +<link rel="stylesheet" type="text/css" href="../css/new-style.css"> +<link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"> +<link rel="icon" href="../images/favicon.png"> +<meta name="msapplication-TileColor" content="#ffffff"> +<meta name="msapplication-TileImage" content="../images/mstile-144x144.png"> +<meta name="theme-color" content="#ffffff"> +</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" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!-- + --> +<div> +<a href="http://www.apache.org";><img title="Apache Software Foundation" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a> +</div> +<!-- PROJECT LOGO - --><div><a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html";><img src="http://www.apache.org/events/current-event-234x60.png"; alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter";>Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter"; title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter"; title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></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 class="section"><h1 id="intro">13. Introduction to listeners<a class="sectionlink" href="#intro" title="Link to here">¶</a></h1> + --> +<div> +<a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a> +</div> +<div class="banner"> +<a href="http://www.apache.org/events/current-event.html";><img src="http://www.apache.org/events/current-event-234x60.png"; alt="Current Apache event teaser"></a> +<div class="clear"></div> +</div> +</div> +<div class="nav"> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">About</div> +<ul> +<li> +<a href="../index.html">Overview</a> +</li> +<li> +<a href="http://www.apache.org/licenses/";>License</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Download</div> +<ul> +<li> +<a href="../download_jmeter.cgi">Download Releases</a> +</li> +<li> +<a href="../changes.html">Release Notes</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Documentation</div> +<ul> +<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="../usermanual/properties_reference.html">Properties Reference</a> +</li> +<li> +<a href="../changes_history.html">Change History</a> +</li> +<li> +<a href="../api/index.html">Javadocs</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 onClick="return true"> +<div class="menu-title">Tutorials</div> +<ul> +<li> +<a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a> +</li> +<li> +<a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a> +</li> +<li> +<a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a> +</li> +<li> +<a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log Sampler</a> +</li> +<li> +<a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Community</div> +<ul> +<li> +<a href="../issues.html">Issue Tracking</a> +</li> +<li> +<a href="http://www.apache.org/security/";>Security</a> +</li> +<li> +<a href="../mail.html">Mailing Lists</a> +</li> +<li> +<a href="../svnindex.html">Source Repositories</a> +</li> +<li> +<a href="../building.html">Building and Contributing</a> +</li> +<li> +<a href="https://projects.apache.org/project.html?jmeter";>Project info at Apache</a> +</li> +<li> +<a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a> +</li> +</ul> +</li> +</ul> +<ul class="menu"> +<li onClick="return true"> +<div class="menu-title">Foundation</div> +<ul> +<li> +<a href="http://www.apache.org/";>The Apache Software Foundation (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"> +<div class="social-media"> +<ul class="social-media-links"> +<li class="twitter"> +<a href="https://twitter.com/ApacheJMeter"; title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a> +</li> +<li class="github"> +<a href="https://github.com/apache/jmeter"; title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a> +</li> +</ul> +</div> +<ul class="pagelinks"> +<li> +<a href="build-jms-topic-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">12. 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 "<span class="code">View @@ -14,15 +203,20 @@ graph results. 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"> + +<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. -</div><div class="clear"></div> +</div> +<div class="clear"></div> + <p> The "<span class="code">Configure</span>" 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 <span class="code">bin/</span> directory). @@ -30,34 +224,46 @@ JMeter also supports paths relative to t If the path name begins with "<span class="code">~/</span>" (or whatever is in the <span class="code">jmeter.save.saveservice.base_prefix</span> 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> -</div><div class="section"><h1 id="defaults">13.1 Default Configuration<a class="sectionlink" href="#defaults" title="Link to here">¶</a></h1> + +</div> +<div class="section"> +<h1 id="defaults">12.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 <span class="code">jmeter.properties</span> (or <span class="code">user.properties</span>) 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 <span class="code">-l</span> command-line flag (commonly used for non-GUI test runs). </p> + <p>To change the default format, find the following line in <span class="code">jmeter.properties</span>:</p> + <pre class="source">jmeter.save.saveservice.output_format=</pre> + <p> The information to be saved is configurable. For maximum information, choose "<span class="code">xml</span>" as the format and specify "<span class="code">Functional Test Mode</span>" 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> The following example indicates how to set properties to get a vertical bar ("<span class="code">|</span>") delimited format that will output results like:.</p> + <pre class="source"> 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> + <p> The corresponding <span class="code">jmeter.properties</span> that need to be set are shown below. One oddity in this example is that the <span class="code">output_format</span> is set to <span class="code">csv</span>, which @@ -65,14 +271,17 @@ typically indicates comma-separated values. However, the <span class="code">default_delimiter</span> 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> + <pre class="source"> jmeter.save.saveservice.output_format=csv jmeter.save.saveservice.assertion_results_failure_message=true jmeter.save.saveservice.default_delimiter=| </pre> + <p> The full set of properties that affect result file output is shown below. </p> + <pre class="source"> #--------------------------------------------------------------------------- # Results file configuration @@ -167,6 +376,7 @@ sampleresult.timestamp.start=true # Set this to <= 0 to disable the background thread #sampleresult.nanoThreadSleep=5000 </pre> + <p> The date format to be used for the <span class="code">timestamp_format</span> is described in <a HREF="http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html";> <b>SimpleDateFormat</b></a>. @@ -174,119 +384,248 @@ The timestamp format is used for both wr If the format is set to "<span class="code">ms</span>", and the column does not parse as a long integer, JMeter (2.9+) will try the following formats: <ul> -<li><span class="code">yyyy/MM/dd HH:mm:ss.SSS</span></li> -<li><span class="code">yyyy/MM/dd HH:mm:ss</span></li> -<li><span class="code">yyyy-MM-dd HH:mm:ss.SSS</span></li> -<li><span class="code">yyyy-MM-dd HH:mm:ss</span></li> -<li><span class="code">MM/dd/yy HH:mm:ss</span> (this is for compatibility with previous versions; it is not recommended as a format)</li> + +<li> +<span class="code">yyyy/MM/dd HH:mm:ss.SSS</span> +</li> + +<li> +<span class="code">yyyy/MM/dd HH:mm:ss</span> +</li> + +<li> +<span class="code">yyyy-MM-dd HH:mm:ss.SSS</span> +</li> + +<li> +<span class="code">yyyy-MM-dd HH:mm:ss</span> +</li> + +<li> +<span class="code">MM/dd/yy HH:mm:ss</span> (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> -<div class="subsection"><h2 id="sample_variables">13.1.1 Sample Variables<a class="sectionlink" href="#sample_variables" title="Link to here">¶</a></h2> + +<div class="subsection"> +<h2 id="sample_variables">12.1.1 Sample Variables<a class="sectionlink" href="#sample_variables" title="Link to here">¶</a> +</h2> + <p> JMeter supports the <span class="code">sample_variables</span> 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> + </div> -<div class="subsection"><h2 id="sample_configuration">13.1.2 Sample Result Save Configuration<a class="sectionlink" href="#sample_configuration" title="Link to here">¶</a></h2> + +<div class="subsection"> +<h2 id="sample_configuration">12.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. 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> -<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> + +<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 "<span class="code">Sampler Data</span>" option. </p> -</div><div class="section"><h1 id="batch">13.2 non-GUI (batch) test runs<a class="sectionlink" href="#batch" title="Link to here">¶</a></h1> + +</div> +<div class="section"> +<h1 id="batch">12.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 <span class="code">-l</span> 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 <span class="code">jmeter.properties</span> 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: </p> + <pre class="source"> 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> Note that JMeter logging messages are written to the file <span class="code">jmeter.log</span> 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 <span class="code">-j</span> option as above. </p> + <p>JMeter supports variables in the log file name. If the filename contains paired single-quotes, then the name is processed as a <span class="code">SimpleDateFormat</span> format applied to the current date, for example: <span class="code">log_file='jmeter_'yyyyMMddHHmmss'.tmp'</span>. This can be used to generate a unique name for each test run. </p> -</div><div class="section"><h1 id="resources">13.3 Resource usage<a class="sectionlink" href="#resources" title="Link to here">¶</a></h1> -<div class="clear"></div><div class="note"> Listeners can use a lot of memory if there are a lot of samples.</div><div class="clear"></div> + +</div> +<div class="section"> +<h1 id="resources">12.3 Resource usage<a class="sectionlink" href="#resources" title="Link to here">¶</a> +</h1> + +<div class="clear"></div> +<div class="note"> Listeners can use a lot of memory if there are a lot of samples.</div> +<div class="clear"></div> + <p> Most of the listeners currently keep a copy of every sample they display, apart from: </p> + <ul> + <li>Simple Data Writer</li> + <li>BeanShell/JSR223 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> + </ul> + <p>To minimize the amount of memory needed, use the Simple Data Writer, and use the CSV format.</p> -</div><div class="section"><h1 id="csvlogformat">13.4 CSV Log format<a class="sectionlink" href="#csvlogformat" title="Link to here">¶</a></h1> + +</div> +<div class="section"> +<h1 id="csvlogformat">12.4 CSV Log format<a class="sectionlink" href="#csvlogformat" title="Link to here">¶</a> +</h1> + <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><span class="code">timeStamp</span> - in milliseconds since 1/1/1970</li> -<li><span class="code">elapsed</span> - in milliseconds</li> -<li><span class="code">label</span> - sampler label</li> -<li><span class="code">responseCode</span> - e.g. <span class="code">200</span>, <span class="code">404</span></li> -<li><span class="code">responseMessage</span> - e.g. <span class="code">OK</span></li> -<li><span class="code">threadName</span></li> -<li><span class="code">dataType</span> - e.g. <span class="code">text</span></li> -<li><span class="code">success</span> - <span class="code">true</span> or <span class="code">false</span></li> -<li><span class="code">failureMessage</span> - if any</li> -<li><span class="code">bytes</span> - number of bytes in the sample</li> -<li><span class="code">sentBytes</span> - number of bytes sent for the sample</li> -<li><span class="code">grpThreads</span> - number of active threads in this thread group</li> -<li><span class="code">allThreads</span> - total number of active threads in all groups</li> -<li><span class="code">URL</span></li> -<li><span class="code">Filename</span> - if <span class="code">Save Response to File</span> was used</li> -<li><span class="code">latency</span> - time to first response</li> -<li><span class="code">connect</span> - time to establish connection</li> -<li><span class="code">encoding</span></li> -<li><span class="code">SampleCount</span> - number of samples (1, unless multiple samples are aggregated)</li> -<li><span class="code">ErrorCount</span> - number of errors (0 or 1, unless multiple samples are aggregated)</li> -<li><span class="code">Hostname</span> - where the sample was generated</li> -<li><span class="code">IdleTime</span> - number of milliseconds of 'Idle' time (normally 0)</li> -<li><span class="code">Variables</span>, if specified</li> + +<li> +<span class="code">timeStamp</span> - in milliseconds since 1/1/1970</li> + +<li> +<span class="code">elapsed</span> - in milliseconds</li> + +<li> +<span class="code">label</span> - sampler label</li> + +<li> +<span class="code">responseCode</span> - e.g. <span class="code">200</span>, <span class="code">404</span> +</li> + +<li> +<span class="code">responseMessage</span> - e.g. <span class="code">OK</span> +</li> + +<li> +<span class="code">threadName</span> +</li> + +<li> +<span class="code">dataType</span> - e.g. <span class="code">text</span> +</li> + +<li> +<span class="code">success</span> - <span class="code">true</span> or <span class="code">false</span> +</li> + +<li> +<span class="code">failureMessage</span> - if any</li> + +<li> +<span class="code">bytes</span> - number of bytes in the sample</li> + +<li> +<span class="code">sentBytes</span> - number of bytes sent for the sample</li> + +<li> +<span class="code">grpThreads</span> - number of active threads in this thread group</li> + +<li> +<span class="code">allThreads</span> - total number of active threads in all groups</li> + +<li> +<span class="code">URL</span> +</li> + +<li> +<span class="code">Filename</span> - if <span class="code">Save Response to File</span> was used</li> + +<li> +<span class="code">latency</span> - time to first response</li> + +<li> +<span class="code">connect</span> - time to establish connection</li> + +<li> +<span class="code">encoding</span> +</li> + +<li> +<span class="code">SampleCount</span> - number of samples (1, unless multiple samples are aggregated)</li> + +<li> +<span class="code">ErrorCount</span> - number of errors (0 or 1, unless multiple samples are aggregated)</li> + +<li> +<span class="code">Hostname</span> - where the sample was generated</li> + +<li> +<span class="code">IdleTime</span> - number of milliseconds of 'Idle' time (normally 0)</li> + +<li> +<span class="code">Variables</span>, if specified</li> + </ul> -</div><div class="section"><h1 id="xmlformat2.1">13.5 XML Log format 2.1<a class="sectionlink" href="#xmlformat2.1" title="Link to here">¶</a></h1> + +</div> +<div class="section"> +<h1 id="xmlformat2.1">12.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 class="source"> <?xml version="1.0" encoding="UTF-8"?> <testResults version="1.2"> @@ -371,48 +710,132 @@ Content-Type: text/html; charset=ISO-885 </testResults> </pre> + <p> Note that the sample node name may be either "<span class="code">sample</span>" or "<span class="code">httpSample</span>". </p> -</div><div class="section"><h1 id="xmlformat2.2">13.6 XML Log format 2.2<a class="sectionlink" href="#xmlformat2.2" title="Link to here">¶</a></h1> + +</div> +<div class="section"> +<h1 id="xmlformat2.2">12.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> -</div><div class="section"><h1 id="attributes">13.7 Sample Attributes<a class="sectionlink" href="#attributes" title="Link to here">¶</a></h1> + +</div> +<div class="section"> +<h1 id="attributes">12.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><th>Attribute</th><th>Content</th></tr> -<tr><td><span class="code">by</span></td><td>Bytes</td></tr> -<tr><td><span class="code">sby</span></td><td>Sent Bytes</td></tr> -<tr><td><span class="code">de</span></td><td>Data encoding</td></tr> -<tr><td><span class="code">dt</span></td><td>Data type</td></tr> -<tr><td><span class="code">ec</span></td><td>Error count (0 or 1, unless multiple samples are aggregated)</td></tr> -<tr><td><span class="code">hn</span></td><td>Hostname where the sample was generated</td></tr> -<tr><td><span class="code">it</span></td><td>Idle Time = time not spent sampling (milliseconds) (generally 0)</td></tr> -<tr><td><span class="code">lb</span></td><td>Label</td></tr> -<tr><td><span class="code">lt</span></td><td>Latency = time to initial response (milliseconds) - not all samplers support this</td></tr> -<tr><td><span class="code">ct</span></td><td>Connect Time = time to establish the connection (milliseconds) - not all samplers support this</td></tr> -<tr><td><span class="code">na</span></td><td>Number of active threads for all thread groups</td></tr> -<tr><td><span class="code">ng</span></td><td>Number of active threads in this group</td></tr> -<tr><td><span class="code">rc</span></td><td>Response Code (e.g. <span class="code">200</span>)</td></tr> -<tr><td><span class="code">rm</span></td><td>Response Message (e.g. <span class="code">OK</span>)</td></tr> -<tr><td> <span class="code">s</span></td><td>Success flag (<span class="code">true</span>/<span class="code">false</span>)</td></tr> -<tr><td><span class="code">sc</span></td><td>Sample count (1, unless multiple samples are aggregated)</td></tr> -<tr><td> <span class="code">t</span></td><td>Elapsed time (milliseconds)</td></tr> -<tr><td><span class="code">tn</span></td><td>Thread Name</td></tr> -<tr><td><span class="code">ts</span></td><td>timeStamp (milliseconds since midnight Jan 1, 1970 UTC)</td></tr> -<tr><td><span class="code">varname</span></td><td>Value of the named variable</td></tr> + +<tr> +<th>Attribute</th><th>Content</th> +</tr> + +<tr> +<td><span class="code">by</span></td><td>Bytes</td> +</tr> + +<tr> +<td><span class="code">sby</span></td><td>Sent Bytes</td> +</tr> + +<tr> +<td><span class="code">de</span></td><td>Data encoding</td> +</tr> + +<tr> +<td><span class="code">dt</span></td><td>Data type</td> +</tr> + +<tr> +<td><span class="code">ec</span></td><td>Error count (0 or 1, unless multiple samples are aggregated)</td> +</tr> + +<tr> +<td><span class="code">hn</span></td><td>Hostname where the sample was generated</td> +</tr> + +<tr> +<td><span class="code">it</span></td><td>Idle Time = time not spent sampling (milliseconds) (generally 0)</td> +</tr> + +<tr> +<td><span class="code">lb</span></td><td>Label</td> +</tr> + +<tr> +<td><span class="code">lt</span></td><td>Latency = time to initial response (milliseconds) - not all samplers support this</td> +</tr> + +<tr> +<td><span class="code">ct</span></td><td>Connect Time = time to establish the connection (milliseconds) - not all samplers support this</td> +</tr> + +<tr> +<td><span class="code">na</span></td><td>Number of active threads for all thread groups</td> +</tr> + +<tr> +<td><span class="code">ng</span></td><td>Number of active threads in this group</td> +</tr> + +<tr> +<td><span class="code">rc</span></td><td>Response Code (e.g. <span class="code">200</span>)</td> +</tr> + +<tr> +<td><span class="code">rm</span></td><td>Response Message (e.g. <span class="code">OK</span>)</td> +</tr> + +<tr> +<td> <span class="code">s</span></td><td>Success flag (<span class="code">true</span>/<span class="code">false</span>)</td> +</tr> + +<tr> +<td><span class="code">sc</span></td><td>Sample count (1, unless multiple samples are aggregated)</td> +</tr> + +<tr> +<td> <span class="code">t</span></td><td>Elapsed time (milliseconds)</td> +</tr> + +<tr> +<td><span class="code">tn</span></td><td>Thread Name</td> +</tr> + +<tr> +<td><span class="code">ts</span></td><td>timeStamp (milliseconds since midnight Jan 1, 1970 UTC)</td> +</tr> + +<tr> +<td><span class="code">varname</span></td><td>Value of the named variable</td> +</tr> + </table> -<div class="clear"></div><div class="note"> + +<div class="clear"></div> +<div class="note"> JMeter allows 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. -</div><div class="clear"></div> -</div><div class="section"><h1 id="saving">13.8 Saving response data<a class="sectionlink" href="#saving" title="Link to here">¶</a></h1> +</div> +<div class="clear"></div> + +</div> +<div class="section"> +<h1 id="saving">12.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 @@ -424,15 +847,24 @@ This generates a new file for each sampl 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> -</div><div class="section"><h1 id="loading">13.9 Loading (reading) response data<a class="sectionlink" href="#loading" title="Link to here">¶</a></h1> + +</div> +<div class="section"> +<h1 id="loading">12.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 "<span class="code">Browse…</span>" 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. 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> -<div class="clear"></div><div class="note"> + +<div class="clear"></div> +<div class="note"> JMeter does not clear any current data before loading the new file thus allowing files to be merged. If you want to clear the current data, use the menu item: <span class="menuchoice"><span class="guimenuitem">Run</span> → <span class="guimenuitem">Clear</span> @@ -443,34 +875,76 @@ or (<span class="keycombo"><span class="keysym">Ctrl</span> + <span class="keysym">E</span></span>) </span> before loading the file. -</div><div class="clear"></div> -</div><div class="section"><h1 id="screencap">13.10 Saving Listener GUI data<a class="sectionlink" href="#screencap" title="Link to here">¶</a></h1> +</div> +<div class="clear"></div> + +</div> +<div class="section"> +<h1 id="screencap">12.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 <span class="menuchoice"><span class="guimenuitem">Edit</span> → <span class="guimenuitem">Save Node As Image</span></span>. 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 <span class="keycombo"><span class="keysym">Ctrl</span> + <span class="keysym">C</span></span>). 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> -<figure><a href="../images/screenshots/save_image.png"><img src="../images/screenshots/save_image.png" width="" height="" alt="Figure 1 - "></a><figcaption>Figure 1 - <span class="menuchoice"><span class="guimenuitem">Edit</span> → <span class="guimenuitem">Save Node As Image</span></span></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 class="share-links"> +<figure> +<a href="../images/screenshots/save_image.png"><img src="../images/screenshots/save_image.png" width="" height="" alt="Figure 1 - "></a> +<figcaption>Figure 1 - <span class="menuchoice"><span class="guimenuitem">Edit</span> → <span class="guimenuitem">Save Node As Image</span></span> +</figcaption> +</figure> + + +</div> +<ul class="pagelinks"> +<li> +<a href="build-jms-topic-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="share-links"> Share this page: - <ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u="; title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url="; title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url="; title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright"> + <ul> +<li class="fb"> +<a data-social-url="https://facebook.com/sharer/sharer.php?u="; title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a> +</li> +<li class="twitter"> +<a data-social-url="https://twitter.com/intent/tweet?url="; title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a> +</li> +<li class="gplus"> +<a data-social-url="https://plus.google.com/share?url="; title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a> +</li> +</ul> +</div> +</div> +<div class="footer"> +<div class="copyright"> Copyright © 1999 – 2017 , Apache Software Foundation - </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache + </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><script>(function(){ + </div> +</div> +<script>(function(){ // fill in the current location into social links on this page. "use strict"; var as = document.getElementsByTagName('a'); @@ -484,4 +958,6 @@ e.g. a spreadsheet or text editor. as[i].href = href + encodeURIComponent(loc); } } - })();</script></body></html> \ No newline at end of file + })();</script> +</body> +</html>
![http://www.apache.org/events/current-event-234x60.png"](http://www.apache.org/events/current-event-234x60.png"){kind=link}