Data Center App Performance Toolkit

The Data Center App Performance Toolkit extends Taurus which is an open source performance framework that executes JMeter and Selenium.

This repository contains Taurus scripts for performance testing of Atlassian Data Center products: Jira, Confluence, and Bitbucket.

At the moment, Jira DC and Confluence DC support is in beta. Bitbucket DC support is coming soon.

Supported versions

• Supported Jira versions:

  • The latest Platform Release: 8.0.3
  • The following Jira Enterprise Releases: 7.13.6 and 8.5.0

• Supported Confluence versions:

  • The latest Confluence Enterprise Release: 6.13.8
  • The latest Confluence Platform Release: 7.0.4

Installation and set up

Dependencies

• Python 3.6+ and pip
• JDK 8
• Google Chrome web browser.

Please make sure you have a version of Chrome browser that is compatible with ChromeDriver version set in app/$product.yml file (modules->selenium->chromedriver->version).

If a first part of ChromeDriver version does not match with a first part of your Chrome browser version, update Chrome browser or set compatible ChromeDriver version in .yml file.

macOS/Linux

Make sure that you have Python 3.6+, pip, and JDK 8 installed:

python3 --version
pip --version
java -version

We recommend using virtualenv for Taurus.

1. Install virtualenv with pip:

pip install virtualenv

2. Create new virtual env with python3:

virtualenv venv -p python3

3. Activate virtual env:

source venv/bin/activate

4. Install dependencies:

pip install -r requirements.txt

Windows

Installing Taurus manually

Make sure you have Python 3.6+, pip, and JDK 8 installed:

python --version or python3 --version
pip --version
java -version
Microsoft Visual C++ 14

Make sure you have Visual Studio build tool v14.22 installed. Otherwise, download it from Microsoft Visual C++ Build Tools: and do the following:

1. Select Tools for Visual Studio 2019.
2. Download and run Build Tools for Visual Studio 2019.
3. Select the C++ build tools check box.
4. Select the MSVC v142 - VS 2019 C++ x64/x86 build tools (v14.22) check box (clear all the others).
5. Click Install.

We recommend using virtualenv for Taurus.

1. Install virtualenv with pip:

pip install virtualenv

2. Create new virtual env with python3:

virtualenv venv -p python

3. Activate virtual env:

venv\Scripts\activate

4. Install dependencies:

pip install -r requirements.txt

Upgrading

If you see "There is newer version of Taurus available, consider upgrading." warning message during your test execution, please use the next command to apply the upgrade in your virtual environment.

pip install -r requirements.txt

Additional info

Official Taurus installation instructions are located here.

Analytics

The Data Center App Performance Toolkit includes some simple usage analytics.
We collect this data to better understand how the community is using the Performance Toolkit, and to help us plan our roadmap. When a performance tests is completed we send one HTTP POST request with analytics.

The request include the following data, and will in no way contain PII (Personally Identifiable Information).

• application under test (Jira/Confluence/Bitbucket)
• timestamp of performance toolkit run
• performance toolkit version
• operating system
• concurrency and test_duration from $product.yml file
• actual run duration
• executed action names and success rates
• unique user identifier (non PII)

To help us continue improving the Toolkit, we’d love you to keep these analytics enabled in testing, staging, and production. If you don’t want to send us analytics, you can turn off the allow_analytics toggle in $product.yml file.

Running Taurus

Navigate to docs folder and follow instructions.