MongoDB Atlas Integration

The MongoDB Atlas integration ingests performance, health, and operational metrics (connections, ops rates, replication lag, CPU/memory, disk I/O, etc.) from your Atlas clusters into Middleware for dashboards and alerts.

Prerequisites

• MongoDB Atlas account with an M10 or higher tier cluster (M0 free tier doesn’t expose the metrics API endpoints needed).
• Whitelist the Middleware’s collector IP for Atlas API access: 48.217.209.253. This IP can change, and if metrics stop flowing, contact MW Customer Support to verify the current IP.

Configuration Overview

Atlas is integrated via the MongoDB Atlas API. You’ll create an API Key with Organization Read Only permission, whitelist the collector IP, then paste the key pair into the Middleware integration form.

1 Create a MongoDB Atlas API Key

• Log in to Atlas.
• Go to Identity & Access → Applications → API Keys → Add New.
• Add a description for the key.
• Under Organization Permissions, select Organization Read Only.
• Click Next and copy both Public Key and Private Key (you won’t be able to view the private key again).
• Add 48.217.209.253 to the API access list.
• Create API Key.

(Optional) Verify API Key access

Run the Atlas API test calls (HTTP Digest) with your key pair:

1# Test organization access
2curl -u "<PUBLIC_KEY>:<PRIVATE_KEY>" \
3  --digest \
4  "https://cloud.mongodb.com/api/atlas/v1.0/orgs"
5
6# Test project access
7curl -u "<PUBLIC_KEY>:<PRIVATE_KEY>" \
8  --digest \
9  "https://cloud.mongodb.com/api/atlas/v1.0/groups"

Replace the placeholders with your actual values.

2 Open the MongoDB Atlas integration in Middleware

Installations → All Integrations → MongoDB Atlas.

3 Fill in the Configuration

Enter the required fields exactly as they appear in Atlas; leave the defaults unless you have a reason to change them.

Required fields (as shown on the form):

• Public Key: Your Atlas API public key
• Private Key: Your Atlas API private key
• Collection Interval (optional): default 3m
• Granularity: default PT1M
• Storage: Default file_storage

Projects (optional)

• Project Name
• Include Clusters / Exclude Clusters: Specify one of these (not both) to control which clusters are collected.

Save the configuration to start collection. Middleware connects to Atlas via the API and begins pulling metrics shortly after.

Visualize Analytics

Default Dashboard

A ready-made MongoDB Atlas dashboard appears in Dashboard Builder after a successful setup (use it to validate data flow, then customize as needed).

Create a custom widget

1. Select Widget Dashboard Navigate to the Create Widget screen:

2. Add Widget → Database → MongoDB Atlas; pick your metric(s), filters, and time range, then preview and save:

Alerts

You can alert on any MongoDB Atlas metric. When creating a rule, choose Detection method: Database and Database type: MongoDB Atlas to see all Atlas metrics in the Metrics dropdown, then set your conditions.

Metrics Collected