Connect MongoDB

Edit online

Overview

This guide walks you through the process of connecting your MongoDB to IBM Cloudability. Once connected, you’ll gain access to the MongoDB Cost and usage data within Cloudability.

Prerequisites

  • You should be a Cloudability administrator.
  • You should have admin permissions in the MongoDB Atlas console.
Note: If you purchased MongoDB via a cloud provider marketplace and adding cost and usage data for MongoDB with this integration, you will see costs displayed twice in Cloudability reporting. As an example, if you purchased MongoDB via the AWS Marketplace, you will see:
  • The high-level line item for AWS
  • The line items with detailed MongoDB costs, with "AWS Marketplace" listed as Seller.

If you want to hide your marketplace costs, set up a filter.

Marketplace costs are excluded from billing.

MongoDB Account Credentialing process involves a few steps which will require you to take actions in both MongoDB console and Cloudability at various phases.

During this process Cloudability will use your MongoDB OrganizationID to connect with your account and fetch the Cost and usage data.

Step 1 – MongoDB Console

Get your Organization ID

  1. Go to the MongoDB Atlas console.
  2. Click on the user profile and then on Organizations.
  3. Click on the Organization name
  4. Click the gear icon next to the Organization settings.
  5. Copy the your Organization ID and save it for use later.

Create an Organization API Key

  1. Go the Access Manager page in the MongoDB Atlas console.
  2. Click on applications and select the API tab
  3. Click Create API Key.
  4. Enter the API Key information.
    • In the Description box, enter a description (e.g., Cloudability Access).
    • In the Organization Permissions menu, select the Organization Billing Viewer role.
  5. Click Next.
  6. Copy the public and private keys

Step 2 – Cloudability

  1. Open Cloudability in a new tab or window.
  2. In Cloudability, go to Settings > Vendor Credentials.
  3. In the Ingress section, choose the MongoDB tile. The Add MongoDB Account panel opens.
  4. Read the information presented and choose the Next button when you are ready to proceed.
  5. Paste the copied Organization ID into the Organization ID field.
  6. Paste the Public Key and Private Key into their respective fields.
  7. From the Subscription Model field, choose whether your organization uses a Marketplace or buys Direct from MongoDB.
  8. Click on the Save button.
  9. Click on Verify Credentials .

A green notification indicates that the credential was successfully verified.
Note: After you connect to MongoDB, it takes up to 24 hours for your initial cost and usage data to appear in Cloudability.

By default, MongoDB restricts API access using the IP Access List for the Atlas Administration API. If this is not disabled for your organization, use the following IP ranges to give MongoDB access to Cloudability:

  • 185.115.88.0/22
  • 103.195.128.0/22
  • 129.41.0.0/22

For more details on Whitelisting IPs please contact IBM Support teams.

Frequently Asked Questions

  • Which version on MongoDB is supported in Cloudability?
    • MongoDB Atlas
  • When should I use Marketplace vs subscription?
    • If you bought MongoDB from a Marketplace like AWS or Azure use this option
    • If you bought MongoDB Direct from MongoDB then select Direct