So let's get started. The process is relatively simple:
1. Install prerequisites.
2. Configure TabJolt.
3. Run your first test.
In this version, we don’t have a packaged installer for all the third-party dependencies, so make sure you have them downloaded and installed separately.
To install TabJolt, you’ll need a Windows machine with a minimum of two cores with at least 8GB of RAM as your load generator. As a best practice, you should monitor this machine for CPU and memory to ensure that your test runs don’t bottleneck the load injector. In addition, you’ll need the latest versions of Java,
Tableau Desktop 9.0, and Postgres.
For a realistic load test, you should NOT use the Tableau Server Postgres instance for recording and storing your TabJolt test results. You don’t want the act of measuring your system to impact your system under test. So it’s important to keep your Tableau Server, the system under testing, separate from Postgres for TabJolt.
You can find Postgres configuration steps and troubleshooting tips in the installation guide you downloaded with TabJolt.
Your first TabJolt test run
Now you can start your scale test by using a Windows command prompt, navigating to c:\tabjolt, and running the example command below. This example tells TabJolt to run the test for 60 seconds (using “--d”) and run a single user client (“--c"). Of course, you can change these parameters as you wish.
Command: go --t=testplans\InteractVizLoadTest.jmx --d=60 --c=1
IMPORTANT: At the end of the run, on the command line, you will get the run id, which you need to use as a filter when analyzing your data in Tableau Desktop.
Explore all the options with go /? and experiment with the options. If you expect to execute many runs, consider adding a useful description to your runs using the command line “--r” followed by the description of the run.
Once the run is finished, open up the analysis workbook located at c:\tabjolt\PerformanceViz.twb using Tableau Desktop. You will need to provide the username and password for your TabJolt Postgres repository that you installed earlier (please see the installation guide on default credentials). You can update the default credentials in PerfRunHarness.Properties.
You can view the test results and review each of the worksheets.
Analyzing your load test data is like exploring any data with Tableau. TabJolt has some key worksheets as a starting point. Standard KPI metrics like response times, test cases per second (tps), host metrics, and JMX metrics (if configured) are visible in the workbooks automatically.
When you look at these results, you can quickly find patterns and check how your workload is behaving under load. In addition to standard metrics, TabJolt provides additional visibility and drill-down options for easier triage. Using these tools, you can find out which requests and tests are failing, and why.
If you're like me, you're probably excited to get your hands on TabJolt and give it a try. You can download all relevant files and the installation guide on GitHub. We have more information to help you get started in these training videos.
TabJolt is available as-is and not supported by Tableau. However, we expect you'll have questions. Please post your questions on the Tableau Server Administration forum with "TabJolt" as the subject. We're hopeful that many of you will start to build a community around this tool and share what you learn.
You can also tweet me your questions and comments @neeleshkamkol, and follow me for future updates on the project.