# Datadog

```json
{
  "name": "Datadog",
  "slug": "datadog",
  "url": "https://composio.dev/toolkits/datadog",
  "markdown_url": "https://composio.dev/toolkits/datadog.md",
  "logo_url": "https://logos.composio.dev/api/datadog",
  "categories": [
    "developer tools & devops"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:08:17.883Z"
}
```

![Datadog logo](https://logos.composio.dev/api/datadog)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Datadog MCP or direct API to analyze logs, trigger alerts, fetch metrics, and investigate incidents through natural language.

## Summary

Datadog is a cloud monitoring and observability platform for applications and infrastructure. It helps teams detect issues and optimize performance by unifying metrics, logs, and traces.

## Categories

- developer tools & devops

## Toolkit Details

- Tools: 42

## Images

- Logo: https://logos.composio.dev/api/datadog

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Datadog.
  - Setup:
    - Configure Oauth2 credentials for Datadog.
    - Use the credentials when creating an auth config in Composio.
- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Datadog.
  - Setup:
    - Configure Api Key credentials for Datadog.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Create downtime for nightly maintenance window
- List all monitors tracking CPU usage
- Create synthetic API test for login endpoint
- Get details of production dashboard

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `DATADOG_CREATE_DASHBOARD` | Create Dashboard | Create a dashboard in Datadog. Dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view. |
| `DATADOG_CREATE_DOWNTIME` | Create downtime | Creates a new downtime in Datadog to suppress alerts during maintenance windows or planned outages. Useful for preventing false alarms during deployments or maintenance. |
| `DATADOG_CREATE_EVENT` | Create event | Creates a new event in Datadog. Events are useful for tracking deployments, outages, configuration changes, and other important occurrences. |
| `DATADOG_CREATE_MONITOR` | Create monitor | Creates a new Datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications. |
| `DATADOG_CREATE_SLO` | Create SLO | Create a Service Level Objective (SLO) in Datadog. SLOs help you define and track reliability targets for your services, enabling data-driven decisions about service quality and reliability investments. |
| `DATADOG_CREATE_SYNTHETIC_API_TEST` | Create Synthetic API Test | Create a synthetic API test in Datadog. Creates a new synthetic API test that continuously monitors API endpoints from multiple locations worldwide. Useful for proactive monitoring of API uptime, performance, and functionality. |
| `DATADOG_CREATE_WEBHOOK` | Create Webhook | Create a webhook in Datadog. Registers a named destination endpoint; each monitor must explicitly reference the webhook by name in its message or notification settings for alerts to be delivered. |
| `DATADOG_DELETE_DASHBOARD` | Delete Dashboard | Delete a dashboard in Datadog. Permanently removes a dashboard from your organization. This action cannot be undone. Use with caution. |
| `DATADOG_DELETE_MONITOR` | Delete monitor | Deletes a Datadog monitor permanently. Use with caution as this action cannot be undone. |
| `DATADOG_GET_DASHBOARD` | Get Dashboard | Get a specific dashboard from Datadog. Retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata. |
| `DATADOG_GET_MONITOR` | Get monitor | Retrieves detailed information about a specific Datadog monitor, including its current state, configuration, and any active downtimes. |
| `DATADOG_GET_SERVICE_DEPENDENCIES` | Get Service Dependencies | Get service dependency mapping from Datadog APM. This action retrieves the dependency graph for a specific service, showing both upstream services (that call this service) and downstream services (that this service calls). It's essential for: - Understanding the blast radius of service failures - Identifying critical dependencies during incidents - Analyzing service communication patterns - Planning architectural changes - Monitoring service health in context The dependency information includes call rates, error rates, and latency metrics to help assess the health of service relationships. Requires APM instrumentation on the target service; uninstrumented services return empty or incomplete dependency data. |
| `DATADOG_GET_SYNTHETICS_LOCATIONS` | Get Synthetics Locations | Tool to retrieve all available public and private locations for Synthetic tests in Datadog. Use when you need a list of location identifiers for creating or managing synthetic tests. |
| `DATADOG_GET_TAGS` | Get host tags | Retrieves all tags associated with a specific host in Datadog. Useful for understanding host metadata and organizing infrastructure. |
| `DATADOG_GET_USAGE_SUMMARY` | Get usage summary | Retrieves usage summary information from Datadog including API calls, hosts, containers, and other billable usage metrics. Useful for cost monitoring and usage analysis. Months with no activity return empty payloads on success; absent data is expected, not an error. |
| `DATADOG_LIST_ALL_TAGS` | List All Tags | List all tags from Datadog. Tags help organize and filter your infrastructure and applications. This action shows all tags in use across your organization. |
| `DATADOG_LIST_API_KEYS` | List API Keys | List API keys in Datadog. Retrieves all API keys in the organization for security auditing, access management, and key rotation planning. Helps maintain security posture by tracking key usage and ownership. Response contains sensitive key metadata (names, owners, last-used timestamps); restrict tool access to authorized personnel and handle output securely. |
| `DATADOG_LIST_APM_SERVICES` | List APM Services | List APM services from Datadog. Application Performance Monitoring (APM) provides deep visibility into your applications, helping you track performance, errors, and dependencies. |
| `DATADOG_LIST_AWS_INTEGRATION` | List AWS Integration | List AWS integrations in Datadog. Retrieves all configured AWS account integrations, showing which AWS accounts are monitored by Datadog and their configuration settings. Useful for cloud infrastructure management and ensuring comprehensive monitoring coverage. |
| `DATADOG_LIST_DASHBOARDS` | List dashboards | Lists all Datadog dashboards with basic information. Useful for dashboard management and getting an overview of available dashboards. |
| `DATADOG_LIST_EVENTS` | List events | Lists events from Datadog within a specified time range. Events track important occurrences like deployments, outages, and configuration changes. Combining multiple filters (tags, sources, priority) with narrow time ranges may return empty results even when events exist — start with broad filters and narrow incrementally. Large time ranges with minimal filtering can return very high event volumes; tune tags, sources, and start/end before processing results. |
| `DATADOG_LIST_HOSTS` | List hosts | Lists all hosts in your Datadog infrastructure with detailed information including metrics, tags, and status. Useful for infrastructure monitoring and management. |
| `DATADOG_LIST_INCIDENTS` | List Incidents | List incidents from Datadog. Incident Management helps you track, manage, and resolve incidents efficiently with comprehensive timeline and impact tracking. |
| `DATADOG_LIST_LOG_INDEXES` | List Log Indexes | Tool to retrieve a list of all log indexes configured in Datadog, including their names and configurations. Use before DATADOG_SEARCH_LOGS to identify the correct index name; searching without specifying the right index can hide valid logs and increase usage costs across high-volume indexes. |
| `DATADOG_LIST_METRICS` | List active metrics | Discover metric names by listing actively reporting metrics since a given timestamp. Use when you need to find what metrics exist before querying timeseries data with DATADOG_QUERY_METRICS. |
| `DATADOG_LIST_MONITORS` | List monitors | Get all monitor details. This endpoint allows you to retrieve information about all monitors configured in your organization. You can filter by group states, name, tags, and use pagination to manage large result sets. |
| `DATADOG_LIST_ROLES` | List Roles | List roles from Datadog organization. Roles define sets of permissions that control what users can do within your Datadog organization. |
| `DATADOG_LIST_SERVICE_CHECKS` | List service checks | Lists service checks from Datadog. Service checks are status checks that track the health of your services and infrastructure components. |
| `DATADOG_LIST_SL_OS` | List SLOs | List Service Level Objectives (SLOs) from Datadog. Service Level Objectives help you track the reliability and performance of your services by setting measurable targets for key metrics. |
| `DATADOG_LIST_SYNTHETICS` | List Synthetics Tests | List Synthetics tests from Datadog. Synthetics monitoring allows you to proactively monitor your applications and APIs by simulating user interactions and API calls from various locations. |
| `DATADOG_LIST_USERS` | List Users | List users from Datadog organization. User management allows you to see team members, their roles, and access levels within your Datadog organization. |
| `DATADOG_LIST_WEBHOOKS` | List Webhooks | List webhooks from Datadog. Webhooks allow you to send notifications to external services when monitors trigger, enabling integration with your workflows. |
| `DATADOG_MUTE_MONITOR` | Mute Monitor | Mute a monitor in Datadog. Temporarily silences alerts from a monitor, which is useful during maintenance windows, deployments, or when investigating known issues to prevent alert fatigue. |
| `DATADOG_QUERY_METRICS` | Query metrics | Queries Datadog metrics and returns time series data. Useful for retrieving historical metric data, creating custom dashboards, or building reports. |
| `DATADOG_SEARCH_LOGS` | Search logs | Searches Datadog logs with advanced filtering capabilities. IMPORTANT NOTES: - Sort parameter is NOT supported by the Datadog Logs API and will cause errors - Time parameters must be in milliseconds (13-digit UNIX timestamps) - Limit parameter is passed as string to the API - Log content is nested under 'content' field in API response Useful for troubleshooting, monitoring application behavior, and analyzing log patterns. |
| `DATADOG_SEARCH_SPANS_ANALYTICS` | Search Spans Analytics | Search and analyze span data with aggregations in Datadog. This action uses the Datadog Spans Analytics API to perform advanced queries and aggregations on trace span data. It's essential for: - Analyzing error rates and latency patterns - Understanding service dependencies and bottlenecks - Root cause analysis during incidents - Performance monitoring and optimization The API supports complex queries with grouping, filtering, and various aggregation functions similar to log analytics. The request body must conform to the `aggregate_request` schema; schema violations return "Invalid type. Expected 'aggregate_request'". If `filter` or `compute` cannot satisfy this schema, use basic trace search instead. |
| `DATADOG_SEARCH_TRACES` | Search Traces | Search for traces in Datadog APM. This action allows you to search for distributed traces across your services. It's essential for: - Finding specific request flows during incident investigation - Analyzing performance bottlenecks across services - Understanding error propagation through your system - Correlating user requests with backend operations Traces provide the complete picture of a request as it travels through your distributed system, making them crucial for root cause analysis. |
| `DATADOG_SUBMIT_METRICS` | Submit metrics | Submits custom metrics to Datadog. Useful for sending application-specific metrics, business KPIs, or custom performance indicators. |
| `DATADOG_UNMUTE_MONITOR` | Unmute Monitor | Unmute a monitor in Datadog. Re-enables alerts from a previously muted monitor, returning it to normal monitoring and alerting behavior. Alerting resumes immediately upon call, so ensure maintenance or issue resolution is fully complete before unmuting to avoid alert storms. Use this after maintenance windows or issue resolution to resume monitoring. |
| `DATADOG_UPDATE_DASHBOARD` | Update Dashboard | Update a dashboard in Datadog. Updates an existing dashboard with new configuration, widgets, or layout while preserving its identity and creation metadata. |
| `DATADOG_UPDATE_HOST_TAGS` | Update host tags | Updates tags for a specific host in Datadog. This replaces all existing tags from the specified source with the new tags provided. |
| `DATADOG_UPDATE_MONITOR` | Update monitor | Updates an existing Datadog monitor with new configuration, thresholds, or notification settings. Only specified fields will be updated. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Datadog Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Datadog actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a monitor to alert on high CPU usage'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a monitor to alert on high CPU usage'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Datadog tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a new monitor for CPU usage above 80%')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a new monitor for CPU usage above 80%' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Datadog Integration

- Supports both Datadog MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Datadog data

### 2. Managed Auth

- Built-in API key handling with secure storage
- Central place to manage, scope, and revoke Datadog access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Datadog
- Scoped, least privilege access to Datadog resources
- Full audit trail of agent actions to support review and compliance

## Use Datadog with any AI Agent Framework

Choose a framework you want to connect Datadog with:

- [ChatGPT](https://composio.dev/toolkits/datadog/framework/chatgpt)
- [OpenAI Agents SDK](https://composio.dev/toolkits/datadog/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/datadog/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/datadog/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/datadog/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/datadog/framework/codex)
- [Cursor](https://composio.dev/toolkits/datadog/framework/cursor)
- [VS Code](https://composio.dev/toolkits/datadog/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/datadog/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/datadog/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/datadog/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/datadog/framework/cli)
- [Google ADK](https://composio.dev/toolkits/datadog/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/datadog/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/datadog/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/datadog/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/datadog/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/datadog/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/datadog/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/datadog/framework/autogen)

## Related Toolkits

- [Supabase](https://composio.dev/toolkits/supabase) - Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.
- [Codeinterpreter](https://composio.dev/toolkits/codeinterpreter) - Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.
- [GitHub](https://composio.dev/toolkits/github) - GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.
- [Ably](https://composio.dev/toolkits/ably) - Ably is a real-time messaging platform for live chat and data sync in modern apps. It offers global scale and rock-solid reliability for seamless, instant experiences.
- [Abuselpdb](https://composio.dev/toolkits/abuselpdb) - Abuselpdb is a central database for reporting and checking IPs linked to malicious online activity. Use it to quickly identify and report suspicious or abusive IP addresses.
- [Alchemy](https://composio.dev/toolkits/alchemy) - Alchemy is a blockchain development platform offering APIs and tools for Ethereum apps. It simplifies building and scaling Web3 projects with robust infrastructure.
- [Algolia](https://composio.dev/toolkits/algolia) - Algolia is a hosted search API that powers lightning-fast, relevant search experiences for web and mobile apps. It helps developers deliver instant, typo-tolerant, and scalable search without complex infrastructure.
- [Anchor browser](https://composio.dev/toolkits/anchor_browser) - Anchor browser is a developer platform for AI-powered web automation. It transforms complex browser actions into easy API endpoints for streamlined web interaction.
- [Apiflash](https://composio.dev/toolkits/apiflash) - Apiflash is a website screenshot API for programmatically capturing web pages. It delivers high-quality screenshots on demand for automation, monitoring, or reporting.
- [Apiverve](https://composio.dev/toolkits/apiverve) - Apiverve delivers a suite of powerful APIs that simplify integration for developers. It's designed for reliability and scalability so you can build faster, smarter applications without the integration headache.
- [Appcircle](https://composio.dev/toolkits/appcircle) - Appcircle is an enterprise-grade mobile CI/CD platform for building, testing, and publishing mobile apps. It streamlines mobile DevOps so teams ship faster and with more confidence.
- [Appdrag](https://composio.dev/toolkits/appdrag) - Appdrag is a cloud platform for building websites, APIs, and databases with drag-and-drop tools and code editing. It accelerates development and iteration by combining hosting, database management, and low-code features in one place.
- [Appveyor](https://composio.dev/toolkits/appveyor) - AppVeyor is a cloud-based continuous integration service for building, testing, and deploying applications. It helps developers automate and streamline their software delivery pipelines.
- [Backendless](https://composio.dev/toolkits/backendless) - Backendless is a backend-as-a-service platform for mobile and web apps, offering database, file storage, user authentication, and APIs. It helps developers ship scalable applications faster without managing server infrastructure.
- [Baserow](https://composio.dev/toolkits/baserow) - Baserow is an open-source no-code database platform for building collaborative data apps. It makes it easy for teams to organize data and automate workflows without writing code.
- [Bench](https://composio.dev/toolkits/bench) - Bench is a benchmarking tool for automated performance measurement and analysis. It helps you quickly evaluate, compare, and track your systems or workflows.
- [Better stack](https://composio.dev/toolkits/better_stack) - Better Stack is a monitoring, logging, and incident management solution for apps and services. It helps teams ensure application reliability and performance with real-time insights.
- [Bitbucket](https://composio.dev/toolkits/bitbucket) - Bitbucket is a Git-based code hosting and collaboration platform for teams. It enables secure repository management and streamlined code reviews.
- [Blazemeter](https://composio.dev/toolkits/blazemeter) - Blazemeter is a continuous testing platform for web and mobile app performance. It empowers teams to automate and analyze large-scale tests with ease.
- [Blocknative](https://composio.dev/toolkits/blocknative) - Blocknative delivers real-time mempool monitoring and transaction management for public blockchains. Instantly track pending transactions and optimize blockchain interactions with live data.

## Frequently Asked Questions

### Do I need my own developer credentials to use Datadog with Composio?

Yes, Datadog requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)