bigbench 0.0.3 → 0.0.4

data/doc/Rakefile.html

@@ -51,6 +51,8 @@
   
     <li class="file"><a href="./Gemfile.html">Gemfile</a>
   
+    <li class="file"><a href="./README_rdoc.html">README</a>
+  
     <li class="file"><a href="./Rakefile.html">Rakefile</a>
   
     <li class="file"><a href="./lib/bigbench/help/executor_txt.html">executor</a>
@@ -93,6 +95,26 @@
   
     <li><a href="./BigBench/PostProcessor/Environment.html">BigBench::PostProcessor::Environment</a>
   
+    <li><a href="./BigBench/PostProcessor/Environment/Appearings.html">BigBench::PostProcessor::Environment::Appearings</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/AttributeCluster.html">BigBench::PostProcessor::Environment::AttributeCluster</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/BenchmarkNotFound.html">BigBench::PostProcessor::Environment::BenchmarkNotFound</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/Cluster.html">BigBench::PostProcessor::Environment::Cluster</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/NormalDistribution.html">BigBench::PostProcessor::Environment::NormalDistribution</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/PolynomialRegression.html">BigBench::PostProcessor::Environment::PolynomialRegression</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/Statistics.html">BigBench::PostProcessor::Environment::Statistics</a>
+  
+    <li><a href="./BigBench/PostProcessor/Graphs.html">BigBench::PostProcessor::Graphs</a>
+  
+    <li><a href="./BigBench/PostProcessor/Graphs/LineGraph.html">BigBench::PostProcessor::Graphs::LineGraph</a>
+  
+    <li><a href="./BigBench/PostProcessor/Graphs/PieGraph.html">BigBench::PostProcessor::Graphs::PieGraph</a>
+  
     <li><a href="./BigBench/PostProcessor/InvalidProcessor.html">BigBench::PostProcessor::InvalidProcessor</a>
   
     <li><a href="./BigBench/PostProcessor/Processor.html">BigBench::PostProcessor::Processor</a>
@@ -111,6 +133,8 @@
   
     <li><a href="./BigBench/Tracker/Tracker.html">BigBench::Tracker::Tracker</a>
   
+    <li><a href="./Array.html">Array</a>
+  
     <li><a href="./EventMachineLoop.html">EventMachineLoop</a>
   
     <li><a href="./Float.html">Float</a>
@@ -127,20 +151,52 @@
 
 <div id="documentation" class="description">
   
-<p>require “bundler/gem_tasks” require “rack”</p>
+<p>require “bundler/gem_tasks” require “rack” require “RedCloth” require
+“redcloth-formatters-rdoc” require “rdoc/task”</p>
 
-<p>namespace :bigbench do</p>
+<p>desc “Create and open documentation” task :doc do</p>
 
-<pre class="ruby"><span class="ruby-identifier">desc</span> <span class="ruby-string">&quot;Create and open documentation&quot;</span>
-<span class="ruby-identifier">task</span> :<span class="ruby-identifier">doc</span> <span class="ruby-keyword">do</span>
-  <span class="ruby-value">%xrdoc --main BigBench --include lib/bigbench/help/ &amp;&amp; open doc/index.html`</span>
-<span class="ruby-keyword">end</span>
+<pre class="ruby"><span class="ruby-comment"># Compile the readme to the rdoc format</span>
+<span class="ruby-identifier">readme_textile</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-string">'README.textile'</span>, <span class="ruby-string">'r+'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> }
+<span class="ruby-identifier">readme_rdoc</span> = <span class="ruby-constant">RedCloth</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">readme_textile</span>).<span class="ruby-identifier">to_rdoc</span>  
+<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-string">'README.rdoc'</span>, <span class="ruby-string">'w+'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">readme_rdoc</span>) }
 
-<span class="ruby-identifier">desc</span> <span class="ruby-string">&quot;Start Thin RDoc Testserver&quot;</span>
-<span class="ruby-identifier">task</span> :<span class="ruby-identifier">testserver</span> <span class="ruby-keyword">do</span>
-  <span class="ruby-identifier">load</span> <span class="ruby-string">&quot;spec/lib/test_web_server.rb&quot;</span>
-  <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Handler</span><span class="ruby-operator">::</span><span class="ruby-constant">Thin</span>.<span class="ruby-identifier">run</span> <span class="ruby-constant">Sinatra</span><span class="ruby-operator">::</span><span class="ruby-constant">Application</span>, :<span class="ruby-constant">Port</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">3001</span>
+<span class="ruby-comment"># Create rdoc with the readme as main file</span>
+<span class="ruby-value">%xrdoc --main README.rdoc --include lib/bigbench/help/`</span>
+
+<span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Task</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">rdoc</span><span class="ruby-operator">|</span>
+  <span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">main</span> = <span class="ruby-string">&quot;README.rdoc&quot;</span>
+  <span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">rdoc_files</span>.<span class="ruby-identifier">include</span>(<span class="ruby-string">&quot;README.rdoc&quot;</span>, <span class="ruby-string">&quot;lib/bigbench/help/&quot;</span>)
 <span class="ruby-keyword">end</span>
