Datadog

Connect your AI agents to Datadog.

Available Tools

list_dashboards

List all visualization dashboards for monitoring infrastructure, applications, and business metrics.

create_dashboard

Create a new visualization dashboard with custom widgets for monitoring metrics, logs, and application performance.

get_dashboard

Get detailed dashboard configuration including all widgets, layout, and template variables by ID.

update_dashboard

Update existing dashboard configuration including title, widgets, layout, and template variables.

delete_dashboard

Permanently delete a dashboard by ID removing all widgets and configuration.

list_downtimes

List all scheduled downtimes with filtering and pagination.

create_downtime

Create a scheduled downtime for maintenance windows. Specify scope, start/end times, and optional message. Returns created downtime with ID. Error: Check scope format and timestamps if creation fails.

get_downtime

Get a specific downtime by ID with full configuration. Returns downtime schedule, scope, and status. Error: Use list_downtimes to find valid downtime IDs if not found.

update_downtime

Update an existing downtime’s configuration including scope, time range, or message.

delete_downtime

Delete a downtime schedule permanently by ID. This removes the maintenance window. Returns confirmation with deleted downtime ID. Error: Verify downtime_id with list_downtimes if deletion fails.

list_incidents

List all incidents with pagination.

create_incident

Create a new incident with title and impact status.

search_incidents

Search incidents with advanced query filters. Supports filtering by state, severity, customer impact, and custom fields. Returns matching incidents. Error: Check query syntax if search fails.

list_log_indexes

List all log indexes with filtering and pagination.

list_metrics

List all active metrics being reported to Datadog.

get_metric

Get metadata for a specific metric including type, description, and unit. Provide the metric name to retrieve details. Error: Use list_metrics to find valid metric names if not found.

update_metric

Update metadata for a metric including description, type, and unit. Provide metric name and fields to update. Returns updated metric metadata. Error: Use get_metric first to verify metric exists.

query_timeseries

Query timeseries data for metrics over a time range.

submit_metrics

Submit custom metric data points to Datadog.

list_monitors

List all monitoring alerts with filtering and pagination.

create_monitor

Create a new monitoring alert with thresholds and notification settings.

get_monitor

Get a specific monitor by ID with full configuration details. Returns monitor with thresholds, query, message, and current state. Error: Use list_monitors to find valid monitor IDs if not found.

update_monitor

Update an existing monitor’s configuration including query, thresholds, or notification settings.

delete_monitor

Delete a monitor permanently by ID. This removes all alert configuration and history. Returns confirmation with deleted monitor ID. Error: Verify monitor_id with list_monitors if deletion fails.

mute_monitor

Mute a monitor to suppress notifications temporarily or indefinitely for maintenance windows.

unmute_monitor

Unmute a previously muted monitor to resume sending notifications. Specify optional scope to unmute. Error: Use list_monitors to find muted monitors.

list_roles

List all roles with pagination (admin-only: requires user_access_manage permission).

create_role

Create a new custom role (admin-only: requires user_access_manage permission). Specify unique role name. Returns created role with ID. Error: Check role name uniqueness if creation fails.

get_role

Get role details by ID (admin-only: requires user_access_manage permission). Returns role with name, user count, and timestamps. Error: Use list_roles to find valid role IDs if not found.

update_role

Update role name and description (admin-only: requires user_access_manage permission). Provide role_id and new name. Returns updated role. Error: Use get_role first to verify role exists.

delete_role

Delete custom role permanently by ID (admin-only: requires user_access_manage permission).

list_role_permissions

List permissions for a role (admin-only: requires user_access_manage permission). Returns permission IDs, names, descriptions, and categories. Error: Use list_roles to find valid role IDs.

add_role_permission

Grant permission to role (admin-only: requires user_access_manage permission).

remove_role_permission

Revoke permission from role (admin-only: requires user_access_manage permission).

get_role_users

List users with this role (admin-only: requires user_access_manage permission). Returns user IDs assigned to the role. Error: Use list_roles to find valid role IDs.

add_user_to_role

Assign user to role (admin-only: requires user_access_manage permission). Provide role_id and user_id. Returns updated user list for role. Error: Use list_users to find valid user IDs.

remove_user_from_role

Remove user from role (admin-only: requires user_access_manage permission). Provide role_id and user_id. Returns updated user list for role. Error: Use get_role_users to find assigned users.

list_all_permissions

List all available permissions in Datadog. Returns permission IDs, names, descriptions, and categories for role assignment. Error: Check API credentials if no permissions returned.

search_permissions

Search permissions by keyword. Provide search query to filter permissions by name or description. Returns matching permissions. Error: Try broader search terms if no results found.

list_synthetics_tests

List all synthetic monitoring tests with pagination.

create_synthetics_test

Create a new synthetic monitoring test (API or browser test).

list_global_variables

List all global variables for synthetics tests with pagination.

create_global_variable

Create a new global variable for reuse across synthetics tests.

list_all_locations

List all available testing locations for synthetics tests.

list_users

List all users with filtering and pagination (admin-only: requires user_access_manage permission).

create_user

Create a new user account (admin-only: requires user_access_manage permission).

update_user

Update user profile including name, email, or disabled status (admin-only: requires user_access_manage permission).

send_user_invitations

Send email invitations to new users (admin-only: requires user_access_manage permission). Provide list of email addresses. Returns invitation results. Error: Check email format if invitation fails.

validate_credential

Validate Datadog API credentials by testing authentication with a lightweight API call