Datadog

Overview

Firefly integrates with Datadog to pull in information like monitors, dashboards, and alerts as "assets". This means in your Firefly Inventory, you'll see Datadog monitors listed (with their configurations) just like cloud assets. You can then enforce IaC or policies on them as well (for example, ensuring all monitors follow a naming convention).

Prerequisites

• A Datadog API Key (and possibly an Application Key) from your Datadog account

• Ensure the API key has read permissions on Datadog data (usually Admin or standard API key is fine since Datadog doesn't have granular read roles)

• Access to Datadog's API Keys and Application Keys sections

Setup Procedure

1. In Firefly, select Add New > Datadog

2. In Datadog's UI, go to API Keys section to create a new key

3. Copy those into Firefly's integration form

4. Select your Datadog site, and select Next

Creating API Keys

Application Key

1. Navigate to Datadog Application Keys
2. From the upper-right corner, select New Key

3. Copy and paste the application key into the box

API Key

1. Navigate to Datadog API Keys
2. Create a new API key

3. Copy and paste the API key into the box

Configuration Details

• Firefly scans every 8 hours by default for SaaS data

• Your Datadog monitors list will stay updated automatically

• You can enforce IaC or policies on your Datadog assets

• Supports monitoring of Datadog monitors, dashboards, and alerts

Best Practices

1. Use dedicated API keys for Firefly integration

2. Regularly rotate API keys for security

3. Monitor API key usage in Datadog

4. Keep track of which Datadog assets are being monitored

5. Review and update policies as needed

Troubleshooting

1. For API key issues:

   • Verify API key permissions

   • Check if the key has expired

   • Ensure the key has the correct access level

2. For asset discovery issues:

   • Verify the integration is active in Firefly

   • Check if the API key has access to the required resources

   • Review Firefly integration logs

3. For policy enforcement issues:

   • Verify the asset types are supported

   • Check policy configuration

   • Review Firefly policy logs