Skip to main content
This guide walks you through forwarding CloudWatch alarms from AWS into scaling.cloud so that OK → ALARM opens an incident and ALARM → OK resolves it. For an overview of the integration, see AWS CloudWatch. If your alarms are defined in AWS CDK, see Ingest CloudWatch Alarms with AWS CDK instead — the OK transition needs explicit wiring there.
AWS integration mapping

An AWS integration mapped to a scaling.cloud component

​
Prerequisites

  • A scaling.cloud component representing the AWS service you want to monitor (e.g., Payments API).
  • Access to the AWS account that hosts the CloudWatch alarms, with permission to create SNS topics and modify alarm actions.
  • The Admin role in your scaling.cloud organization.
1

Create an AWS integration in scaling.cloud

Go to Settings → Integrations → AWS and click Add integration.
  • Name — a short label (e.g., Production us-east-1). Visible in the dashboard only.
  • Component — the catalog component this integration’s alarms should open incidents on.
Click Create.
2

Copy the webhook URL

scaling.cloud shows you a one-time reveal screen with a unique webhook URL:
Copy this URL now. It is shown once — scaling.cloud stores only a hash. If you lose it, delete the integration and create a new one.
3

Create an SNS topic in AWS

In the AWS console (or via Terraform / CDK), create a new SNS topic:
  • Type: Standard (not FIFO).
  • Region: the same region as the alarms you want to forward.
  • Name: something descriptive, e.g., scaling-alarms.
4

Subscribe the webhook URL to the topic

Add an HTTPS subscription to the topic, pasting the webhook URL you copied from scaling.cloud. Set SignatureVersion=2 so SNS signs with RSA-SHA256 — scaling.cloud rejects the legacy RSA-SHA1 (SignatureVersion=1) default.
If you subscribed via the console (where SignatureVersion isn’t exposed) or have an older subscription you can’t recreate, update it in place:
scaling.cloud auto-confirms the subscription on first delivery and pins the topic ARN onto the integration. You don’t need to click any confirmation link.Within a few seconds the subscription should show Status: Confirmed in the AWS console.
5

Route your alarms to the topic

On each CloudWatch alarm you want forwarded:
  1. Open the alarm in the CloudWatch console.
  2. Under Actions, add the SNS topic as a notification target for both the In alarm and OK state changes.
Or via Terraform / CDK, set alarm_actions and ok_actions on the alarm:
INSUFFICIENT_DATA notifications are ignored by scaling.cloud, so you don’t need to suppress them.
6

Verify end-to-end

Trigger one of the alarms (or temporarily lower its threshold) to force an OK → ALARM transition. Within a few seconds:
  • A new incident appears in scaling.cloud tagged with the mapped component.
  • If the component has an escalation policy attached, the on-call responder is paged.
Restore the alarm threshold so it returns to OK. The open incident should auto-resolve.

​
One integration per topic

Each AWS integration maps to one scaling.cloud component. If you want alarms on different services to open incidents on different components, create one SNS topic and one scaling.cloud integration per component. A common pattern:

​
Cross-region

CloudWatch alarms are region-scoped, but SNS topics can deliver to HTTPS endpoints anywhere. You can route alarms from multiple AWS regions into a single scaling.cloud integration by creating one topic per region and subscribing the same scaling.cloud webhook URL to each.
If you operate in many AWS regions and want a single dashboard, prefer one integration per service (with multiple per-region topics subscribed to the same webhook) over one integration per region. That way every alert for a service lands on the same scaling.cloud component.

​
Troubleshooting

​
Removing the integration

Delete the integration in Settings → Integrations → AWS. Further deliveries to the webhook URL return 404. Remove the HTTPS subscription from the SNS topic on the AWS side to stop AWS retries.