kcassell 2003/02/06 07:14:24
Modified: xdocs/usermanual component_reference.xml
Log:
Added material about CSV output.
Revision Changes Path
1.33 +59 -30 jakarta-jmeter/xdocs/usermanual/component_reference.xml
Index: component_reference.xml
===================================================================
RCS file: /home/cvs/jakarta-jmeter/xdocs/usermanual/component_reference.xml,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- component_reference.xml 1 Feb 2003 14:41:11 -0000 1.32
+++ component_reference.xml 6 Feb 2003 15:14:24 -0000 1.33
@@ -381,7 +381,8 @@
<p>
The saving and reading of test results is generic. The various
listeners generally have a panel whereby one can specify the file to
-which the results will be written (or read). The results are stored as XML
+which the results will be written (or read). By default,
+the results are stored as XML
files, typically with a ".jtl" extension.</p>
<p>
The information to be saved is configurable. If one specifies the
@@ -393,37 +394,61 @@
<p>
One can get a more selective set of information my modifying the
jmeter.properties file. The following example indicates how to set
-these.</p>
+properties to get a vertical bar ("|") delimited format that will
+output results like:.</p>
<p>
<code>
<pre>
-#---------------------------------------------------------------------------
-# Results file configuration
-#---------------------------------------------------------------------------
-
-# This section helps determine how result data will be saved.
-# The commented out values are the defaults.
-
-# legitimate values: xml, csv, db. Only xml is currently supported.
-#jmeter.save.saveservice.output_format=xml
-
-# true when field should be saved; false otherwise
-
-jmeter.save.saveservice.data_type=false
-jmeter.save.saveservice.label=true
-jmeter.save.saveservice.response_code=false
-jmeter.save.saveservice.response_data=false
-jmeter.save.saveservice.response_message=false
-jmeter.save.saveservice.successful=true
-jmeter.save.saveservice.thread_name=false
-jmeter.save.saveservice.time=false
-
-# legitimate values: none, ms, or a format suitable for SimpleDateFormat
-#jmeter.save.saveservice.timestamp_format=ms
-jmeter.save.saveservice.timestamp_format=MM/dd/yy HH:mm:ss
-
-# legitimate values: none, first, all
-jmeter.save.saveservice.assertion_results=first
+ timeStamp|time|label|responseCode|threadName|dataType|success|failureMessage
+ 02/06/03 08:21:42|1187|Backoffice Home|200|Thread Group-1|text|true|
+ 02/06/03 08:21:42|47|Login BO|200|Thread Group-1|text|false|Test Failed,
expected to contain: password
+ etc.
+</pre>
+</code></p>
+<p>
+The corresponding jmeter.properties file excerpt is below. One oddity
+in this example is that the output_format is set to csv, which
+typically
+indicates comma-separated values. However, the default_delimiter was
+set to be a vertical bar instead of a comma, so the csv tag is a
+misnomer in this case.</p>
+<p>
+<code>
+<pre>
+ #---------------------------------------------------------------------------
+ # Results file configuration
+ #---------------------------------------------------------------------------
+
+ # This section helps determine how result data will be saved.
+ # The commented out values are the defaults.
+
+ # legitimate values: xml, csv, db. Only xml and csv are currently supported.
+ jmeter.save.saveservice.output_format=csv
+
+ # true when field should be saved; false otherwise
+
+ # assertion_results_failure_message only affects CSV output
+ jmeter.save.saveservice.assertion_results_failure_message=true
+ jmeter.save.saveservice.data_type=true
+ jmeter.save.saveservice.label=true
+ jmeter.save.saveservice.response_code=true
+ jmeter.save.saveservice.response_data=false
+ jmeter.save.saveservice.response_message=false
+ jmeter.save.saveservice.successful=true
+ jmeter.save.saveservice.thread_name=true
+ jmeter.save.saveservice.time=true
+
+ # legitimate values: none, ms, or a format suitable for SimpleDateFormat
+ #jmeter.save.saveservice.timestamp_format=ms
+ jmeter.save.saveservice.timestamp_format=MM/dd/yy HH:mm:ss
+
+ # legitimate values: none, first, all
+ jmeter.save.saveservice.assertion_results=first
+
+ # For use with Comma-separated value (CSV) files or other formats
+ # where the fields' values are separated by specified delimiters.
+ jmeter.save.saveservice.default_delimiter=|
+ jmeter.save.saveservice.print_field_names=true
</pre>
</code></p>
<p>
@@ -434,7 +459,11 @@
make it impossible for JMeter to interpret the value when it is read
in later for viewing purposes.</p>
<p>
-The viewing capabilities are described in the following subsections.</p>
+Note that reading of comma-separated values is also not
+supported. This format is provided for use with external viewing
+and data manipulation tools like spreadsheets or databases.</p>
+<p>
+The internal viewing capabilities are described in the following subsections.</p>
</description>
<component index="13.3.1" name="Mailer Visualizer"
screenshot="../images/screenshots/mailer_vis.png">
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