+
+<span class="ruby-comment"># Fix RDocs inability to handle tables</span>
+<span class="ruby-identifier">index_html</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-string">'doc/index.html'</span>, <span class="ruby-string">'r+'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> }
+<span class="ruby-identifier">index_html</span>.<span class="ruby-identifier">gsub!</span> <span class="ruby-string">'&amp;lt;'</span>, <span class="ruby-string">'&lt;'</span>
+<span class="ruby-identifier">index_html</span>.<span class="ruby-identifier">gsub!</span> <span class="ruby-string">'&amp;gt;'</span>, <span class="ruby-string">'&gt;'</span>
+<span class="ruby-identifier">index_html</span>.<span class="ruby-identifier">gsub!</span> <span class="ruby-string">'&lt;p&gt;&lt;table&gt;&lt;/p&gt;'</span>, <span class="ruby-string">'&lt;table&gt;'</span>
+<span class="ruby-identifier">index_html</span>.<span class="ruby-identifier">gsub!</span> <span class="ruby-string">'&lt;pre&gt;&lt;tr&gt;'</span>, <span class="ruby-string">'&lt;tr&gt;'</span>
+<span class="ruby-identifier">index_html</span>.<span class="ruby-identifier">gsub!</span> <span class="ruby-string">'&lt;/tr&gt;&lt;/pre&gt;'</span>, <span class="ruby-string">'&lt;/tr&gt;'</span>
+<span class="ruby-identifier">index_html</span>.<span class="ruby-identifier">gsub!</span> <span class="ruby-string">'&lt;p&gt;&lt;/table&gt;&lt;/p&gt;'</span>, <span class="ruby-string">'&lt;/table&gt;'</span>
+<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-string">'doc/index.html'</span>, <span class="ruby-string">'w+'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">index_html</span>) }
+
+<span class="ruby-comment"># Add table style</span>
+<span class="ruby-identifier">rdoc_css</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-string">'doc/rdoc.css'</span>, <span class="ruby-string">'r+'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> }
+<span class="ruby-identifier">rdoc_css</span> <span class="ruby-operator">+=</span> <span class="ruby-node">&quot;\n table{ border: 1px dashed #D3D3D3; line-height: 30px; margin-top: 10px; border-collapse: collapse; }&quot;</span>
+<span class="ruby-identifier">rdoc_css</span> <span class="ruby-operator">+=</span> <span class="ruby-node">&quot;\n td{ padding-left:20px; padding-right:20px; border-top: 1px solid #E4E4E4; }&quot;</span>
+<span class="ruby-identifier">rdoc_css</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&quot;\n th{ padding-left:20px; padding-right:20px; text-align:left; }&quot;</span>
+<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-string">'doc/rdoc.css'</span>, <span class="ruby-string">'w+'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">rdoc_css</span>) }
+
+<span class="ruby-comment"># Clean up the rdoc file</span>
+<span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-string">&quot;README.rdoc&quot;</span>)
+<span class="ruby-value">%xopen doc/index.html`</span>
+</pre>
+
+<p>end</p>
+
+<p>desc “Start Thin RDoc Testserver” task :server do</p>
+
+<pre class="ruby"><span class="ruby-identifier">load</span> <span class="ruby-string">&quot;spec/lib/test_web_server.rb&quot;</span>
+<span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Handler</span><span class="ruby-operator">::</span><span class="ruby-constant">Thin</span>.<span class="ruby-identifier">run</span> <span class="ruby-constant">Sinatra</span><span class="ruby-operator">::</span><span class="ruby-constant">Application</span>, :<span class="ruby-constant">Port</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">3001</span>
 </pre>
 
 <p>end</p>

data/doc/created.rid

@@ -1,40 +1,46 @@
-Fri, 13 Apr 2012 00:06:48 +0200
-./bin/bigbench	Wed, 11 Apr 2012 22:00:15 +0200
-./dev/net_http.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./dev/test.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./dev/tracking.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./Gemfile	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/benchmark/looper.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/benchmark.rb	Thu, 12 Apr 2012 13:50:50 +0200
-./lib/bigbench/bot.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/configuration.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/executor.rb	Thu, 12 Apr 2012 14:38:40 +0200
-./lib/bigbench/float_extensions.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/fragment.rb	Thu, 12 Apr 2012 17:20:03 +0200
-./lib/bigbench/help/executor.txt	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/initializers.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/output.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/post_processor/statistics.rb	Thu, 12 Apr 2012 22:50:26 +0200
-./lib/bigbench/post_processor.rb	Thu, 12 Apr 2012 23:13:41 +0200
-./lib/bigbench/runner.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/store.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/tracker.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./lib/bigbench/version.rb	Thu, 12 Apr 2012 13:17:27 +0200
-./lib/bigbench.rb	Thu, 12 Apr 2012 21:28:21 +0200
-./Rakefile	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/benchmark_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/bot_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/configure_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/executor_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/fragment_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/helpers.rb	Thu, 12 Apr 2012 15:12:44 +0200
-./spec/lib/test_web_server.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/looper_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/post_processor_spec.rb	Thu, 12 Apr 2012 16:01:49 +0200
-./spec/post_processors/statistics_spec.rb	Thu, 12 Apr 2012 21:36:43 +0200
-./spec/runner_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/store_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/tests/local.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/tests/local_invalid.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/tracker_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
-./spec/webserver_spec.rb	Wed, 11 Apr 2012 22:00:15 +0200
+Sat, 28 Apr 2012 16:48:35 +0200
+./bin/bigbench	Sat, 21 Apr 2012 16:57:55 +0200
+./dev/net_http.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./dev/test.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./dev/tracking.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./Gemfile	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/benchmark/looper.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/benchmark.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/bot.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/configuration.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/executor.rb	Sat, 28 Apr 2012 16:14:18 +0200
+./lib/bigbench/float_extensions.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/fragment.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/help/executor.txt	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/initializers.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/output.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/post_processor/environment.rb	Sat, 28 Apr 2012 15:52:51 +0200
+./lib/bigbench/post_processor/graphs.rb	Fri, 27 Apr 2012 04:13:00 +0200
+./lib/bigbench/post_processor/statistics.rb	Fri, 27 Apr 2012 05:58:34 +0200
+./lib/bigbench/post_processor.rb	Sat, 28 Apr 2012 16:35:04 +0200
+./lib/bigbench/runner.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/store.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/tracker.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench/version.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./lib/bigbench.rb	Sat, 28 Apr 2012 16:04:25 +0200
+./Rakefile	Sat, 28 Apr 2012 16:43:58 +0200
+./README.rdoc	Sat, 28 Apr 2012 16:48:35 +0200
+./spec/benchmark_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/bot_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/configure_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/executor_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/fragment_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/helpers.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/lib/test_web_server.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/looper_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/post_processor_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/post_processors/environment_spec.rb	Sat, 28 Apr 2012 16:04:45 +0200
+./spec/post_processors/graphs_spec.rb	Fri, 27 Apr 2012 05:06:24 +0200
+./spec/post_processors/statistics_spec.rb	Fri, 27 Apr 2012 05:59:02 +0200
+./spec/runner_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/store_spec.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/tests/local.rb	Fri, 27 Apr 2012 04:21:33 +0200
+./spec/tests/local_invalid.rb	Sat, 21 Apr 2012 16:57:55 +0200
+./spec/tests/with_post_processor.rb	Fri, 27 Apr 2012 06:03:27 +0200
+./spec/tracker_spec.rb	Fri, 27 Apr 2012 04:23:22 +0200
+./spec/webserver_spec.rb	Sat, 21 Apr 2012 16:57:56 +0200

data/doc/index.html

@@ -51,6 +51,8 @@
   
     <li class="file"><a href="./Gemfile.html">Gemfile</a>
   
+    <li class="file"><a href="./README_rdoc.html">README</a>
+  
     <li class="file"><a href="./Rakefile.html">Rakefile</a>
   
     <li class="file"><a href="./lib/bigbench/help/executor_txt.html">executor</a>
@@ -93,6 +95,26 @@
   
     <li><a href="./BigBench/PostProcessor/Environment.html">BigBench::PostProcessor::Environment</a>
   
+    <li><a href="./BigBench/PostProcessor/Environment/Appearings.html">BigBench::PostProcessor::Environment::Appearings</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/AttributeCluster.html">BigBench::PostProcessor::Environment::AttributeCluster</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/BenchmarkNotFound.html">BigBench::PostProcessor::Environment::BenchmarkNotFound</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/Cluster.html">BigBench::PostProcessor::Environment::Cluster</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/NormalDistribution.html">BigBench::PostProcessor::Environment::NormalDistribution</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/PolynomialRegression.html">BigBench::PostProcessor::Environment::PolynomialRegression</a>
+  
+    <li><a href="./BigBench/PostProcessor/Environment/Statistics.html">BigBench::PostProcessor::Environment::Statistics</a>
+  
+    <li><a href="./BigBench/PostProcessor/Graphs.html">BigBench::PostProcessor::Graphs</a>
+  
+    <li><a href="./BigBench/PostProcessor/Graphs/LineGraph.html">BigBench::PostProcessor::Graphs::LineGraph</a>
+  
+    <li><a href="./BigBench/PostProcessor/Graphs/PieGraph.html">BigBench::PostProcessor::Graphs::PieGraph</a>
+  
     <li><a href="./BigBench/PostProcessor/InvalidProcessor.html">BigBench::PostProcessor::InvalidProcessor</a>
   
     <li><a href="./BigBench/PostProcessor/Processor.html">BigBench::PostProcessor::Processor</a>
@@ -111,6 +133,8 @@
   
     <li><a href="./BigBench/Tracker/Tracker.html">BigBench::Tracker::Tracker</a>
   
+    <li><a href="./Array.html">Array</a>
+  
     <li><a href="./EventMachineLoop.html">EventMachineLoop</a>
   
     <li><a href="./Float.html">Float</a>
@@ -125,7 +149,649 @@
   </div>
 </nav>
 
-<p>This is the API documentation for RDoc Documentation.
+<div id="documentation" class="description">
+  
+<h1 id="label-BigBench"><a href="BigBench.html">BigBench</a></h1>
+
+<p><a href="BigBench.html">BigBench</a> is a http penetration tool. It allows
+you to test the performance of any web server with very high loads. It:</p>
+<ul><li>
+<p>Is a fancy ruby solution for local and remote load benchmarking</p>
+</li><li>
+<p>Creates about 16% more load then Apache’s JMeter</p>
+</li><li>
+<p>Has an own very easy to use DSL</p>
+</li><li>
+<p>Makes remote testing a breeze with bots</p>
+</li><li>
+<p>Offers an awesome post processor environment to analyze your benchmarks
+that includes <code>tracking iteration</code>, <code>polynomial
+regressions</code>, <code>normal distributions</code>,</p>
+</li><li>
+<p>Offers the ability to hook in and execute any code after the benchmarks are
+finished</p>
+</li><li>
+<p>Comes with included post processors that create statistics and graphs</p>
+</li><li>
+<p>Is very easy to extend!</p>
+</li></ul>
+
+<h3 id="label-Installation">Installation</h3>
+
+<pre>gem install bigbench</pre>
+
+<h3 id="label-Further+Reading">Further Reading</h3>
+<ul><li>
+<p><a href="http://southdesign.github.com/bigbench">BigBench RDoc</a></p>
+</li></ul>
+
+<h3 id="label-Requirements">Requirements</h3>
+<ul><li>
+<p>Ruby 1.9+</p>
+</li><li>
+<p>Redisonly if you’re testing with multiple hosts</p>
+</li></ul>
+
+<h2 id="label-Test+Receipts">Test Receipts</h2>
+
+<p>How do the test receipts look like? As easy as possible. For example like
+this in <code>example.rb</code>:</p>
+
+<pre class="ruby"><span class="ruby-identifier">configure</span> =<span class="ruby-operator">></span> {
+    :<span class="ruby-identifier">duration</span>   =<span class="ruby-operator">></span> <span class="ruby-value">2</span>.<span class="ruby-identifier">minutes</span>,
+    :<span class="ruby-identifier">output</span>     =<span class="ruby-operator">></span> <span class="ruby-string">&quot;example.ljson&quot;</span>,
+    :<span class="ruby-identifier">users</span>      =<span class="ruby-operator">></span> <span class="ruby-value">5</span>,
+    :<span class="ruby-identifier">basic_auth</span> =<span class="ruby-operator">></span> [<span class="ruby-string">'username'</span>, <span class="ruby-string">'password'</span>]
+}
+
+<span class="ruby-identifier">benchmark</span> <span class="ruby-string">&quot;default website pages&quot;</span> =<span class="ruby-operator">></span> <span class="ruby-string">&quot;http://localhost:3000&quot;</span> <span class="ruby-keyword">do</span>
+    <span class="ruby-identifier">get</span> <span class="ruby-string">&quot;/&quot;</span>
+    <span class="ruby-identifier">get</span> <span class="ruby-string">&quot;/blog&quot;</span>
+    <span class="ruby-identifier">get</span> <span class="ruby-string">&quot;/imprint&quot;</span>
+    <span class="ruby-identifier">get</span> <span class="ruby-string">&quot;/admin&quot;</span>, :<span class="ruby-identifier">basic_auth</span> =<span class="ruby-operator">></span> [<span class="ruby-string">'username'</span>, <span class="ruby-string">'password'</span>]
+<span class="ruby-keyword">end</span>
+
+<span class="ruby-identifier">benchmark</span> <span class="ruby-string">&quot;login and logout&quot;</span> =<span class="ruby-operator">></span> <span class="ruby-string">&quot;http://localhost:3000&quot;</span> <span class="ruby-keyword">do</span>
+    <span class="ruby-identifier">post</span> <span class="ruby-string">&quot;/login&quot;</span>,  :<span class="ruby-identifier">params</span> =<span class="ruby-operator">></span> { :<span class="ruby-identifier">name</span> =<span class="ruby-operator">></span> <span class="ruby-string">&quot;test@user.com&quot;</span>, :<span class="ruby-identifier">password</span> =<span class="ruby-operator">></span> <span class="ruby-string">&quot;secret&quot;</span> }
+    <span class="ruby-identifier">post</span> <span class="ruby-string">&quot;/logout&quot;</span>, :<span class="ruby-identifier">params</span> =<span class="ruby-operator">></span> { :<span class="ruby-identifier">name</span> =<span class="ruby-operator">></span> <span class="ruby-string">&quot;test@user.com&quot;</span> }
+<span class="ruby-keyword">end</span>
+
+<span class="ruby-identifier">post_process</span> :<span class="ruby-identifier">statistics</span>
+</pre>
+
+<h2 id="label-Single+Host+vs.+Multiple+Hosts+Testing">Single Host vs. Multiple Hosts Testing</h2>
+
+<p>You can either test with a single machine right from your local host, or
+with multiple machines using bots. No matter what, the test receipt will
+stay the same.</p>
+
+<h3 id="label-Single+Host">Single Host</h3>
+
+<p><a href="BigBench.html">BigBench</a> allows you to run your tests against
+every host from your local machine. The command for this looks like this:</p>
+
+<pre>bigbench run local example.rb</pre>
+
+<h3 id="label-Multiple+Hosts+with+Bots">Multiple Hosts with Bots</h3>
+
+<p><a href="BigBench.html">BigBench</a> uses a bot design pattern which means
+you can run your tests from multiple hosts. Everything you need for this is
+a redis that is reachable from all testing hosts. Every host simply starts
+a bot that is checking for a new test receipt every minute like this:</p>
+
+<pre>bigbench start bot redis_url:port redis_password</pre>
+
+<p>Then to run the tests from all hosts simply use the same receipt as you
+would use for a local run and call it like this:</p>
+
+<pre>bigbench run bots example.rb redis_url:port redis_password</pre>
+
+<p>This will upload the test receipt to all bots and make them run it. Every
+bot reports its results back to the redis and the local machine then
+combines, and writes them to the output file. So you test with the same
+receipts and get the same results, no matter if your testing from the local
+host or with multiple bots.</p>
+
+<p><img src="http://southdesign.github.com/bigbench/images/structure.png" /></p>
+
+<h2 id="label-Output">Output</h2>
+
+<p>How does the recorded output look like? It’s in the <code>*.ljson</code>
+format which is nothing else but a textfile with a complete JSON object on
+every line. It looks like this:</p>
+
+<pre>{&quot;elapsed&quot;:0.002233,&quot;start&quot;:1333981203.542233,&quot;stop&quot;:1333981203.54279,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.00331,&quot;start&quot;:1333981203.5434968,&quot;stop&quot;:1333981203.5438669,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.004248,&quot;start&quot;:1333981203.544449,&quot;stop&quot;:1333981203.544805,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.00521,&quot;start&quot;:1333981203.545397,&quot;stop&quot;:1333981203.5457668,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.00615,&quot;start&quot;:1333981203.546355,&quot;stop&quot;:1333981203.546707,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.007127,&quot;start&quot;:1333981203.547328,&quot;stop&quot;:1333981203.5476842,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.008024,&quot;start&quot;:1333981203.548226,&quot;stop&quot;:1333981203.5485811,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.008904,&quot;start&quot;:1333981203.549105,&quot;stop&quot;:1333981203.549461,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.009803,&quot;start&quot;:1333981203.550003,&quot;stop&quot;:1333981203.55036,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.010678,&quot;start&quot;:1333981203.550882,&quot;stop&quot;:1333981203.551235,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.011549,&quot;start&quot;:1333981203.5517519,&quot;stop&quot;:1333981203.552106,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.012417,&quot;start&quot;:1333981203.5526242,&quot;stop&quot;:1333981203.552974,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.013294,&quot;start&quot;:1333981203.553495,&quot;stop&quot;:1333981203.553851,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.014166,&quot;start&quot;:1333981203.5543702,&quot;stop&quot;:1333981203.554723,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.015043,&quot;start&quot;:1333981203.555247,&quot;stop&quot;:1333981203.5556,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+{&quot;elapsed&quot;:0.01592,&quot;start&quot;:1333981203.556119,&quot;stop&quot;:1333981203.5564768,&quot;duration&quot;:0,&quot;benchmark&quot;:&quot;index page&quot;,&quot;url&quot;:&quot;http://localhost:3000/&quot;,&quot;path&quot;:&quot;/&quot;,&quot;method&quot;:&quot;get&quot;,&quot;status&quot;:&quot;200&quot;}
+...</pre>
+
+<p>The advantage with this file format is, that it can be parsed and computed
+very efficiently because the JSON parser doesn’t have to parse a whole JSON
+array with with loads of objects but simply one objectline by line.</p>
+
+<h2 id="label-Post+Processors">Post Processors</h2>
+
+<p>After the benchmark has finished you can create hooks and write plugins
+that do something with the collected data. To setup a hook simply use the
+<code>post_process</code> method to add a block or run a predefined plugin:</p>
+
+<pre class="ruby"><span class="ruby-comment"># Run BigBench::PostProcessor::Statistics</span>
+<span class="ruby-identifier">post_process</span> :<span class="ruby-identifier">statistics</span>
+
+<span class="ruby-comment"># Run a block that could do anything</span>
+<span class="ruby-identifier">post_process</span> <span class="ruby-keyword">do</span>
+
+    <span class="ruby-identifier">total_trackings</span>, <span class="ruby-identifier">total_errors</span> = <span class="ruby-value">0</span>, <span class="ruby-value">0</span>                
+    <span class="ruby-identifier">each_tracking</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">tracking</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">total_trackings</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+        <span class="ruby-identifier">total_errors</span>    <span class="ruby-operator">+=</span> <span class="ruby-value">1</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">tracking</span>[:<span class="ruby-identifier">status</span>] <span class="ruby-operator">==</span> <span class="ruby-value">200</span>
+    <span class="ruby-keyword">end</span>
+
+    <span class="ruby-constant">Twitter</span>.<span class="ruby-identifier">post</span> <span class="ruby-node">&quot;Just run BigBench with #{total_trackings} trackings and #{total_errors} errors.&quot;</span>
+
+<span class="ruby-keyword">end</span>
+</pre>
+
+<p>It’s very easy to write a post processor. The basic structure is like this:</p>
+
+<pre class="ruby"><span class="ruby-keyword">module</span> <span class="ruby-constant">BigBench</span>
+    <span class="ruby-keyword">module</span> <span class="ruby-constant">PostProcessor</span>
+        <span class="ruby-keyword">module</span> <span class="ruby-constant">SamplePostProcessor</span>
+
+            <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">run!</span>(<span class="ruby-identifier">options</span>)
+                <span class="ruby-comment"># Do whatever you want here</span>
+            <span class="ruby-keyword">end</span>
+
+        <span class="ruby-keyword">end</span>
+    <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span>
+</pre>
+
+<p>You can hook it in with:</p>
+
+<pre>post_process :sample_post_processor
+# or
+post_process BigBench::PostProcessor::SamplePostProcessor</pre>
+
+<h3 id="label-Post+Processor+Environment">Post Processor Environment</h3>
+
+<p>Post processors by default offer a great load of functionality that helps
+to evaluate the benchmarks. The available methods are:</p>
+
+<h4 id="label-each_tracking">each_tracking</h4>
+
+<p>Iterate over each of the tracking elements. The trackings are read
+line-by-line. This is the fastest approach and should be used for huge
+datasets because the trackings are not loaded completely into memory.</p>
+
+<pre class="ruby"><span class="ruby-identifier">total_trackings</span>, <span class="ruby-identifier">total_errors</span> = <span class="ruby-value">0</span>, <span class="ruby-value">0</span>                
+<span class="ruby-identifier">each_tracking</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">tracking</span><span class="ruby-operator">|</span>
+    <span class="ruby-identifier">total_trackings</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+    <span class="ruby-identifier">total_errors</span>    <span class="ruby-operator">+=</span> <span class="ruby-value">1</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">tracking</span>[:<span class="ruby-identifier">status</span>] <span class="ruby-operator">==</span> <span class="ruby-value">200</span>
+<span class="ruby-keyword">end</span>
+</pre>
+
+<h4 id="label-trackings">trackings</h4>
+
+<p>An array with all tracking hashes in it. The creation might take some time
+at the first usage, afterwards the array is cached automatically.</p>
+
+<pre class="ruby"><span class="ruby-identifier">trackings</span>.<span class="ruby-identifier">size</span> <span class="ruby-comment"># => 650456</span>
+<span class="ruby-identifier">trackings</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">tracking</span><span class="ruby-operator">|</span>
+    <span class="ruby-identifier">puts</span> <span class="ruby-identifier">tracking</span>[:<span class="ruby-identifier">duration</span>]
+<span class="ruby-keyword">end</span>
+</pre>
+
+<h4 id="label-statistics">statistics</h4>
+
+<p>Computes the default statistics for any attribute</p>
+
+<pre class="ruby"><span class="ruby-comment"># Unclustered statistics</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">max</span>                    <span class="ruby-comment"># => 78.2</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">min</span>                    <span class="ruby-comment"># => 12.3</span>
+
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">mean</span>                   <span class="ruby-comment"># => 45.2</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">average</span>                <span class="ruby-comment"># => 45.2</span>
+
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">standard_deviation</span>     <span class="ruby-comment"># => 11.3</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">sd</span>                     <span class="ruby-comment"># => 11.3</span>
+
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">squared_deviation</span>      <span class="ruby-comment"># => 60.7</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">variance</span>               <span class="ruby-comment"># => 60.7</span>
+
+<span class="ruby-comment"># Time clustered statistics - 1.second</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">max</span>                     <span class="ruby-comment"># => 42.1</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">min</span>                     <span class="ruby-comment"># => 12.3</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">max</span>                <span class="ruby-comment"># => 42.1</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">average</span>            <span class="ruby-comment"># => 33.1</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">benchmark</span>(<span class="ruby-string">&quot;index page&quot;</span>).<span class="ruby-identifier">average</span>  <span class="ruby-comment"># => 32.9</span>
+<span class="ruby-identifier">statistics</span>.<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">average</span>               <span class="ruby-comment"># => 12.5</span>
+</pre>
+
+<h4 id="label-cluster">cluster</h4>
+
+<p>Clusters the resulting trackings by a timebase. The default timebase is
+<code>1.second</code> which means, that it groups all trackings to full
+seconds and calculates the amount of requests and the average duration.</p>
+
+<pre class="ruby"><span class="ruby-comment"># Duration is 120 seconds for this example</span>
+
+<span class="ruby-comment"># 1.second</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">timesteps</span>                       <span class="ruby-comment"># => [1, 2, ..., 120]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">durations</span>                       <span class="ruby-comment"># => [43, 96, ..., 41]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">requests</span>                        <span class="ruby-comment"># => [503, 541, ..., 511]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>)                   <span class="ruby-comment"># => [200, 204, ..., 209]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">post</span>)                  <span class="ruby-comment"># => [201, 102, ..., 401]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>)                   <span class="ruby-comment"># => [501, 502, ..., 102]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">404</span>)                   <span class="ruby-comment"># => [3, 1, ..., 0]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>)                      <span class="ruby-comment"># => [401, 482, ..., 271]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/logout&quot;</span>)                <span class="ruby-comment"># => [56, 51, ..., 38]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">benchmark</span>(<span class="ruby-string">&quot;index&quot;</span>)              <span class="ruby-comment"># => [342, 531, ..., 234]</span>
+<span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">benchmark</span>(<span class="ruby-string">&quot;user&quot;</span>)               <span class="ruby-comment"># => [22, 41, ..., 556]</span>
+
+<span class="ruby-comment"># 1.minute</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">timesteps</span>             <span class="ruby-comment"># => [0, 1]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">durations</span>             <span class="ruby-comment"># => [42, 44]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">requests</span>              <span class="ruby-comment"># => [24032, 21893]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>)         <span class="ruby-comment"># => [200, 204]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>)         <span class="ruby-comment"># => [501, 502]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>)            <span class="ruby-comment"># => [401, 482]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">benchmark</span>(<span class="ruby-string">&quot;user&quot;</span>)     <span class="ruby-comment"># => [22, 41]</span>
+
+<span class="ruby-comment"># 30.seconds</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">30</span>.<span class="ruby-identifier">seconds</span>).<span class="ruby-identifier">timesteps</span>           <span class="ruby-comment"># => [0, 1, 2, 3]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">30</span>.<span class="ruby-identifier">seconds</span>).<span class="ruby-identifier">durations</span>           <span class="ruby-comment"># => [42, 44, 41, 40]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">30</span>.<span class="ruby-identifier">seconds</span>).<span class="ruby-identifier">requests</span>            <span class="ruby-comment"># => [11023, 10234, 12345, 13789]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">30</span>.<span class="ruby-identifier">seconds</span>).<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>)       <span class="ruby-comment"># => [200, 204, 34, 124]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">30</span>.<span class="ruby-identifier">seconds</span>).<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>)       <span class="ruby-comment"># => [501, 502, 243, 57]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">30</span>.<span class="ruby-identifier">seconds</span>).<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>)          <span class="ruby-comment"># => [401, 482, 124, 234]</span>
+<span class="ruby-identifier">cluster</span>(<span class="ruby-value">30</span>.<span class="ruby-identifier">seconds</span>).<span class="ruby-identifier">benchmark</span>(<span class="ruby-string">&quot;user&quot;</span>)   <span class="ruby-comment"># => [22, 41, 12, 51]</span>
+</pre>
+
+<h4 id="label-appearing">appearing</h4>
+
+<p>Lists the unique attribute values that appeared in all trackings or the
+selected tracking scope.</p>
+
+<pre class="ruby"><span class="ruby-identifier">appearing</span>.<span class="ruby-identifier">statuses</span>  <span class="ruby-comment"># => [200, 404]</span>
+<span class="ruby-identifier">appearing</span>.<span class="ruby-identifier">methods</span>   <span class="ruby-comment"># => [&quot;get&quot;, &quot;post&quot;]</span>
+<span class="ruby-identifier">appearing</span>.<span class="ruby-identifier">paths</span>     <span class="ruby-comment"># => [&quot;/&quot;, &quot;/basic/auth&quot;</span>
+</pre>
+
+<h4 id="label-polynomial_regression">polynomial_regression</h4>
+
+<p>The polynomial regression creates a function that tries to map the test
+data best. With this function you have the ability do derivate and thereby
+plot the changes of the tested system over time. The degree of the
+regression can be freely chosen.</p>
+
+<pre class="ruby"><span class="ruby-comment"># Linear regression by default</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">x</span>                               <span class="ruby-comment"># => [1, 2, ..., 120]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">y</span>                               <span class="ruby-comment"># => [45, 23, ..., 36]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>                                <span class="ruby-comment"># => [43, 45, ..., 62]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>                           <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>                           <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">y</span>                              <span class="ruby-comment"># => [78, 12, ..., 63]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">benchmarks</span>(<span class="ruby-string">&quot;index page&quot;</span>).<span class="ruby-identifier">y</span>                <span class="ruby-comment"># => [12, 45, ..., 23]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">degree</span>                          <span class="ruby-comment"># => 1</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">formula</span>                         <span class="ruby-comment"># => &quot;43.00886000234 + 0.0167548964060689x^1&quot;</span>
+
+<span class="ruby-comment"># 1. Derivation</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">derivation</span>(<span class="ruby-value">1</span>)                   <span class="ruby-comment"># => [0.01, 0.01, ..., 0.01]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">derivation</span>(<span class="ruby-value">1</span>)                    <span class="ruby-comment"># => [405, 405, ..., 406]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">derivation</span>(<span class="ruby-value">1</span>)               <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">derivation</span>(<span class="ruby-value">1</span>)               <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">derivation</span>(<span class="ruby-value">1</span>)                  <span class="ruby-comment"># => [78, 12, ..., 63]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">benchmarks</span>(<span class="ruby-string">&quot;index page&quot;</span>).<span class="ruby-identifier">derivation</span>(<span class="ruby-value">1</span>)    <span class="ruby-comment"># => [12, 45, ..., 23]</span>
+<span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">formula</span>(<span class="ruby-value">1</span>)                      <span class="ruby-comment"># => &quot;0.0167548964060689&quot;</span>
+
+<span class="ruby-comment"># Quadratic regression</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">x</span>                  <span class="ruby-comment"># => [1, 2, ..., 120]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">y</span>                 <span class="ruby-comment"># => [43, 41, ..., 44]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>                  <span class="ruby-comment"># => [43, 41, ..., 44]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>             <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>             <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">y</span>                <span class="ruby-comment"># => [78, 12, ..., 63]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">benchmarks</span>(<span class="ruby-string">&quot;index page&quot;</span>).<span class="ruby-identifier">y</span>  <span class="ruby-comment"># => [12, 45, ..., 23]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>).<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">formula</span>            <span class="ruby-comment"># => &quot;33.00886000234 + 0.0167548964060689x^1 + 0.0167548964060689x^2&quot;</span>
+
+<span class="ruby-comment"># Different timebase clustering</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">x</span>                   <span class="ruby-comment"># => [0, 1]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>                   <span class="ruby-comment"># => [24032, 21893]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">y</span>                  <span class="ruby-comment"># => [43, 41]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>                   <span class="ruby-comment"># => [43, 41]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>              <span class="ruby-comment"># => [23, 62]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>              <span class="ruby-comment"># => [51, 22]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">y</span>                 <span class="ruby-comment"># => [78, 12]</span>
+<span class="ruby-identifier">polynomial_regression</span>(:<span class="ruby-identifier">degree</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, :<span class="ruby-identifier">timebase</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">benchmarks</span>(<span class="ruby-string">&quot;index page&quot;</span>).<span class="ruby-identifier">y</span>   <span class="ruby-comment"># => [12, 45]</span>
+</pre>
+
+<h4 id="label-normal_distribution">normal_distribution</h4>
+
+<p>The normal distribution method creates a Gaussian bell function that
+visualizes the distribution of a special attribute. If you want to know if
+all your requests take about the same time, or if they vary a lot this is
+method to use. The x-values are automatically scaled to 4-times the
+variance around the mean, so it should map the whole bell all the time.</p>
+
+<pre class="ruby"><span class="ruby-comment"># Normal distribution without time clustering</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">x</span>                               <span class="ruby-comment"># => [1, 2, ..., 120]</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">y</span>                               <span class="ruby-comment"># => [45, 23, ..., 36]</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">formula</span>                         <span class="ruby-comment"># => &quot;(1 / (10.242257627240862 * sqrt(2*PI))) * exp(-1 * ((x - 2.04671984377919)^2) / (2*10.242257627240862))&quot;</span>
+
+<span class="ruby-comment"># Normal distribution with default time slicing of 1.second</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>                                <span class="ruby-comment"># => [43, 45, ..., 62]</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>                           <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>                           <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">y</span>                              <span class="ruby-comment"># => [78, 12, ..., 63]</span>
+<span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">benchmarks</span>(<span class="ruby-string">&quot;index page&quot;</span>).<span class="ruby-identifier">y</span>                <span class="ruby-comment"># => [12, 45, ..., 23]</span>
+
+<span class="ruby-comment"># Normal distribution with custom time slicing</span>
+<span class="ruby-identifier">normal_distribution</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>                      <span class="ruby-comment"># => [43, 45, ..., 62]</span>
+<span class="ruby-identifier">normal_distribution</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>                 <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+<span class="ruby-identifier">normal_distribution</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>                 <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-identifier">normal_distribution</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">paths</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">y</span>                    <span class="ruby-comment"># => [78, 12, ..., 63]</span>
+<span class="ruby-identifier">normal_distribution</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">minute</span>).<span class="ruby-identifier">benchmarks</span>(<span class="ruby-string">&quot;index page&quot;</span>).<span class="ruby-identifier">y</span>      <span class="ruby-comment"># => [12, 45, ..., 23]</span>
+</pre>
+
+<h4 id="label-scope_to_benchmark">scope_to_benchmark</h4>
+
+<p>The scope_to_benchmark method lets you scope any result to a single
+benchmark. The values computed in this block have entirely been created by
+this benchmark.</p>
+
+<pre class="ruby"><span class="ruby-comment"># Results for the index page benchmark</span>
+<span class="ruby-identifier">scope_to_benchmark</span> <span class="ruby-string">&quot;index page&quot;</span> <span class="ruby-keyword">do</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">durations</span>                       <span class="ruby-comment"># => [43, 96, ..., 41]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">requests</span>                        <span class="ruby-comment"># => [503, 541, ..., 511]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>)                   <span class="ruby-comment"># => [200, 204, ..., 209]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">post</span>)                  <span class="ruby-comment"># => [201, 102, ..., 401]</span>
+    <span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">x</span>       <span class="ruby-comment"># => [1, 2, ..., 120]</span>
+    <span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">y</span>       <span class="ruby-comment"># => [45, 23, ..., 36]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>          <span class="ruby-comment"># => [43, 45, ..., 62]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>     <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>     <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-keyword">end</span>
+
+<span class="ruby-comment"># Results for the login and logout benchmark</span>
+<span class="ruby-identifier">scope_to_benchmark</span> <span class="ruby-string">&quot;login and logout&quot;</span> <span class="ruby-keyword">do</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">durations</span>                       <span class="ruby-comment"># => [43, 96, ..., 41]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">requests</span>                        <span class="ruby-comment"># => [300, 141, ..., 511]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>)                   <span class="ruby-comment"># => [100, 204, ..., 209]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">post</span>)                  <span class="ruby-comment"># => [101, 102, ..., 401]</span>
+    <span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">x</span>       <span class="ruby-comment"># => [1, 2, ..., 120]</span>
+    <span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">y</span>       <span class="ruby-comment"># => [45, 23, ..., 36]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>          <span class="ruby-comment"># => [43, 45, ..., 62]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>     <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>     <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-keyword">end</span>
+</pre>
+
+<h4 id="label-each_benchmark">each_benchmark</h4>
+
+<p>Iterates over all benchmarks and automatically scopes the results at each
+iteration to the current benchmark. This is useful if you want to access
+the detailed differences of each benchmark.</p>
+
+<pre class="ruby"><span class="ruby-comment"># Iterate over all benchmarks and calculate the results</span>
+<span class="ruby-identifier">each_benchmark</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">benchmark</span><span class="ruby-operator">|</span>
+    <span class="ruby-identifier">benchmark</span>.<span class="ruby-identifier">name</span>                          <span class="ruby-comment"># => &quot;index page&quot; then &quot;login and logout&quot;</span>
+
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">durations</span>                       <span class="ruby-comment"># => [43, 96, ..., 41]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">requests</span>                        <span class="ruby-comment"># => [300, 141, ..., 511]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>)                   <span class="ruby-comment"># => [100, 204, ..., 209]</span>
+    <span class="ruby-identifier">cluster</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">post</span>)                  <span class="ruby-comment"># => [101, 102, ..., 401]</span>
+    <span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">x</span>       <span class="ruby-comment"># => [1, 2, ..., 120]</span>
+    <span class="ruby-identifier">polynomial_regression</span>.<span class="ruby-identifier">durations</span>.<span class="ruby-identifier">y</span>       <span class="ruby-comment"># => [45, 23, ..., 36]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">requests</span>.<span class="ruby-identifier">y</span>          <span class="ruby-comment"># => [43, 45, ..., 62]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">methods</span>(:<span class="ruby-identifier">get</span>).<span class="ruby-identifier">y</span>     <span class="ruby-comment"># => [23, 62, ..., 23]</span>
+    <span class="ruby-identifier">normal_distribution</span>.<span class="ruby-identifier">statuses</span>(<span class="ruby-value">200</span>).<span class="ruby-identifier">y</span>     <span class="ruby-comment"># => [51, 22, ..., 15]</span>
+<span class="ruby-keyword">end</span>
+</pre>
+
+<h3 id="label-Running+Post+Processors+separately">Running Post Processors separately</h3>
+
+<p>You can also re-run the currently defined post processors or run a separate
+post processor you never even defined in the first place without collecting
+the test data again like this:</p>
+
+<pre># Re-run the postprocessors defined in example.rb
+bigbench run postprocessors example.rb
+
+# Run a separate post processor independently - the already defined post processors are ignored
+bigbench run postprocessor example.rb statistics</pre>
+
+<p>Contribute, create great post processors and send me a pull request!</p>
+
+<h3 id="label-Statistics">Statistics</h3>
+
+<p>The statistics post processor computes a simple overview of the benchmark
+and prints it to the terminal like this:</p>
+
+<pre>BigBench Statistics
++---------------------------+------------------+---------+
+| Name                      | Value            | Percent |
++---------------------------+------------------+---------+
+| Total Requests:           | 52,469           | 100%    |
+| Total Errors:             | 0                | 0.0%    |
+|                           |                  |         |
+| Average Requests/Second:  | 437 Requests/sec |         |
+| Average Request Duration: | 1 ms             |         |
+|                           |                  |         |
+| Max Request Duration:     | 181 ms           |         |
+| Min Request Duration:     | 1 ms             |         |
+|                           |                  |         |
+| Status Codes:             |                  |         |
+|   200                     | 52469            | 100.0%  |
+|                           |                  |         |
+| HTTP Methods              |                  |         |
+|   get                     | 34980            | 66.7%   |
+|   post                    | 17489            | 33.3%   |
+|                           |                  |         |
+| URL Paths:                |                  |         |
+|   /                       | 34979            | 66.7%   |
+|   /basic/auth             | 17490            | 33.3%   |
++---------------------------+------------------+---------+
+19 rows in set</pre>
+
+<h2 id="label-Load+Comparison">Load Comparison</h2>
+
+<p><a href="BigBench.html">BigBench</a> is awfully good at creating high loads
+on web servers. A quick benchmark comparison to <a
+href="http://jmeter.apache.org/">Apache's JMeter</a> shows that <a
+href="BigBench.html">BigBench</a> is able to create 16% more load than
+JMeter.</p>
+
+<h3 id="label-Test+Configuration%3A+Apache%27s+JMeter+vs.+BigBench">Test Configuration: Apache’s JMeter vs. <a href="BigBench.html">BigBench</a></h3>
+
+<table>
+
+<tr>
+        <th>Parameter           </th>
+        <th>Value                               </th>
+</tr>
+<tr>
+        <td> Test Duration         </td>
+        <td> 2 Minutes                             </td>
+</tr>
+<tr>
+        <td> Concurrency(Threads)  </td>
+        <td> 20                                    </td>
+</tr>
+<tr>
+        <td> Rack Server           </td>
+        <td> Thin                                  </td>
+</tr>
+<tr>
+        <td> Rack Host             </td>
+        <td> localhost                             </td>
+</tr>
+<tr>
+        <td> Rack Request          </td>
+        <td> GET: 200, Body: Test                </td>
+</tr>
+<tr>
+        <td> Ruby Version          </td>
+        <td> ruby 1.9.3p125 [x86_64-darwin11.3.0]  </td>
+</tr>
+<tr>
+        <td> JMeter Version        </td>
+        <td> 2.6 r1237317                          </td>
+</tr>
+<tr>
+        <td> BigBench Version      </td>
+        <td> 0.2                                   </td>
+</tr>
+
+</table>
+
+<h3 id="label-Test+Results">Test Results</h3>
+
+<table>
+
+<tr>
+        <th>Value               </th>
+        <th>JMeter          </th>
+        <th>BigBench        </th>
+</tr>
+<tr>
+        <td> Total Requests        </td>
+        <td> 48.014            </td>
+        <td> 55.484            </td>
+</tr>
+<tr>
+        <td> Requests/sec          </td>
+        <td> 377               </td>
+        <td> 462               </td>
+</tr>
+<tr>
+        <td> Percentages           </td>
+        <td> 100%%             </td>
+        <td> 116%              </td>
+</tr>
+
+</table>
+
+<h2 id="label-Version+History">Version History</h2>
+
+<h3 id="label-0.4">0.4</h3>
+<ul><li>
+<p>Added command line tool to run the post processors again</p>
+</li><li>
+<p>Added command line tool to run any post processor on already collected data</p>
+</li><li>
+<p>Pimped the post processor environment. Available functions now include:</p>
+</li><li>
+<p>trackings array is now available with all hashes of the trackings at once</p>
+</li><li>
+<p><strong>Clustering by any timebase</strong>, e.g. <code>1.second</code>,
+<code>20.seconds</code>, or <code>2.minutes</code> which automatically
+calculates these values per time slice:</p>
+</li><li><ul><li>
+<p><code>average duration</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>requests</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>methods(:get, :post, :put, ...)</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>statuses(200, 404, 403, ...)</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>paths(&quot;/&quot;, &quot;/logout&quot;, &quot;/login&quot;,
+...)</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>benchmarks(&quot;index page&quot;, &quot;user behavior&quot;,
+&quot;bot crawling&quot;, ...)</code></p>
+</li></ul>
+</li><li>
+<p><strong>Polynomial Regression of any Degree</strong> for all attributes
+including the derivatives and a formula printer</p>
+</li><li>
+<p><strong>Statistics</strong> with the following values for all attributes:</p>
+</li><li><ul><li>
+<p><code>max</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>min</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>mean</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>standard_deviation</code></p>
+</li></ul>
+</li><li><ul><li>
+<p><code>squared_deviation</code> or <code>variance</code></p>
+</li></ul>
+</li><li>
+<p><strong>Gaussian Normal Distribution</strong> for all attributes including
+a <strong>formula printer</strong></p>
+</li><li>
+<p><strong>Appearing</strong> method to quickly list all appearing
+<code>statuses</code>, <code>methods</code>, <code>paths</code> in the test
+results</p>
+</li></ul>
+
+<h3 id="label-0.3">0.3</h3>
+<ul><li>
+<p>Added post processors hook that run after the benchmark with a simple
+plugin structure</p>
+</li><li>
+<p>Added a first basic post processor that computes the benchmark statistics
+and prints them in the terminal</p>
+</li><li>
+<p>Added ability to execute a block of code after running the benchmark. The
+code can do anything usefully like send emails, post twitter notifications
+or startup new servers</p>
+</li></ul>
+
+<h3 id="label-0.2">0.2</h3>
+<ul><li>
+<p><code>Net::HTTP</code> was too slow. Only reached 35% of Apache's JMeter
+load. Changed requesting structure to <a
+href="https://github.com/eventmachine/eventmachine">eventmachine</a> using
+<a href="https://github.com/igrigorik/em-http-request">em-http-request</a></p>
+</li><li>
+<p>Compared to JMeter it can create 16% <strong>more</strong> load than JMeter
+now</p>
+</li><li>
+<p>Changed config option from <code>threads</code> to <code>users</code> due
+to a better understanding</p>
+</li><li>
+<p>Added basic auth support</p>
+</li><li>
+<p>Added params hashes for request content</p>
+</li></ul>
+
+<h3 id="label-0.1">0.1</h3>
+<ul><li>
+<p>Initial Version using <code>Net::HTTP</code></p>
+</li><li>
+<p>Local and bot testing</p>
+</li><li>
+<p>LJSON output</p>
+</li><li>
+<p>Global configuration</p>
+</li></ul>
+
+</div>
 
 
 <footer id="validator-badges">