Datadog

Learn how to use Datadog with Composio

Overview

Enum

DATADOG

Description

Datadog provides comprehensive monitoring, observability, and security for cloud-scale applications, unifying metrics, logs, traces, and more to help teams detect issues and optimize performance.

Authentication Details

api_key
stringRequired
app_key
stringRequired
region
stringRequired

Actions

Create a dashboard in datadog. dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view.

Action Parameters

description
string
is_read_only
boolean
layout_type
stringDefaults to ordered
notify_list
array
tags
array
template_variables
array
title
stringRequired
widgets
arrayRequired

Action Response

data
object
error
successful
boolean
Creates a new downtime in datadog to suppress alerts during maintenance windows or planned outages. useful for preventing false alarms during deployments or maintenance.

Action Parameters

end
integer
message
string
monitor_id
integer
monitor_tags
array
recurrence
object
scope
arrayRequired
start
integer
timezone
string

Action Response

data
object
error
successful
boolean
Creates a new event in datadog. events are useful for tracking deployments, outages, configuration changes, and other important occurrences.

Action Parameters

aggregation_key
string
alert_type
string
date_happened
integer
device_name
string
host
string
priority
string
source_type_name
string
tags
array
text
stringRequired
title
stringRequired

Action Response

data
object
error
successful
boolean
Creates a new datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications.

Action Parameters

message
string
name
stringRequired
options
object
priority
integer
query
stringRequired
tags
array
type
stringRequired

Action Response

data
object
error
successful
boolean
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.

Action Parameters

description
string
groups
array
monitor_ids
array
name
stringRequired
query
object
tags
array
thresholds
arrayRequired
type
stringRequired

Action Response

data
error
errors
slo_id
success
boolean
successful
boolean
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.

Action Parameters

config
objectRequired
message
string
name
stringRequired
options
objectRequired
status
stringDefaults to live
subtype
stringDefaults to http
tags
array
type
stringDefaults to api

Action Response

data
object
error
successful
boolean
Create a webhook in datadog. webhooks enable you to receive notifications from datadog monitors and alerts to external services and applications.

Action Parameters

custom_headers
string
encode_as
stringDefaults to json
name
stringRequired
payload
string
url
stringRequired

Action Response

data
object
error
successful
boolean
Delete a dashboard in datadog. permanently removes a dashboard from your organization. this action cannot be undone. use with caution.

Action Parameters

dashboard_id
stringRequired

Action Response

data
object
error
successful
boolean
Deletes a datadog monitor permanently. use with caution as this action cannot be undone.

Action Parameters

force
boolean
monitor_id
integerRequired

Action Response

data
object
error
successful
boolean
Get a specific dashboard from datadog. retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata.

Action Parameters

dashboard_id
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves detailed information about a specific datadog monitor, including its current state, configuration, and any active downtimes.

Action Parameters

group_states
array
monitor_id
integerRequired
with_downtimes
boolean

Action Response

data
object
error
successful
boolean
Retrieves all tags associated with a specific host in datadog. useful for understanding host metadata and organizing infrastructure.

Action Parameters

host_name
stringRequired
source
string

Action Response

data
object
error
successful
boolean
Retrieves usage summary information from datadog including api calls, hosts, containers, and other billable usage metrics. useful for cost monitoring and usage analysis.

Action Parameters

end_month
string
include_org_details
boolean
start_month
stringRequired

Action Response

data
object
error
successful
boolean
List all tags from datadog. tags help organize and filter your infrastructure and applications. this action shows all tags in use across your organization.

Action Parameters

source
string

Action Response

data
object
error
successful
boolean
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.

Action Parameters

filter_created_at_end
string
filter_created_at_start
string
filter_modified_at_end
string
filter_modified_at_start
string
page_number
integer
page_size
integer
sort
string

Action Response

data
array
error
meta
successful
boolean
total_count
integer
List apm services from datadog. application performance monitoring (apm) provides deep visibility into your applications, helping you track performance, errors, and dependencies.

Action Parameters

end
integer
env
string
limit
integerDefaults to 50
service
string
start
integer

Action Response

data
object
error
successful
boolean
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.

Action Parameters

account_id
string
role_name
string

Action Response

data
object
error
successful
boolean
Lists all datadog dashboards with basic information. useful for dashboard management and getting an overview of available dashboards.

Action Parameters

filter_deleted
boolean
filter_shared
boolean

Action Response

