Grinder Analyzer



HOW TO RUN THE ANALYZER

It is only possible to run Grinder Analyzer after a test is completed.
Real-time graph generation is not supported.

To run the analyzer tool from Windows, Linux or OS X:

 1. Open a command-line shell and cd into the grinderAnalyzer directory.
 2. Execute the helper script like this:
        jython ./run.py "<grinder data Files>" <grinder out file> [number of agents]


More detail on the agruments:

  * The grinder data files are a set of one or more of the log files
    generated by the Agents.  If you are using just a single data file,
    the quotes are not needed.  These files typically have names like
    "data_agent18-0.log".
  * The grinder out file usually has a name like "out_agent18-0.log".
    The out file and the data file(s) MUST be from the same Grinder run.
  * Number of agents is an optional multiplier you can apply to the bandwidth
    and transactions per second graphs.  This is useful if you had many 
    agents running on several different machines and you are only running
    the analyzer on the log files generated by a single agent.  For this to
    give meaningful results, it is assumed that each agent is doing an
    identical workload.



CONFIGURATION

The default configurations that ship with Grinder Analyzer have been
pre-tweaked to be reasonable for most use.  However, there are 
options to adjust settings for graph size, granularity, etc., in
conf/analyzer.properties.



OUTPUT

All graphs and html are created in a directory named 'grinderReport'.  The
.png files may be viewed in the tool of your choice.  The html report
includes a summary table with sortable columns.

To store the analyzer results long-term, you will need to move or rename
the 'grinderReport' directory, since it is reset every time you run the
analyzer.
USAGE
