> ## 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.

# MongoDB Atlas

> Receive alerts from MongoDB Atlas via webhook notifications.

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

MongoDB Atlas sends alert notifications to Warrn via webhook. When an Atlas alert fires (OPEN status), Warrn creates an alert. When the Atlas alert is CLOSED, Warrn auto-resolves the matching alert.

## Setup

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

  <Step title="Configure the webhook in Atlas">
    In MongoDB Atlas, go to **Project Settings > Integrations**. Click **Configure** next to **Webhook**. Paste the webhook URL from Warrn and save.
  </Step>

  <Step title="Create alert rules">
    In Atlas, go to **Alerts > Alert Settings**. Configure the alert conditions you want routed to Warrn. The webhook integration applies to all alerts in the project.
  </Step>
</Steps>

## How it works

Atlas sends a flat JSON payload per alert. The `status` field determines the action:

* **OPEN** or **INFORMATIONAL**: Creates a new alert in Warrn. Deduplicates by Atlas alert `id`.
* **CLOSED**: Auto-resolves the matching Warrn alert.

The alert name is extracted from the `humanReadable` field, which contains a multi-line summary. Warrn parses the first meaningful line (skipping metadata prefixes like "Project:", "Organization:", "Severity:") and appends the cluster name.

### Field mapping

| Atlas field                                                     | Warrn field                                   |
| --------------------------------------------------------------- | --------------------------------------------- |
| `humanReadable` (parsed) or `eventTypeName`                     | Alert name                                    |
| Cluster, host, replica set, metric value, event type, Atlas URL | Description                                   |
| `severity`                                                      | Severity (mapped, see below)                  |
| `id`                                                            | Alert alias (used for dedup and auto-resolve) |
| Event type, cluster name, source type, replica set, Atlas tags  | Tags                                          |

## Severity mapping

| Atlas severity            | Warrn severity |
| ------------------------- | -------------- |
| `critical`                | critical       |
| `error`                   | high           |
| `warning`                 | medium         |
| `notice`                  | low            |
| `informational`           | low            |
| (missing or unrecognized) | medium         |