Connecting Datadog

Datadog Setup

Onboarding your Datadog observability system involves three stages: Connect, Enable, and Configure webhooks.

Step 1: Connect

Establish connection to your Datadog remote MCP endpoint with account access credentials

1. Open the hamburger menu and select Settings

2. Scroll to the Available - Telemetry section. Press Register next to Datadog

3. Enter your Datadog MCP server details:

   • Server Name - Unique identifier (e.g., my-datadog-server)

   • Endpoint URL - Your Datadog MCP server endpoint (typically https://mcp.datadoghq.com/api/unstable/mcp-server/mcp)

   • Description - Optional server description

4. Click Next

5. Review and submit

Authorization

Complete OAuth authorization by:

• Authorizing as your user on the Datadog OAuth page

• If not logged in, click Allow, login, then authorize

Once configured, Datadog becomes available across all Agent spaces.

Step 2: Enable

Activate DataDog in a specific Agent space and configure appropriate scoping

1. From the agent spaces page, select an agent space and press view details (if you have not yet created an agent space see [REF])

2. Select the Capabilities tab

3. Scroll down to the Telemetry section

4. Press Add

5. Press radio button Available Sources

6. Select Radio button Datadog

7. Next

8. Review and press Save

9. Copy the Webhook URL and Webhook Secret

Step 3: Configure webhooks

Using the Webhook URL and Webhook Secret you can configure Data Dog to send events to trigger an investigation, for example from an alarm. To ensure that events sent can be used by the DevOps Agent, make sure that the data transmitted to the web hook matches the data schema specified below. Events that do not match this schema may be ignored by DevOps Agent. Set the method and the headers

    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer <Token>",
    },
    

Send the body as a JSON string.

{
    eventType: 'incident';
    incidentId: string;
    action: 'created' | 'updated' | 'closed' | 'resolved';
    priority: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW" | "MINIMAL";
    title: string;
    description?: string;
    timestamp?: string;
    service?: string;
    // The original event generated by service is attached here.
    data?: object;
}

Send webhooks with Datadog (note select no authorization and instead use the custom header option). Learn more: Datadog Remote MCP Server