#  Datadog

Connect your Datadog account to give Herald’s SRE agent real-time access to your observability data. During incident investigations, the agent can search logs, query timeseries metrics, and explore metric metadata — all directly from your Datadog environment — without you having to copy-paste data manually.

**The agent can:**

- Search and filter logs using Datadog query syntax
- Estimate log volumes before fetching full results
- Aggregate logs by facets (service, host, status, etc.)
- Query timeseries metrics and explore metric tags
- Inspect log indexes and processing pipelines to scope queries accurately

| Parameter           | Description                                                                                                                                                      |
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Base URL**        | Your Datadog API base URL. Must match your site region — using the wrong region will result in authentication errors. See the tip below for the correct URL.    |
| **API Key**         | A Datadog API key with read access. Create one under **Organization Settings > API Keys** in your Datadog dashboard.                                         |
| **Application Key** | A Datadog application key with read access. Create one under **Organization Settings > Application Keys**. Inherits the permissions of the user who created it — use a service account with read-only access when possible. |

**Optional parameters**

- _Rules / Instructions_: Free-form instructions that guide the agent on how to use this integration (e.g., "Only query the production log index" or "Focus on the payments-service when diagnosing errors").