Skip to main content

Integrating CostQ with AWS (Using Assume Role ARN)

To analyze your AWS costs, CostQ requires read-only access to your AWS account. This is done via an AWS IAM Role with the necessary permissions.

📌 Step 1: Generate an AWS CloudFormation Stack​

Instead of manually configuring permissions, CostQ provides a CloudFormation template that automates the setup.

  1. Log into your AWS account with administrative privileges.
  2. Open AWS CloudFormation by visiting:
  3. Click "Create Stack" and select "With new resources (standard)".
  4. In the Template source section, choose "Upload a template file".
  5. Upload the CostQ-provided CloudFormation template (Download it from your CostQ dashboard).
  6. Click Next.

📌 Step 2: Configure Stack Settings​

  1. Stack name: Enter a meaningful name (e.g., CostQ-Integration).
  2. IAM Role Permissions: Ensure you allow AWS to create IAM roles.
  3. Click Next, then Create Stack.

⏳ AWS will now create the necessary resources. This may take a few minutes.

📌 Step 3: Retrieve the Assume Role ARN​

Once the stack is created:

  1. Go to the CloudFormation Outputs tab.
  2. Locate the "AssumeRoleARN" value.
  3. Copy the ARN (e.g., arn:aws:iam::123456789012:role/CostQIntegrationRole).

📌 Step 4: Connect AWS to CostQ​

  1. Log into CostQ and navigate to Integrations → AWS.
  2. Paste the copied Assume Role ARN into the required field.
  3. Click "Validate & Save".

✅ If successful, CostQ will confirm the integration and begin pulling AWS cost data.

📌 Troubleshooting Integration Issues​

🔹 Stack Creation Fails?​

  • Ensure you have IAM permissions to create roles.
  • Check the CloudFormation Events tab for errors.

🔹 Assume Role ARN Not Found?​

  • Double-check that the CloudFormation stack completed successfully.
  • Navigate to AWS IAM → Roles and search for CostQIntegrationRole.

🔹 CostQ Fails to Validate ARN?​

  • Ensure AWS Cost & Usage Reports are enabled in AWS.
  • Try deleting and re-creating the stack.
  • Reach out to CostQ Support.

🎯 Next Steps​

✅ Verify AWS Data Sync
✅ Set Up Cost Optimization Alerts
✅ Manage Your AWS Accounts

Need help? Contact CostQ Support. 🚀