Skip to main content

Datadog Setup Guide

Prerequisites

Make sure you have an active Datadog account.

Setup Guide

Step 1: Select Data Center

  1. If your Datadog site URL is https://app.datadoghq.eu, select EU.
  2. If your Datadog site URL is https://app.datadoghq.com, select US1.
  3. If your Datadog site URL is https://us3.datadoghq.com, select US3.
  4. If your Datadog site URL is https://us5.datadoghq.com, select US5.
  5. If your Datadog site URL is https://app.ddog-gov.com, select US1-FED.
  6. If your Datadog site URL is https://ap1.datadoghq.com, select AP1 (Japan).

Step 2: Add an Application + API Key

  1. Log in to your Datadog account.
  2. Open the site and locate Organization Settings -> Application Keys.
  3. Click New Key
  4. Go to Organization Settings -> API Keys.
  5. Click Create API Key.
  6. Enter a descriptive name for your API Key like Matia-Integration and click Create.
  7. Copy the generated Applicatioion and API Tokens - you will need it to configure your connection.

Step 3: Add Application Scopes

Add the scopes you need to authorize the application key:

  • dashboards_read
  • apm_retention_filter_read
  • apm_pipelines_read
  • audit_logs_read
  • aws_configuration_read
  • azure_configuration_read
  • ci_visibility_read
  • cloud_cost_management_read
  • integrations_read
  • monitors_downtime
  • events_read
  • gcp_configuration_read
  • hosts_read
  • teams_read
  • incident_read
  • org_management
  • logs_read_archives
  • logs_read_config
  • user_access_read
  • rum_apps_read
  • security_monitoring_rules_read
  • security_monitoring_filters_read
  • data_scanner_read
  • apm_service_catalog_read
  • slos_read
  • synthetics_read
  • metrics_read
  • synthetics_global_variable_read
  • usage_read

Step 4: Complete Configuration in Matia

  1. In Matia, enter your API Key and Application Key in the connector configuration.
  2. Select the Data Center You located in Step 1.
  3. Enter a Name for the connector.
  4. (Optional) Enter a Description.
  5. (Optional) Assign Tags.
  6. Select an Owner.
  7. Verify that your Datadog account is successfully connected by clicking on Test Connection.
  8. Click Connect