Skip to main content

​
Overview

The Datadog integration enables you to automate monitoring and observability workflows within your organization. Connect Serval to Datadog to streamline incident response, automate metric collection, and manage your monitoring infrastructure programmatically.

Key Features

  • Access metrics and monitoring data
  • Query and analyze logs
  • Manage dashboards and monitors
  • Automate incident response workflows

Common Use Cases

  • Automated incident investigation
  • Metric-based workflow triggers
  • Log analysis and correlation
  • Dashboard creation and updates

​
Prerequisites

Before setting up the Datadog integration, ensure you have:
1

Datadog Account

An active Datadog account with appropriate permissions
2

API Key

A valid Datadog API key with the necessary scopes
3

Application Key

A Datadog application key for advanced API operations

​
Setup Instructions

​
Step 1: Generate Datadog API Credentials

  1. Log in to your Datadog account
  2. Navigate to Organization Settings → API Keys
  3. Click New Key
  4. Provide a descriptive name (e.g., “Serval Integration”)
  5. Copy the generated API key

​
Step 2: Configure Integration in Serval

  1. Navigate to the Integrations page in Serval
  2. Find Datadog and click Configure
  3. Enter your configuration details:
​
apiDomain
string
required
Your Datadog API domain (without https://). Look at your Datadog dashboard URL to determine your region. For example:
  • api.datadoghq.com
  • api.us3.datadoghq.com
​
apiKey
string
required
Your Datadog API key from Step 1. This authenticates all API requests.
​
applicationKey
string
required
Your Datadog application key from Step 1. Required for accessing metrics, logs, and other data.
  1. Click Submit to establish the integration
Integration configured! Serval will verify your credentials and establish the connection.

​
API Permissions

The Datadog integration requires specific permissions based on your use cases:
Required for: Reading metric data, querying time series
  • metrics_read - Query and retrieve metric data
  • timeseries_query - Query timeseries data.
Required for: Searching and analyzing log data
  • logs_read_data - Read log content
  • logs_read_index_data - Access log indexes
  • logs_read_archives - Read archived logs
Required for: Creating and managing alerts
  • monitors_read - View existing monitors
  • monitors_write - Create and modify monitors
  • monitors_downtime - Manage downtime schedules
Required for: Creating and updating dashboards
  • dashboards_read - View dashboard configurations
  • dashboards_write - Create and modify dashboards
  • dashboards_public_share - Share dashboards publicly

​
Best Practices

Query Optimization: When querying metrics, use appropriate time ranges and aggregations to minimize data transfer and improve performance.
API Key Security: Never expose your Datadog API keys in client-side code or public repositories. Always use Serval’s secure credential storage.

​
Additional Resources

Datadog API Documentation

Complete API reference for all Datadog endpoints

Permissions and Scopes

Comprehensive list of Datadog RBAC permissions and API scopes
Need help? Contact [email protected] for assistance with your Datadog integration.