Resources

Documentation

Everything you need to get started, integrate, and get the most out of Topogy.

Datadog

Topogy has an integration with Datadog which enables us to understand your usage, how it affects cost, and correlate it with overall platform spending. In order to take advantage of these capabilities, you need to grant the Topogy app access on Datadog, then enable the Datadog integration in Topogy.

Topogy is in an ongoing process to integrate with Datadog and become part of Datadog's Network Partner. In the meantime, while this process isn't finished, the access to your instance is done using a combination of API and Application Keys.

Below, you can see instructions for collecting this information and saving it in Topogy.

Topogy Datadog integration form


Step 1. Identify your Datadog server

You can check which server your instance belongs to by checking where Datadog connects to before you login.

Datadog login page

Now go back to Topogy and select your corresponding server from the list:

Topogy server selection


Step 2. API Key

Create a new API Key

  1. In Datadog, after logged in, navigate to API Keys by hovering over your username and clicking API Keys

Datadog API Keys navigation

  1. Click New Key

New API Key button

  1. Give it a recognizable name, we recommend "Topogy Access". Then click Create Key

Name and create API key

You will land in the a page similar to the following:

API Key created

Copy key to Topogy

  1. Finally, click Copy and then Finish. Back to Topogy, paste your API Key

Topogy API Key field


Step 3. Application Key

Create a new Application Key

  1. In Datadog, navigate to Application Keys by hovering your mouse on your username, then clicking on Application Keys

Datadog Application Keys navigation

  1. Click New Key

New Application Key button

  1. Give it a recognizable name (we recommend "Topogy Access") and click Create Key

Name and create Application key

Configure scopes

  1. Now, next to Scope, click Edit

Application Key scope edit

  1. Now, select the scopes required by Topogy: billing_read, hosts_read, logs_read_config, metrics_read and usage_read

Select required scopes

  1. Once finished selecting the scopes above, click Save. You should see the following scopes selected:

Scopes selected

Copy key to Topogy

  1. There's no need to enable Actions API Access. Click Copy and Finish, then back to Topogy, paste your Application Key

Topogy Application Key field


Finish

Finally, in Topogy, click Create Connection

Create Connection button