Cloud Assault

This add-on is operated by Catabolic Software, LLC

Simple, Affordable, Effective Load Testing

Cloud Assault

Last Updated: 11 February 2014

The Cloud Assault add-on is currently in beta.

Table of Contents

Cloud Assault is an add-on that exposes Cloud Assault load testing functionality to your Heroku app.

Cloud Assault is a cloud-based load testing platform for web and internet infrastructure. Cloud Assault is 100% API driven and geared for integrating load testing into continuous integration, and continuous deployment processes.

Cloud Assault is accessible via an API and has supported client libraries for ruby.

Provisioning the add-on

Cloud Assault can be attached to a Heroku application via the CLI:

A list of all plans available can be found here.

$ heroku addons:add cloudassault
-----> Adding cloudassault to sharp-mountain-4005... done, v18 (free)

Once Cloud Assault has been added a CLOUDASSAULT_API_KEY setting will be available in the app configuration and will contain the API key that you can use to launch load tests via the Cloud Assault API

$ heroku config | grep CLOUDASSAULT_API_KEY

After installing Cloud Assault the application should be configured to fully integrate with the add-on.

Running load tests

Load tests can be run either programmatically with the cloudassault gem or directly from your app’s Coud Assault dashboard. For example, to create a simple load test in code:

client =

test = client.create_simple_load_test('API Test', '', '<my URL>', 100, 5)
finished = false
while (!finished)
  puts test.inspect
  test = client.simple_load_test(test[:id])
  finished = !(test[:completed_at].nil?)

Otherwise, open the Cloud Assault dashboard to create load tests using the UI.

$ heroku addons:open cloudassault
Opening cloudassault for sharp-mountain-4005…

Your subscription entitles you to run a certain number of tests every month. Depending on your subscription the connection limit on the tests will vary. If you want to run more or larger tests you have the option of upgrading the add-on.


The Cloud Assault dashboard features your test execution results and graphs.

Cloud Assault Graphs

The dashboard can be accessed via the CLI:

$ heroku addons:open cloudassault
Opening cloudassault for sharp-mountain-4005…

or by visiting the Heroku apps web interface and selecting the application in question. Select Cloud Assault from the Add-ons menu.

Migrating between plans

Use the heroku addons:upgrade command to migrate to a new plan.

$ heroku addons:upgrade cloudassault:ci-small
-----> Upgrading cloudassault:newplan to sharp-mountain-4005... done, v18 ($29.95/mo)
       Your plan has been updated to: cloudassault:ci-small

Removing the add-on

Cloud Assault can be removed via the CLI.

This will destroy all associated data and cannot be undone!

$ heroku addons:remove cloudassault
-----> Removing cloudassault from sharp-mountain-4005... done, v20 (free)

Before removing Cloud Assault a data export can be performed by pulling your test data from the Cloud Assault API.


All Cloud Assulat support and runtime issues should be submitted via on of the Heroku Support channels. Any non-support related issues or product feedback is welcome at

Additional resources

Additional resources are available at: