Datadog

This guide provides step-by-step instructions for integrating your Datadog account with slaOS. This integration allows slaOS to collect metrics, logs, and other data from your Datadog account to monitor your services effectively.

The app.rated.co interface guides you step-by-step, all the way through to a successful Datadog integration!

Prerequisites

An active Datadog account with administrative access
Your slaOS account credentials

Integration Steps

Step 1: Create a Datadog API Key

Log in to your Datadog account.
Navigate to Organization Settings > API Keys.
On "API Keys" page click on "New Key".
Give your API key a name (e.g., slaOS Integration).
Copy the generated API key and store it securely.

Step 2: Create a Datadog Application Key

Still on the Organization Settings click on "Application Keys" and then "New Key".
Give your application key a name (e.g., slaOS App Key).
Under Scope, click "Edit" and add events_read. This alows slaOS to read event data from your Datadog account.
Copy the generated application key and store it securely.

Step 3: Provide Integration Details

You'll need to provide the following information to slaOS:

Datadog site (e.g., datadoghq.com for US1, datadoghq.eu for EU, etc.)
API Key
Application Key

During the onboarding process in the slaOS user interface, you'll be prompted to enter your Datadog secrets.
The slaOS system will automatically verify your credentials to ensure they have the necessary permissions.
Depending on your integration needs, slaOS will verify access to logs, metrics, or both.

If you're using a self-hosted version of slaOS, you'll need to manually add your Datadog credentials to the configuration file:

Locate your slaOS configuration YAML file.
Add the following section to your YAML file, replacing the placeholder values with your actual Datadog credentials:

datadog:
    site: datadoghq.com
    api_key: your_datadog_api_key
    app_key: your_datadog_app_key

For more detailed information about Datadog configuration in self-hosted environments, refer to the self-hosted page in our documentation. Alternatively, you can find example templates in our GitHub repository.

Step 4: Configure Log Parsing

To set up effective SLI queries, slaOS needs to understand which parts of your logs are most relevant to your service's performance metrics. Provide the following information:

Specific fields from your logs to use in SLI queries.
Data type of each field (e.g., string, integer, float, datetime).
The field that specifies the user (e.g., id, api_key) that the log event belongs to.
Any necessary transformations for these fields.

Frequently Asked Questions (FAQ)

How do I rotate my Datadog API or application keys?

Generate new keys in your Datadog account settings and update them in your slaOS integration settings. Be sure to revoke the old keys after confirming the new ones work.

What data does slaOS collect from my Datadog account?

slaOS collects event data as specified in your log parsing configuration. It does not collect or access any other data from your Datadog account.

How often does slaOS collect data from Datadog?

slaOS collects data in near real-time, typically with a delay of a few minutes depending on Datadog's own latency.

Can I limit the scope of data slaOS can access?

Yes! You can create a limited-scope API key in Datadog with only the necessary permissions. Consult the Datadog documentation for instructions on creating custom API keys:

API and Application KeysDatadog Infrastructure and Application Monitoring

For any additional questions or issues, please contact the slaOS support team on Slack.

PreviousCloudWatch NextComing soon

Last updated 11 months ago