Documentation and Best Practices

Learn how to use Cloudability and get the most out of our cloud cost management tool.

Follow

Integration with Datadog - how to add your Datadog Credentials to Cloudability

If you use Datadog to monitor your resources, then you can take advantage of Cloudability's Datadog integration to help you reduce wasted spend by optimizing your resource usage.

Cloudability fully supports Datadog multiple organizational accounts. Cloudability uses your Datadog credentials to ingest utilization metrics and generate accurate rightsizing recommendations for the following types of cloud compute resources across all your Datadog organizational accounts:

Using an APM like Datadog makes it easy to generate and collect the necessary resource utilization metrics (such as guest memory metrics, which can be difficult to instrument at scale) to get an accurate picture of how the resource is being utilized leading to an accurate rightsizing recommendation. Learn more about Datadog and their product offerings here.

Prerequisites

API Rate Limit

Cloudability's Datadog integration requires a minimum of 300 API requests per hour. Datadog sets the default API rate to 300 API requests per hour per organization. If you are using Datadog's API for other purposes, we highly recommend that you contact your Datadog Support to request an increase in the number of API requests you can make. In general, we recommend a minimum rate of 600 API requests per hour per organization. This is a simple, free request to Datadog and you can reference Cloudability in your request.

For context, when a Datadog credential is added to Cloudability, it is initially used to collect 30 days worth of utilization metrics data in order to surface accurate rightsizing recommendations as soon as possible. This process can take a while depending on the number of resources for which we need to collect past-30-day utilization metrics. Having a higher API rate enables us to collect the metrics quicker with a minimal number of retries.

API and Application keys

Through Datadog, create an API key and Application key for use in Cloudability. If you have multiple Datadog organizations, then create an API key and Application key per organization. Cloudability requires only a single API key and Application key per Datadog organizational account.

A note about Datadog keys and what Cloudability supports

Using Datadog, a user can generate keys for each of their Datadog organizational accounts. All keys within a Datadog organizational account provide access to data within that account. These keys are comprised of two components:

  1. API key
  2. Application key

Both these keys are needed in order to make requests against Datadog's APIs. As of writing this KB, Datadog has three types of Application keys that determine the level of access:

  1. Administrator
  2. Standard
  3. Read-only

Cloudability supports all three types of Application keys listed above.

Read-only keys have the following limitations:

  • Read-only keys prevent Cloudability from fetching metadata, such as key name, for the keys.
  • Read-only keys prevent Cloudability from being able to perform de-dup. For example, in the case when a user adds multiple read-only keys from the same Datadog organizational account: We need only a single API and Application key per account, but we can't de-dup since read-only keys do not provide us access to the data necessary to perform that check. In other words, Cloudability does not know that these read-only credentials are from the same account.

If you've been using Cloudability's Datadog integration with support for only one organizational account

If you've been using Cloudability's Datadog integration with support for only one organizational account (prior to multiple organizational account support), then you will notice that your credential has been migrated to the new Datadog multi-org experience.

Your existing credential will not have an org label assigned to it, as you can see from the screenshot below. However, you can edit this credential and add the appropriate organization label.

Screen_Shot_2020-07-27_at_11.25.52_AM_copy.png

To edit the credential, click on the edit icon Screen_Shot_2020-07-27_at_1.12.23_PM.png.

If you're using Cloudability's Datadog integration for the first time

1. Check that you've met all prerequisites.

  • API rate limit is at least 300 API requests per hour per organization
  • You have generated an API key and Application for use in Cloudability for each of your Datadog organizational accounts

2. In Cloudability, navigate to the Datadog tab under Vendor Credentials.

Navigate to Vendor Credentials, and click on the Datadog tab.

Screen_Shot_2020-07-27_at_11.26.37_AM.png

 

 

3. Add a Datadog credential for your organizational account.

Click the "Yes, I'm ready" button and fill in the details for your Datadog organizational account.

Rate Limit We assume a rate limit of 600 API requests per hour per organization. Set this number to what has been configured for your organization.
Organization Label A user-defined label. Datadog organizational labels can be at most 32 characters in length.

API key

Application key

Set these two values to what you created earlier (see prerequisites).

 

Screen_Shot_2020-07-27_at_11.26.44_AM.png

4. Save your Datadog credential.

Click the "Save" button once you're done and you should see a message saying that your Datadog credential has been successfully added.

Screen_Shot_2020-07-27_at_11.29.20_AM.png

5. Add credentials for all your Datadog multiple organizational accounts.

Click on the "Add a Credential" button and follow the steps as before. Once you're done, you will see all your Datadog credentials listed on the page.

Screen_Shot_2020-07-27_at_11.30.52_AM.png

A note about Read-only credentials

A read-only Application key from Datadog prevents Cloudability from fetching additional data about the API and Application key.

In those cases, metadata about the keys (such as key name, owner, etc.) will be marked as Not Available.

Additionally, if there are multiple such read-only credentials then Cloudability cannot guarantee that no duplicates exist (providing access to the same data) since the de-dup logic does not fully work with read-only keys.

Screen_Shot_2020-07-27_at_11.29.30_AM_copy.png

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.