Rely.io
Search
K

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.

Data Collected

  • Metric (Names, Labels and Time-series)
  • Service Catalog entries and linked dashboards

Features Unlocked

To know which features this plugin unlocks, checkout this table of features.

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
API keys are unique to your organization and are required by the Datadog Agents to submit metrics and events to Datadog. To generate an API key, please follow these steps:
  1. 1.
    Log in to your Datadog account.
  2. 2.
    Navigate to the API Keys section in your account settings.
  3. 3.
    Click on the "New Key" button.
  4. 4.
    Enter a name for your API key.
  5. 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. 1.
    Log in to your Datadog account.
  2. 2.
    Go to the Application Keys section in your account settings.
  3. 3.
    Click on the "New Key" button.
  4. 4.
    Enter a name for your application key.
  5. 5.
    Leave the key scopes empty
  6. 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.
SITE
SITE URL
SITE PARAMETER
LOCATION
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. You should now be able to see your Datadog data collector instance under the Active section of the Data Sources page. Wait a few minutes for the integration process to complete.
When the integration process is finished a green "Active" label will be displayed on the top left corner of your data source instance. When you see this label, it means your telemetry are available and ready to be used.
Congratulations! You have successfully set up the Datadog integration for Rely.io's platform.