Connecting to Datadog

Connections are how CloudZero manages the various Cost Sources that bring Billing, Resource, and other types of data into the platform.

How the Datadog Connection Works

Connecting to a Datadog account will show Datadog cost data alongside other Cost Sources in the Explorer, as well as enable anomaly alerts on Datadog spend.

The CloudZero platform will ingest Datadog Cost data by making requests to Datadog's Usage Metering API.

πŸ“˜

About CloudZero's Access to your Datadog Accounts

All of CloudZero's permissions are Read-Only

We have no access to data except where explicitly authorized (for example, the data you explicitly share with CloudZero).

Summary of Permissions:

  • Usage Read Authorization Scope: grants read only access, to view usage and cost data associated with your Datadog account.

Datadog Billing Models

Datadog bills based on several pricing strategies that vary between products. As a result, costs are represented in the CloudZero platform using different models that depend on the Datadog product and how it is billed.

In the period preceding March 2024, there may be instances where costs exhibit a negative value.

Pricing With Commitment

Monthly committments are fixed, and costs are shown evenly amortized over the entire month.

On-Demand Pricing

On-demand pricing can vary by Datadog product and usage.

Average Pricing Model

Products using the "average" pricing model are billed based on the average usage over the month. Costs shown are amortized over the month and include only what was incurred to date.

High-Water Mark Pricing Model

Products using the "high-water mark" pricing model are billed based on the maximum usage of a resource during any one hour of the month. For a newly established "high-water mark" for some month, costs will show an increase for the remainder of that month. Costs shown are amortized over the month and include only what was incurred to date.

Historical Cost Data

CloudZero leverages Datadog's Estimated Cost endpoint to determine a product's daily cost. However, data from this endpoint is only available for the current and previous month at the time when the request is made. For months outside of this window, CloudZero leverages Datadog's Historical Cost endpoint. Since this endpoint provides a single cost per product for the entire month, you will see cost amortized evenly over the month. This will most frequently apply to historical months collected during initial ingest when the Estimated Cost data is not available.

Connect a Datadog Account

πŸ“˜

Note: Admin Role Required

You must be a CloudZero Admin to add new Connections to the platform.

Create a Datadog connection

  1. Open the Connections page. This can be found by selecting the gear icon from the sidebar and selecting Connections, or alternatively going to https://app.cloudzero.com/organization/connections
    CloudZero Connections

  2. Select the Add New Connection button.

  3. On the following page, you'll be presented with a list of possible connection types. Select the Datadog tile to begin setting up a Datadog connection.
    Datadog Connection Tile

  4. On the subsequent page, provide a name for the connection and select the site on which your Datadog account is based, i.e. the url used to log in to your account. When you're ready, select Get started.

  5. The Add a New Datadog Connection page will be displayed. At this point, you should give your connection a name, which will identify your Datadog connection throughout the CloudZero platform. Select the Continue button.

  6. You will then be redirected to Datadog. Please select the appropriate site from the dropdown and log in to your Datadog account.

    πŸ“˜

    IMPORTANT: Parent-Level Organization Access Required

    Usage data is only accessible for parent-level organizations. Be sure the site matches the location of your parent-level organization in Datadog.

Datadog Region Dropdown

  1. You will be asked to authorize CloudZero access to a Datadog organization. Please select the parent-level organization, and then select the Authorize button.

    πŸ“˜

    IMPORTANT: Usage Read Scope Required

    In order for CloudZero to access Datadog's Usage Metering API, the user providing authorization must also have usage read scope permissions.

Datadog Authorize Access Dropdown

  1. You will be redirected back to the Connection Details page in the CloudZero platform, where you should see your newly created Datadog connection.

Reauthorize a Datadog connection

In the event CloudZero is no longer able to access Datadog through the existing authorization, the option to reauthorize is available.

  1. Open the Connections page. This can be found by selecting the gear icon from the sidebar and selecting Connections, or alternatively going to https://app.cloudzero.com/organization/connections

  2. Select the Datadog connection you'd like to reauthorize from the Billing Connections table.

  3. The Connection Details page for a Datadog connection will be displayed. Click the Reauthorize button near the top of the page, to the right of Datadog Connection Details.
    Datadog Reauthorize

  4. You will then be redirected to Datadog. Please select the appropriate site from the dropdown and log in to your Datadog account.

    πŸ“˜

    IMPORTANT: Parent-Level Organization Access Required

    Usage data is only accessible for parent-level organizations. Be sure to select the site within which your parent-level organization exists.

  5. You will be asked to authorize CloudZero access to a Datadog organization. Please select the parent-level organization, and then select the Authorize button.

    πŸ“˜

    IMPORTANT: Usage Read Scope Required

    In order for CloudZero to access Datadog's Usage Metering API, the user providing authorization must also have usage read scope permissions.

  6. You will be redirected back to the Connection Details page, where you should see the Datadog connection you have just reauthorized.

Once your connection saves, it will appear in the Billing Connections table of the CloudZero Connections page with a status of Pending Data and a Last Checked status of Pending First Ingest.

Billing Connections

Once the connection has been verified, the Health column will update from Pending Data to Healthy.

If there are issues with your connection, you may see a status of Error instead of Healthy. If this happens, you can hover over the status button or navigate to the connection details page to find additional information.

πŸ“˜

Please Note

Discovery (the act of switching from a Pending First Ingest to a Healthy status) can take up to an hour.

It can take up to 24 hours to synchronize new accounts and begin to see cost data in Explorer.

Datadog Connection Notes

Billing Period Ingest Windows

  • Newly Created Connection: CouldZero will ingest the most recent 12 months worth of billing periods if available.
  • Re-enabled Connection: CloudZero will ingest up to 12 months of billing periods starting from the current billing period going back to the most recent billing period ingested.
  • Steady State: CloudZero will ingest the current billing period every day of the month and also the previous billing period until the 17th of the month.

Connecting Other Cost Sources

Additionally, you may want CloudZero to help with your other AWS, Snowflake, Azure or GCP costs, or the custom costs you can bring in using an AnyCost Adaptor.

Start by learning about CloudZero Connections, or choosing a Cost Source from the What's Next section below.