data
object
error
successful
boolean
Lists events from datadog within a specified time range. events track important occurrences like deployments, outages, and configuration changes.

Action Parameters

end
integerRequired
exclude_aggregate
boolean
page
integer
priority
string
sources
string
start
integerRequired
tags
array
unaggregated
boolean

Action Response

data
object
error
successful
boolean
Lists all hosts in your datadog infrastructure with detailed information including metrics, tags, and status. useful for infrastructure monitoring and management.

Action Parameters

count
integer
filter
string
from_timestamp
integer
include_hosts_metadata
boolean
include_muted_hosts_data
boolean
sort_dir
string
sort_field
string
start
integer

Action Response

data
object
error
successful
boolean
List incidents from datadog. incident management helps you track, manage, and resolve incidents efficiently with comprehensive timeline and impact tracking.

Action Parameters

filter_query
string
include
string
page_offset
integer
page_size
integerDefaults to 25
sort
stringDefaults to -created

Action Response

data
object
error
successful
boolean
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.

Action Parameters

group_states
array
id_offset
integer
monitor_tags
array
name
string
page
integer
page_size
integer
tags
array
with_downtimes
boolean

Action Response

data
object
error
successful
boolean
List roles from datadog organization. roles define sets of permissions that control what users can do within your datadog organization.

Action Parameters

filter_name
string
page_number
integer
page_size
integerDefaults to 10
sort
string

Action Response

data
object
error
successful
boolean
Lists service checks from datadog. service checks are status checks that track the health of your services and infrastructure components.

Action Parameters

check
string
end
integer
start
integer
status
string
tags
array

Action Response

data
object
error
successful
boolean
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.

Action Parameters

limit
integerDefaults to 25
offset
integer
query
string
tags
string

Action Response

data
object
error
successful
boolean
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.

Action Parameters

limit
integerDefaults to 50
locations
string
offset
integer
tags
string

Action Response

data
object
error
successful
boolean
List users from datadog organization. user management allows you to see team members, their roles, and access levels within your datadog organization.

Action Parameters

filter_status
string
page_number
integer
page_size
integerDefaults to 50
sort
string
sort_dir
stringDefaults to asc

Action Response

data
object
error
successful
boolean
List webhooks from datadog. webhooks allow you to send notifications to external services when monitors trigger, enabling integration with your workflows.

Action Parameters

limit
integerDefaults to 50

Action Response

data
object
error
successful
boolean
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.

Action Parameters

end
integer
monitor_id
integerRequired
override
boolean

Action Response

data
object
error
successful
boolean
Queries datadog metrics and returns time series data. useful for retrieving historical metric data, creating custom dashboards, or building reports.

Action Parameters

from_timestamp
integerRequired
query
stringRequired
to_timestamp
integerRequired

Action Response

data
object
error
successful
boolean
Searches datadog logs with advanced filtering capabilities. useful for troubleshooting, monitoring application behavior, and analyzing log patterns.

Action Parameters

index
string
limit
integer
query
stringRequired
sort
string
start_at
string
time_from
integerRequired
time_to
integerRequired

Action Response

data
object
error
successful
boolean
Submits custom metrics to datadog. useful for sending application-specific metrics, business kpis, or custom performance indicators.

Action Parameters

series
arrayRequired

Action Response

data
object
error
successful
boolean
Unmute a monitor in datadog. re-enables alerts from a previously muted monitor, returning it to normal monitoring and alerting behavior. use this after maintenance windows or issue resolution to resume monitoring.

Action Parameters

all_scopes
boolean
monitor_id
integerRequired

Action Response

data
object
error
successful
boolean
Update a dashboard in datadog. updates an existing dashboard with new configuration, widgets, or layout while preserving its identity and creation metadata.

Action Parameters

dashboard_id
stringRequired
description
string
is_read_only
boolean
layout_type
string
notify_list
array
tags
array
template_variables
array
title
string
widgets
array

Action Response

data
object
error
successful
boolean
Updates tags for a specific host in datadog. this replaces all existing tags from the specified source with the new tags provided.

Action Parameters

host_name
stringRequired
source
string
tags
arrayRequired

Action Response

data
object
error
successful
boolean
Updates an existing datadog monitor with new configuration, thresholds, or notification settings. only specified fields will be updated.

Action Parameters

message
string
monitor_id
integerRequired
name
string
options
object
priority
integer
query
string
tags
array
type
string

Action Response

data
object
error
successful
boolean