Install Runbooks
Runbooks in OneLens allow you to automate actions across your cloud environment with minimal manual effort. Before you install your first runbook, you'll need to complete a one-time setup in your AWS accounts. Once that’s done, installing a runbook becomes a simple, account-level action.
One Time Setup
Before installing your first runbook, you need to perform a one-time setup in your AWS environment. Depending on how your infrastructure is structured, follow the steps for either a Master-Child Setup or an Individual Account.
For Master Child Setup
If you have multiple AWS accounts through AWS Organizations, follow these steps:
Deploy the CFT as a StackSet for Child Accounts
Once the CFT has been deployed in the delegated account, use a CloudFormation StackSet from the delegated account to deploy the CFT to all child accounts. This ensures that each child account is configured with the required resources.
Child Accounts CFT URL:
https://prod-onyx-backend.s3.ap-south-1.amazonaws.com/onyx/aws/cft/onyx-child.template.jsonDeploy CFT as a Stack in the Delegated Account
In the delegated account, deploy the OneLens CloudFormation Template (CFT) as a CloudFormation Stack. This step sets up the necessary permissions and resources that OneLens needs to operate.
Delegated Account CFT URL:
https://prod-onyx-backend.s3.ap-south-1.amazonaws.com/onyx/aws/cft/onyx-master.template.jsonFor an Individual Account
If you're setting up OneLens in a single AWS account without AWS Organizations, follow these two steps:
Installing a Runbook
Once the setup is complete, here’s how you can install a runbook:
Open the particular runbook page in the OneLens UI.

Click the Install button at the bottom right of the page. This will open the Accounts Tab where you can see all your connected AWS accounts.

In the Accounts Tab, locate the specific account where you want to install the runbook.

Click the Install button next to the account you want to deploy the runbook to.
OneLens will then deploy the runbook using the permissions granted during one time setup.
Last updated

