The Grinder 3 Table of contents 1 Project........................................................................................................................... 5 1.1 The Grinder, a Java Load Testing Framework....................................................... 5 1.1.1 What is The Grinder?........................................................................................ 5 1.1.2 Authors...............................................................................................................6 1.1.3 Credits................................................................................................................ 6 1.2 The Grinder License................................................................................................6 1.2.1 The Grinder........................................................................................................6 1.2.2 HTTPClient........................................................................................................7 1.2.3 Jython.................................................................................................................7 1.2.4 jEdit Syntax........................................................................................................7 1.2.5 Apache XMLBeans............................................................................................7 1.2.6 PicoContainer.....................................................................................................8 1.2.7 ASM...................................................................................................................8 1.2.8 JSR 166y............................................................................................................8 1.2.9 SLF4J................................................................................................................. 8 Copyright © 2013 Philip Aston, Calum Fitzgerald All rights reserved. The Grinder 3 1.2.10 Logback............................................................................................................8 1.2.11 Clojure..............................................................................................................8 1.2.12 Ring..................................................................................................................8 1.2.13 Compojure........................................................................................................8 1.2.14 ring-middleware-format....................................................................................8 1.2.15 Jetty.................................................................................................................. 8 1.2.16 Clojure tools.logging........................................................................................9 1.2.17 Supporting license text.....................................................................................9 1.3 Downloading The Grinder.................................................................................... 10 1.3.1 Download......................................................................................................... 10 1.3.2 Downloading The Grinder using Maven..........................................................10 1.4 Support.................................................................................................................. 11 1.4.1 Mailing lists..................................................................................................... 11 1.5 External references................................................................................................ 11 1.5.1 Related Software Projects................................................................................ 11 1.5.2 Articles............................................................................................................. 15 1.5.3 Commercials.....................................................................................................16 2 The Grinder 3............................................................................................................. 18 2.1 Getting started....................................................................................................... 18 2.1.1 The Grinder processes......................................................................................18 2.1.2 Tests and test scripts........................................................................................20 2.1.3 Network communication..................................................................................21 2.1.4 Output...............................................................................................................21 2.1.5 How do I start The Grinder?............................................................................22 2.2 Agents and Workers..............................................................................................24 2.2.1 Agents and Workers.........................................................................................24 2.2.2 The Grinder 3 Properties File.......................................................................... 24 2.2.3 Logging............................................................................................................ 28 2.3 The Console...........................................................................................................30 2.3.1 The Console User Interface............................................................................. 30 2.3.2 The Console Service........................................................................................ 36 2.4 The TCPProxy.......................................................................................................43 2.4.1 Starting the TCPProxy..................................................................................... 44 2.4.2 Preparing the Browser......................................................................................44 2.4.3 Using the EchoFilter........................................................................................ 46 2.4.4 Using the HTTP TCPProxy filters...................................................................47 Copyright © 2013 Philip Aston, Calum Fitzgerald All rights reserved. Page 2 The Grinder 3 2.4.5 SSL and HTTPS support................................................................................. 51 2.4.6 Using the TCPProxy with other proxies.......................................................... 53 2.4.7 Using the TCPProxy as a port forwarder.........................................................53 2.4.8 Summary of TCPProxy options....................................................................... 54 2.5 Scripts....................................................................................................................55 2.5.1 Scripts...............................................................................................................55 2.5.2 Jython...............................................................................................................59 2.5.3 Clojure..............................................................................................................60 2.5.4 Script Instrumentation......................................................................................61 2.5.5 Coordination.....................................................................................................63 2.5.6 Script Gallery...................................................................................................64 2.6 Plug-ins..................................................................................................................80 2.6.1 The HTTP Plug-in........................................................................................... 80 2.7 Statistics.................................................................................................................85 2.7.1 Standard statistics.............................................................................................85 2.7.2 Distribution of statistics................................................................................... 85 2.7.3 Querying and updating statistics......................................................................85 2.7.4 Registering new expressions............................................................................86 2.8 SSL Support.......................................................................................................... 86 2.8.1 Before we begin...............................................................................................86 2.8.2 Controlling when new SSL sessions are created..............................................87 2.8.3 Using client certificates....................................................................................87 2.8.4 FAQ..................................................................................................................88 2.8.5 Picking a certificate from a key store [Advanced]...........................................88 2.8.6 Debugging........................................................................................................89 2.9 Advice....................................................................................................................89 2.9.1 How should I set up a project structure for The Grinder?................................89 2.9.2 A Step-By-Step Script Tutorial........................................................................91