> ## Documentation Index
> Fetch the complete documentation index at: https://docs.warrn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS CloudWatch

> Collect CloudWatch alarms and metrics. Receive alerts via SNS webhook.

Warrn has two CloudWatch integrations:

## CloudWatch (Contextual)

| Property  | Value      |
| --------- | ---------- |
| **Type**  | Contextual |
| **Level** | Service    |

Connects to CloudWatch via AWS credentials to pull alarms and metrics. Used by Warrnagen during investigations to check metric state.

<Steps>
  <Step title="Add to a service">
    Open a service or team in Warrn. Go to the **Integrations** tab and add AWS CloudWatch\*\*.
  </Step>

  <Step title="Enter AWS credentials">
    Provide an AWS Access Key ID, Secret Access Key, and optionally an IAM Role ARN. Select your AWS region.
  </Step>
</Steps>

## CloudWatch SNS (Incoming)

| Property         | Value    |
| ---------------- | -------- |
| **Type**         | Incoming |
| **Level**        | Service  |
| **Auto-resolve** | Yes      |

Receives CloudWatch alarm notifications via SNS. When an alarm enters ALARM state, Warrn creates an alert. When it returns to OK or INSUFFICIENT\_DATA, Warrn auto-resolves the matching alert.

<Steps>
  <Step title="Add the integration in Warrn">
    Open a service or team in Warrn. Go to the **Integrations** tab and add CloudWatch SNS\*\*. Copy the generated webhook URL.
  </Step>

  <Step title="Create an SNS subscription">
    In AWS, create an SNS topic (or use an existing one). Add an HTTPS subscription pointing to the Warrn webhook URL.
  </Step>

  <Step title="Configure CloudWatch alarms">
    Set your CloudWatch alarms to send notifications to the SNS topic for both ALARM and OK actions. This enables auto-resolve.
  </Step>
</Steps>

<Note>
  Configure alarms for both ALARM and OK actions. Without the OK action, Warrn can create alerts but not auto-resolve them.
</Note>