isabella232 / dc-app-performance-toolkit

Atlassian Data Center App Performance Toolkit

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.

Supported versions

• Supported Jira versions:

  • Jira Long Term Support release: 7.13.15 and 8.5.8
  • Jira Platform release: 8.0.3

• Supported Confluence versions:

  • Confluence Long Term Support release: 6.13.13 and 7.4.4
  • Confluence Platform release: 7.0.5

• Supported Bitbucket Server versions:

  • Bitbucket Server Long Term Support release: 6.10.5
  • Bitbucket Server Platform release: 7.0.5

Support

In case of technical questions, issues or problems with DC Apps Performance Toolkit, contact us for support in the community Slack #data-center-app-performance-toolkit channel.

Installation and set up

Dependencies

• Python 3.6+ and pip
• JDK 8
• Google Chrome web browser
• Git client (only for Bitbucket Server)

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

For Bitbucket Server check that Git is installed:

git --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

For Bitbucket Server check that Git is installed:

git --version

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 the toolkit

Get latest codebase from master branch:

git pull

Activate virtual env for the toolkit and install latest versions of libraries:

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.