Datadog

An integration guide for Datadog.

Overview

Datadog is a powerful monitoring and analytics platform that provides comprehensive insights into your application's performance and infrastructure. By integrating Datadog with Rely.io's platform, you can leverage the telemetry data collected you host within Datadog in Rely's platform.

Installation Guide

To get started with the Datadog integration, follow the steps below.

1. Generate Keys

Before you can connect Rely.io to Datadog, you need to generate the required API and Application Keys. The following guide was based on the official documentation provided by Datadog.

API Keys

  1. Log in to your Datadog account.

  2. Navigate to the API Keys section in your account settings.

  3. Click on the "New Key" button.

  4. Enter a name for your API key.

  5. Click "Create API key" to generate the key.

Application Keys

Application keys, in conjunction with your organization's API key, provide access to Datadog's programmatic API. They are associated with the user account that created them and have the permissions and scopes of the user by default. To generate an application key, please follow these steps:

  1. Log in to your Datadog account.

  2. Go to the Application Keys section in your account settings.

  3. Click on the "New Key" button.

  4. Enter a name for your application key.

  5. Leave the key scopes empty

  6. Click "Create Application key" to generate the key.

2. Determine Datadog Site

Datadog offers different sites throughout the world, each one being completely independent. To successfully enable Rely.io to retrieve information from Datadog, it's crucial to determine the site where your data is housed.

You can identify which site you are on by matching your Datadog website URL to the site URL in the table below. For more information, reference the official documentation provided by Datadog.

SITESITE URLSITE PARAMETERLOCATION

US1

https://app.datadoghq.com

datadoghq.com

US

US3

https://us3.datadoghq.com

us3.datadoghq.com

US

US5

https://us5.datadoghq.com

us5.datadoghq.com

US

EU1

https://app.datadoghq.eu

datadoghq.eu

EU

US1-FED

https://app.ddog-gov.com

ddog-gov.com

US

AP1

https://ap1.datadoghq.com

ap1.datadoghq.com

Japan

3. Connect to the Rely Platform

Now that you have generated the necessary keys, you can proceed to connect your Datadog account with Rely.

Open the Rely platform and start by navigating to the data-sources page. Click the "Add Data Source" button and select "Datadog".

This will prompt a modal to appear asking you for the information necessary to successfully integrate Datadog with your Rely.io account.

Fill in the required input fields:

  • Collector Name: Enter a name for the collector.

  • API Key: Paste the API key generated in the previous step.

  • App Key: Paste the application key generated in the previous step.

  • Site: Specify the Datadog site where your data is hosted.

Click Create to finish the integration process.

After you submit your form, an entity discovery run will be kickstarted that can take a few minutes. By the end of this discovery run:

  • New blueprints will be added to your data model

  • Entities will be queries from the data-source and added to your software catalog

  • These entities will be periodically updated to ensure they remain in sync with their external counter-parts

Congratulations! You have successfully set up the Datadog integration for Rely.io's platform.

Last updated