Rally provides a framework for performance analysis and benchmarking of individual OpenStack components as well as full production OpenStack cloud deployments
Go to file
Mikhail Dubov 1ceb1555f3 Restructure Rally docs
Modify Rally docs (for readthedocs), sticking to the following principles:
* Make the docs structure as simple as possible:
    1. Overview
    2. Install Rally
    3. Rally step-by-step
    4. User stories
    5. Plugins
    6. Contribute to Rally
    7. Rally OS Gates
    8. Request a New Feature
    9. Project Info
* Keep in mind what questions different target groups usually have about Rally.
  The new structure relates to these groups as follows:
    1 -> Managers
    2, 3, 4 -> QA
    5, 6, 7, 8, 9 -> QA & Developers
* Make each docs page to be easy to get through;
* Prefer pictures over text;
* Use hyperlinks to easily navigate from page to page;
* Fix incorrect English & typos.

Also add a sample for SLA plugins.

Change-Id: I720d87be851c273689a21aaba87fc67eacf0f161
2015-01-20 00:27:30 +03:00
contrib/devstack Support for benchmarking with existing users (part 1) 2014-09-06 23:31:33 +04:00
doc Restructure Rally docs 2015-01-20 00:27:30 +03:00
etc/rally Fix defect of 'separate log level for Rally' 2014-11-19 22:11:17 +02:00
rally Merge "Replace ' with " in rally/*.py" 2015-01-18 09:19:21 +00:00
rally-jobs Add unstable job file + return SLA for boot from volume 2015-01-17 21:02:03 +03:00
samples Restructure Rally docs 2015-01-20 00:27:30 +03:00
tests Merge "Adding duration header to rally verify list query" 2015-01-17 20:59:03 +00:00
tools Input task templates and task cmd cleanup 2015-01-15 16:29:34 +03:00
.coveragerc Omit openstack/common/ in test coverage reports 2014-01-16 00:53:49 +04:00
.gitignore Prepare documentation for readthedocs 2014-06-05 17:45:51 +03:00
.gitreview Add .gitreview file 2013-09-06 19:37:42 +04:00
.testr.conf Reorganize test module structure 2014-10-07 13:50:40 +00:00
Dockerfile Add Dockerfile 2014-12-24 14:22:19 +02:00
LICENSE Initial commit 2013-08-03 09:17:25 -07:00
README.rst Fixes typo error in rally/README.rst 2014-06-09 14:46:14 +05:30
babel.cfg Add rally.sample.conf to project 2013-08-14 14:08:09 +04:00
install_rally.sh Adding logic to clean up old rally installs 2014-10-16 13:29:25 -04:00
openstack-common.conf Moved module "uuidutils" from oslo-incubator to oslo.utils 2014-12-27 04:18:24 +05:30
requirements.txt Merge "Input task templates and task cmd cleanup" 2015-01-15 15:31:06 +00:00
setup.cfg Fix bash completition setup 2014-10-13 23:24:24 +04:00
setup.py Fix bash completition setup 2014-10-13 23:24:24 +04:00
test-requirements.txt Updated from global requirements 2014-11-20 14:13:38 +00:00
tox.ini Move files to common lib(Part 2) 2014-12-24 10:21:32 +08:00

README.rst

Rally

What is Rally

Rally is a Benchmark-as-a-Service project for OpenStack.

Rally is intended to provide the community with a benchmarking tool that is capable of performing specific, complicated and reproducible test cases on real deployment scenarios.

If you are here, you are probably familiar with OpenStack and you also know that it's a really huge ecosystem of cooperative services. When something fails, performs slowly or doesn't scale, it's really hard to answer different questions on "what", "why" and "where" has happened. Another reason why you could be here is that you would like to build an OpenStack CI/CD system that will allow you to improve SLA, performance and stability of OpenStack continuously.

The OpenStack QA team mostly works on CI/CD that ensures that new patches don't break some specific single node installation of OpenStack. On the other hand it's clear that such CI/CD is only an indication and does not cover all cases (e.g. if a cloud works well on a single node installation it doesn't mean that it will continue to do so on a 1k servers installation under high load as well). Rally aims to fix this and help us to answer the question "How does OpenStack work at scale?". To make it possible, we are going to automate and unify all steps that are required for benchmarking OpenStack at scale: multi-node OS deployment, verification, benchmarking & profiling.

Rally workflow can be visualized by the following diagram:

Rally Architecture

Architecture

In terms of software architecture, Rally is built of 4 main components:

  1. Server Providers - provide servers (virtual servers), with ssh access, in one L3 network.
  2. Deploy Engines - deploy OpenStack cloud on servers that are presented by Server Providers
  3. Verification - component that runs tempest (or another specific set of tests) against a deployed cloud, collects results & presents them in human readable form.
  4. Benchmark engine - allows to write parameterized benchmark scenarios & run them against the cloud.

Use Cases

There are 3 major high level Rally Use Cases:

Rally Use Cases

Typical cases where Rally aims to help are:

  • Automate measuring & profiling focused on how new code changes affect the OS performance;
  • Using Rally profiler to detect scaling & performance issues;
  • Investigate how different deployments affect the OS performance:
    • Find the set of suitable OpenStack deployment architectures;
    • Create deployment specifications for different loads (amount of controllers, swift nodes, etc.);
  • Automate the search for hardware best suited for particular OpenStack cloud;
  • Automate the production cloud specification generation:
    • Determine terminal loads for basic cloud operations: VM start & stop, Block Device create/destroy & various OpenStack API methods;
    • Check performance of basic cloud operations in case of different loads.

Wiki page:

https://wiki.openstack.org/wiki/Rally

Rally/HowTo:

https://wiki.openstack.org/wiki/Rally/HowTo

Launchpad page:

https://launchpad.net/rally

Code is hosted on github:

https://github.com/stackforge/rally

Trello board:

https://trello.com/b/DoD8aeZy/rally