Setup your Datadog integration and get all the insights in Torii's dashboard

Overview

Torii integrates with Datadog and syncs users' names, emails, statuses, roles, and licenses.

Note that Torii can sync multiple Datadog accounts.

API Key vs. Application Key

Datadog has two different key types, and the Torii integration needs both. They are created on two separate pages, and they are not interchangeable.

Quick check: if both values you copied are the same length, you most likely copied the same key twice. The API Key is the shorter one.

Tip: create the Application Key from a Datadog service account rather than from a personal user account. Datadog cannot transfer an application key between users, so a key owned by an employee who later leaves will break the integration.

Prerequisites

The integration requires the following from your account:

1. Datadog API URL
   Your Datadog API URL is based on the Datadog site you are hosted on.
   
   For example: for site US1 the URL is https://api.datadoghq.com.
   If you are unsure, this is usually the correct one.
   
2. API Key
   In Datadog, go to Organization Settings > API Keys, create a new API key (or reuse an existing one), and copy its value.
   API keys have no scopes — there is nothing to configure here.
   
3. Application Key
   In Datadog, go to Organization Settings > Application Keys, create a new application key, and copy its value. The full value is shown only once, at creation time.
   
   
   Scopes: leaving the key unscoped is the simplest option — it then inherits the permissions of the user who created it. If your security policy requires a scoped key, select:
   For a read-only integration: user_access_read.
   For a read and take action integration, add: user_access_invite and user_access_manage.
   
   The org_management scope is optional. Provide it to let Torii detect your organization name automatically; otherwise enter the organization name manually (see below).
4. Organization Name (optional)
   If you prefer not to provide the org_management scope, you can instead manually enter your Datadog organization name.
   This field is optional, but if used, make sure to enter the organization name exactly as it appears in your Datadog account.

Connect Datadog integration to Torii

1. Go to the Integrations page and select the Datadog tile.
2. Click Connect to Datadog
   
3. In the Connect Datadog window, enter your Datadog API URL, API Key, and Application Key. Make sure each key goes into its matching field — swapping them is the most common cause of a failed connection.
   If you are not providing the org_management scope, please fill in the Organization Name field manually.
   
4. Click Connect
   
5. Once the integration is connected and synced, it will display a green checkbox.
   

Troubleshooting

Application Capabilities

You can constantly be updated with application information from our Integrations page >> Integration Capabilities button >> Integration Capabilities table.