Questions? Queries? Problems?

Please see our FAQ page for the answer to many common questions.

For support, just drop us an email to support@runbook.cloud.

We aim to respond to all emails within one working day.

# Quickstart

# Adding runbook.cloud to your account

To add runbook.cloud your AWS account, you must do the following:

  • Sign up for a runbook.cloud account
  • Subscribe via AWS marketplace
  • Grant us limited, read-only permissions to metrics in your AWS Account

# Signing up for a runbook.cloud account

To sign up for a runbook.cloud account, simply visit the signup page, and enter your email address and desired password. You will be emailed a confirmation code - enter this on the confirmation page.

# Subscribe via AWS Marketplace

All billing for runbook.cloud is done via your normal monthly AWS bill. In order to subscribe, you must visit the runbook.cloud Marketplace page and select ‘Subscribe’.

# Granting runbook.cloud access to your AWS account

Once you have subscribed via AWS Marketplace you should be automatically redirected to the account setup page. From this page you can generate a CloudFormation template which provides us with limited access to your AWS account in order to read metrics and other metadata necessary for runbook.cloud to operate. Please note that we are not able to view any data within your account with the access we are granted - for example, we can read how many SELECT queries per second an RDS instance is doing, but not the contents of those queries or the data in your database. All access granted is provided in accordance with AWS recommendations and has been audited by AWS as part of our inclusion in AWS Marketplace.

Here you will be asked to enter a name for the AWS account you are adding. This is used purely for display, and can be anything you like. It can be changed at any time via the AWS Account Configuration page.

You will also be asked the specify the primary AWS region you use. This is used only to determine where the CloudFormation stack we will provide is created; other than this there is no operational impact.

To create the permissions via CloudFormation, simply click Grant Permissions, and you will see the AWS CloudFormation stack creation page. Select I acknowledge that AWS CloudFormation might create IAM resources with custom names and then Create. You can now switch back to the runbook.cloud tab in your browser, where you must click the ‘Check Access’ button to verify access has been granted correctly. It can take up to 60 seconds for the CloudFormation template to complete, so if this fails initially click the button again to retry.

Once the role has been verified, runbook.cloud will begin monitoring your account. It will take up to 10 minutes before initial findings (if any) are available. After 48 hours, findings will also use historical data combined with machine learning to provide improved results. These will be continually improved as more metrics are collected.