Skip to content

AWS Account Setup

Connect an AWS account to KloudMate so it can read CloudWatch metrics and logs from that account, with no code changes. KloudMate gives you a pre-configured CloudFormation stack that creates a delegation role in your account, and you paste the role’s ARN back into KloudMate.

  1. Go to Settings → Data Sources and click Connect AWS account.

The Data Sources page with the Accounts counter and the Connect AWS account button.

  1. Enter an Account name and click Continue. The name identifies the account in KloudMate, so use one you’ll recognize, such as prod-aws.

The Name your AWS account step, with the Account name field and the Continue button.

  1. Click Open AWS Console. It opens CloudFormation with the stack template and external ID already filled in. Sign in to AWS with an administrator account if you’re asked to.

The Connect AWS account page, with the Open AWS Console button, the steps to follow in AWS, and the Role ARN field.

  1. In AWS, check I acknowledge that AWS CloudFormation might create IAM resources at the bottom of the Quick create stack page, and click Create stack.
  2. Wait for the stack to be created. This takes about a minute.
  3. Open the stack’s Outputs tab and copy the value of KloudMateAppDelegationRoleArn.
  4. Back in KloudMate, paste the ARN into the Role ARN field and click Connect.

The account appears on the Data Sources page. To add another account, repeat these steps.

Each account on the Data Sources page has an Edit button.

A Pending AWS account card with no account ID and an Edit button, and the Accounts counter at 1 of 1 with Connect AWS account turned off.

Click Edit to open Edit Account Details. It shows the account’s AWS account ID and external ID.

  • To update the account, change the AWS Account Name or paste the Role ARN, then click Update. If you don’t have a role yet, Click here to add KloudMate CloudFormation stack to AWS opens the stack in AWS.
  • To remove the account, click Delete account. You need the Owner role, and the account’s data is deleted permanently. See Remove an AWS Account to also remove the stack from AWS.

The Edit Account Details screen, with the AWS account ID, external ID, account name, Role ARN field, Update button, and Delete account section.