Datadog

Learn how to connect your Datadog organization to North as a Cost Loop.

Connect Datadog to North as a Cost Loop to see your Datadog observability and APM (application performance monitoring) spend beside your cloud spend. North reports Datadog spend by product, such as Infra Hosts, Containers, and Indexed Logs.

North reads your Datadog cost with a Service Access Token.

Before You Start

You need three things in Datadog:

• Permission to manage access. You create a role, a service account, and a Service Access Token for North.
• Custom roles. Your Datadog organization must have custom roles turned on before you can create the role for North. See Datadog custom roles.
• Your Datadog site. Your Datadog site is the domain in your browser's address bar when you sign in to Datadog, for example app.datadoghq.com or app.datadoghq.eu.

Connect Datadog

1

Open the Connect Screen

Open Settings, then Integrations, then Add accounts. Under Cost Loops, select Datadog.

2

Opt In to Datadog Cloud Cost

If you have already opted into Cloud Cost, you can skip this step.

In Datadog, open Cloud Cost in the left sidebar. This Datadog feature is free. You only need to opt in.

1. On the Manage your Datadog spend card, click Opt in.
2. If Datadog then asks you to set up Usage Attribution, skip it.

Skip the Control your cloud spend card. It is a separate paid Datadog add-on for AWS, Azure, and Google Cloud bills.

Complete this opt-in before you connect Datadog to North. North reads your Datadog cost from Datadog Cloud Cost Management. See Datadog costs for more guidance.

3

Create a Role for North

In Datadog, open Organization Settings, then Roles. Create a role for North with two permissions:

• Usage Read
• Billing Read

4

Create a Service Account

In Datadog, open Organization Settings, then Service Accounts. Create a service account for North. Assign it the role that you created for North.

See Datadog service accounts for more guidance.

5

Create a Service Access Token

In Datadog, create a Service Access Token on the service account for North. Set its expiration to Never. Give it these three scopes:

• usage_read
• billing_read
• timeseries_query

Set the expiration to Never. If the Datadog token expires, North stops receiving your Datadog cost data until you supply a new token.

6

Enter Your Connection Details

On the North connect screen, fill in the Datadog fields:

• Connection name. A label to recognize this account by. It becomes the card title on your homepage.
• Datadog site. The site that matches the domain in your browser's address bar.
• Service Access Token. The token that you created for North. It starts with ddsat_.

7

Verify and Connect

Click Verify & Connect. North looks up your Datadog organization with the token. If the connection works fine, you should see a success message.

If Verification Fails

When a Datadog check fails, the error message states the missing scope and the role permission that goes with it. Add the missing item in Datadog. Then click Verify & Connect again.

If North cannot connect to Datadog, check two things:

• The token type. The Datadog token must be a Service Access Token that starts with ddsat_.
• The site. The selected site must match the domain in your address bar. Each Datadog site is a separate deployment, and a token works only on its own site.

After You Connect

Your Datadog cost data can take a few days to appear in North after you opt in to Datadog Cloud Cost. Datadog makes the current month available a few hours after you opt in, and earlier months can take longer. North checks Datadog for new cost data each day and imports it as soon as it is available.

Datadog spend appears on your homepage as a card that carries your connection name. You can also add Datadog to a Streams view, select it in Visibility, and ask Noros about it. See Viewing Cost Loop Data for the detail available on each surface.

What North Reads

North reads daily cost for your Datadog organization from Datadog Cloud Cost Management. North receives this cost by product and by pricing term.

• Product is the Datadog product you are billed for, such as Infra Hosts or Indexed Logs (15 Day Retention).
• Pricing term is Committed for usage that your Datadog commitment covers, and Standard for on-demand usage.

Datadog reports cost by day. For hourly views, North allocates each day's Datadog cost across its hours by your hourly Datadog usage. Datadog bills some products on a P99 (99th percentile) basis, and those products have no hourly split. North spreads their cost evenly through the day. Daily and monthly totals do not change.

Historical data

North reads up to 12 months of Datadog cost: the current month and the 11 months before it. If your Datadog billing history is shorter, North reads from the month your history starts.

Limitations

• Datadog tags. You cannot split or filter Datadog spend by a Datadog tag.
• Child organizations. You cannot split Datadog spend by child organization.