Datadog is the essential monitoring platform for cloud applications. We bring together data from servers, containers, databases, and third-party services to make your stack entirely observable. These capabilities help DevOps teams avoid downtime, resolve performance issues, and ensure customers are getting the best user experience.

Authenticating

Datadog uses API Key and API Secret Based Auth, a developer-friendly delegated access protocol. Quolum has already connected the necessary wires with Datadog. Using a sequence of click-throughs, your organization's administrator allows Quolum to make API calls to Datadog without getting access to passwords.

Step 1: Initiate a connection to Datadog

Click the Connect button from the Connections card. If you are not an admin, you can invite your organization's Datadog admin to make a connection to your Datadog organization account. When you click on the Connect button, the web browser will navigate to the Datadog login page.

2310

Quolum Catalog: Datadog App

Step 2: Log in to Datadog

Log in to Datadog using your organization's credentials. The exact login mechanism may depend on your Datadog plan, and the sign-in mechanism used. You may have corporate SSO such as Azure AD, GSuite, or Okta along with multi-factor authentication. Sometimes you may need to enter a Personal Access Token, the step by step details of which can be found at Datadog API . Once you have successfully logged-in you can find the API Key and API Secret as mentioned below in Step 3.

1169

Datadog Authentication

Step 3: Finding the API Key and API Secret in Datadog

Step 3.1: Hover on your account name on the bottom left of the page as shown below

2880

Datadog Homepage

Step 3.2: Click on "Organization Settings" on the navbar that opens up

2880

Datadog Organization Settings

Step 3.3: Click on "API Keys" Tab to create a new API Key or to use an already existing key

2880

Datadog API Keys page

Step 3.3: Click on "Application Keys" Tab to create a new Application Key or to use an already existing key

2880

Datadog Application Keys page

Step 3.5: Copy the App Key and Application Key and use it to connect your application right away.

Note:

  1. The created application key needs to have the following scopes as shown in the screenshot.
  • usage_read
  • events_read
  • metrics_read
  • timeseries_query
  1. Before starting to connect, please check the role of the person creating API key and Application Key. Read Only Role and Standard Role can’t create keys and connect Datadog on Quolum dashboard. That can only be done by Datadog Admin Role as shown below, while creating the Application Key from the Datadog dashboard.

Step 4: Provide consent to Quolum

The next screen after login into Datadog is the consent screen. On this screen, Datadog confirms whether you authorize Quolum to access your organization's data.

Step 5: Back to Quolum

Once you have granted access to Quolum on Datadog website, Datadog is going to send you back to Quolum's page in Step 1, where you started. The Connect button on the Connections card would now say Reconnect. Reconnect is used to reauthenticate under circumstances where the access has expired.

Under the hood

Using the OAuth protocol, Quolum now has delegated access to your Datadog Workspace. The Quolum server, running on Amazon AWS VPC, will be able to make API calls and retrieve feature-level utilization. Later, this data is crunched and available for visualization on the Quolum dashboard.