Datadog Integration

The Datadog integration allows Velocity to ingest Datadog information for monitoring and insights

Follow these steps in your Datadog account to obtain both the application and API keys to configure the Velocity integration.

Step 1 - Generate an API Key

1. Navigate to Organization settings, then click API keys.

1. Click the New Key.

2. Enter a name for your key.

3. Click Create API key.

Step 2 - Generate an Application Key for a Velocity Service Account

If the "New Role" button (1.b below) isn’t visible, you might need to enable custom roles. Click the cog wheel and select "Enable". Check out Datadog's documentation for further guidance.

1. Create a new role

   1. Navigate to Organization settings, then click Roles (under the ACCESS section)

   2. Click "+ New Role" at the top right

   3. Enter a name for the new role - Velocity Service Account Role

   4. Select the following permissions

      1. Monitors Read

      2. Monitors Write (enables Velocity to connect with existing monitors)

      3. Integrations Manage (enables the creation of the Velocity webhook)

      4. Integrations Read

      5. APM Read

      6. Synthetics Read

      7. Synthetics Write (enables Velocity to connect with existing synthetics)

      8. Logs Read Index Data

      9. Logs Read Data

      10. Dashboards Read

      11. Incidents Read

      12. Cases Read

      13. Service Catalog Read

   5. Click Save

2. Create a new Service Account

   1. Navigate to Organization settings, then click Service Accounts (under the Identity & Accounts section)

   2. Click "+ New Service Account" at the top right

   3. Enter a name for the new role, for example, Velocity Service Account

   4. Enter your corporate email address

   5. Assign the role created previously, Velocity Service Account Role

   6. Click Create Service Account

3. Create a new Service Account Token

   1. Navigate to Organization settings, then click Service Accounts (under the Identity & Accounts section)

   2. Click the Service Account we previously created, Velocity Service Account

   3. Click "+ New Key"

   4. Enter a name for the new key, for example, Velocity Service Account App Key

   5. Click Create Key

   6. Keep the "Not Scoped" configuration

   7. Copy the new key to your clipboard

Step 3 - Get your Datadog site name

Following Datadog's guideline here to get your site name

Step 4 - Share information with Velocity

Submit the application key, API key and site name on our web app integration page - https://app.velocity.tech/next/integrations/datadog