Datadog

datadog

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

Server Monitoring Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (42)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create DashboardDATADOG_CREATE_DASHBOARDAcción

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

Parámetros de entrada

tagsstring[]
Tags to associate with the dashboard
titlestringObligatorio
Dashboard title
widgetsobject[]Obligatorio
List of widgets to include in the dashboard
descriptionstring
Dashboard description
layout_typestring
Dashboard layout type ('ordered' or 'free')
notify_liststring[]
List of users to notify of dashboard changes
is_read_onlyboolean
Whether the dashboard is read-only
template_variablesobject[]
Template variables for dynamic dashboards

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create downtimeDATADOG_CREATE_DOWNTIMEAcción

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

Parámetros de entrada

endinteger
UNIX timestamp when downtime should end
scopestring[]Obligatorio
Scope to apply downtime to (host, service, or monitor tags)
startinteger
UNIX timestamp when downtime should start. If not provided, starts immediately
messagestring
Message to include with the downtime
timezonestring
Timezone for the downtime (e.g., 'UTC', 'America/New_York')
monitor_idinteger
Monitor ID to schedule downtime for (optional, can use scope instead)
recurrenceobject
Downtime recurrence configuration.
monitor_tagsstring[]
Monitor tags to match for downtime

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create eventDATADOG_CREATE_EVENTAcción

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

Parámetros de entrada

hoststring
Host name associated with the event
tagsstring[]
List of tags to associate with the event
textstringObligatorio
Event text/description (supports Markdown)
titlestringObligatorio
Event title (limited to 100 characters)
prioritystring
Event priority. Valid values: 'normal', 'low'
alert_typestring
Alert type. Valid values: 'error', 'warning', 'info', 'success'
device_namestring
Device name associated with the event
date_happenedinteger
UNIX timestamp when the event occurred. If not provided, current time is used
aggregation_keystring
Key for aggregating events together
source_type_namestring
Source type name (e.g., 'jenkins', 'docker', 'ansible')

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create monitorDATADOG_CREATE_MONITORAcción

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

Parámetros de entrada

namestringObligatorio
Name of the monitor
tagsstring[]
List of tags to assign to the monitor
typestringObligatorio
Type of monitor. Valid values: 'metric alert', 'service check', 'event alert', 'query alert', 'composite', 'log alert'
querystringObligatorio
Query that defines what the monitor tracks
messagestring
Message to include in notifications (supports @mentions and markdown)
optionsobject
Monitor configuration options.
priorityinteger
Priority level (1-5, where 1 is highest)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create SLODATADOG_CREATE_SLOAcción

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.

Parámetros de entrada

namestringObligatorio
SLO display name
tagsstring[]
Tags to associate with the SLO (format: 'key:value')
typestringObligatorio
SLO type: 'metric' or 'monitor'
queryobject
Query specification for monitor-based SLOs.
groupsstring[]
List of groups for the SLO scope
thresholdsobject[]Obligatorio
List of SLO target thresholds
descriptionstring
Optional description of the SLO
monitor_idsinteger[]
Monitor IDs for monitor-based SLOs

Parámetros de salida

dataobject
Created SLO data
errorstring
Error if any occurred during the execution of the action
errorsstring[]
List of errors if creation failed
slo_idstring
ID of the created SLO
successbooleanObligatorio
Whether the SLO was created successfully
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Synthetic API TestDATADOG_CREATE_SYNTHETIC_API_TESTAcción

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.

Parámetros de entrada

namestringObligatorio
Name of the synthetic test
tagsstring[]
Tags to associate with the test
typestring
Type of synthetic test (always 'api' for API tests)
configobjectObligatorio
Test configuration including request and assertions
statusstring
Test status ('live' or 'paused')
messagestring
Message to include in notifications
optionsobjectObligatorio
Test execution options
subtypestring
Subtype of test ('http', 'ssl', 'tcp', 'dns', 'icmp')

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create WebhookDATADOG_CREATE_WEBHOOKAcción

Create a webhook in datadog. webhooks enable you to receive notifications from datadog monitors and alerts to external services and applications.

Parámetros de entrada

urlstringObligatorio
URL endpoint for the webhook
namestringObligatorio
Name of the webhook
payloadstring
Custom payload template (optional)
encode_asstring
Encoding type: 'json' or 'form'
custom_headersstring
Custom headers in JSON format (optional)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete DashboardDATADOG_DELETE_DASHBOARDAcción

Delete a dashboard in datadog. permanently removes a dashboard from your organization. this action cannot be undone. use with caution.

Parámetros de entrada

dashboard_idstringObligatorio
Dashboard ID to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete monitorDATADOG_DELETE_MONITORAcción

Deletes a datadog monitor permanently. use with caution as this action cannot be undone.

Parámetros de entrada

forceboolean
Force delete the monitor (skip confirmation)
monitor_idintegerObligatorio
The ID of the monitor to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get DashboardDATADOG_GET_DASHBOARDAcción

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

Parámetros de entrada

dashboard_idstringObligatorio
Dashboard ID to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get monitorDATADOG_GET_MONITORAcción

Retrieves detailed information about a specific datadog monitor, including its current state, configuration, and any active downtimes.

Parámetros de entrada

monitor_idintegerObligatorio
The ID of the monitor to retrieve
group_statesstring[]
Filter by group states when retrieving monitor details. Valid values: 'all', 'alert', 'warn', 'no data'
with_downtimesboolean
Include downtime information in the response

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Service DependenciesDATADOG_GET_SERVICE_DEPENDENCIESAcción

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.

Parámetros de entrada

envstring
Environment to filter by
servicestringObligatorio
The service name to get dependencies for
end_timeinteger
End time as UNIX timestamp (seconds)
start_timeinteger
Start time as UNIX timestamp (seconds)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Synthetics LocationsDATADOG_GET_SYNTHETICS_LOCATIONSAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get host tagsDATADOG_GET_TAGSAcción

Retrieves all tags associated with a specific host in datadog. useful for understanding host metadata and organizing infrastructure.

Parámetros de entrada

sourcestring
Source of tags to retrieve (e.g., 'users', 'chef', 'puppet')
host_namestringObligatorio
Name of the host to get tags from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Trace by IDDATADOG_GET_TRACE_BY_IDAcción

Get detailed information about a specific trace by its id. this action retrieves comprehensive details about a distributed trace, including all spans, timing information, errors, and metadata. it's essential for: - deep diving into specific request flows during incidents - understanding the complete journey of a problematic request - analyzing performance bottlenecks in detail - correlating errors across services - debugging complex distributed system issues the trace id is typically obtained from logs, error reports, or trace search results.

Parámetros de entrada

trace_idstringObligatorio
The unique trace ID to retrieve

Parámetros de salida

dataobject
Detailed trace information.
metaobject
Response metadata
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get usage summaryDATADOG_GET_USAGE_SUMMARYAcción

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

Parámetros de entrada

end_monthstring
End month in YYYY-MM format. If not provided, uses start_month
start_monthstringObligatorio
Start month in YYYY-MM format
include_org_detailsboolean
Include organization details in the response

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List All TagsDATADOG_LIST_ALL_TAGSAcción

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

Parámetros de entrada

sourcestring
Filter tags by source (e.g., 'chef', 'puppet', 'users', 'datadog')

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List API KeysDATADOG_LIST_API_KEYSAcción

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.

Parámetros de entrada

sortstring
Sort field. Options: 'created_at', 'last4', 'modified_at', 'name'
page_sizeinteger
Number of API keys to return per page (default 20, max 1000)
page_numberinteger
Page number to retrieve (0-indexed)
filter_created_at_endstring
ISO timestamp to filter keys created before this time
filter_modified_at_endstring
ISO timestamp to filter keys modified before this time
filter_created_at_startstring
ISO timestamp to filter keys created after this time
filter_modified_at_startstring
ISO timestamp to filter keys modified after this time

Parámetros de salida

dataobject[]
List of API keys
metaobject
Pagination metadata
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not
total_countintegerObligatorio
Total number of API keys

List APM ServicesDATADOG_LIST_APM_SERVICESAcción

List apm services from datadog. application performance monitoring (apm) provides deep visibility into your applications, helping you track performance, errors, and dependencies.

Parámetros de entrada

endinteger
End time for the query (UNIX timestamp in seconds)
envstring
Environment filter (e.g., 'production', 'staging')
limitinteger
Maximum number of services to return (1-500, default: 50)
startinteger
Start time for the query (UNIX timestamp in seconds)
servicestring
Filter by specific service name

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List AWS IntegrationDATADOG_LIST_AWS_INTEGRATIONAcción

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.

Parámetros de entrada

role_namestring
Filter by specific AWS IAM role name
account_idstring
Filter by specific AWS account ID

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List dashboardsDATADOG_LIST_DASHBOARDSAcción

Lists all datadog dashboards with basic information. useful for dashboard management and getting an overview of available dashboards.

Parámetros de entrada

filter_sharedboolean
Filter dashboards by shared status
filter_deletedboolean
Include deleted dashboards in the results

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List eventsDATADOG_LIST_EVENTSAcción

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

Parámetros de entrada

endintegerObligatorio
End time as UNIX timestamp
pageinteger
Page number for pagination
tagsstring[]
Filter by tags
startintegerObligatorio
Start time as UNIX timestamp
sourcesstring
Filter by event sources (comma-separated)
prioritystring
Filter by event priority. Valid values: 'normal', 'low'
unaggregatedboolean
Get unaggregated events (default: false)
exclude_aggregateboolean
Exclude aggregated events

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List hostsDATADOG_LIST_HOSTSAcción

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

Parámetros de entrada

countinteger
Number of hosts to return (max 1000)
startinteger
Starting position for pagination
filterstring
Filter hosts by tags or attributes
sort_dirstring
Sort direction. Valid values: 'asc', 'desc'
sort_fieldstring
Field to sort by. Valid values: 'status', 'name', 'cpu', 'iowait', 'load'
from_timestampinteger
Start time as UNIX timestamp for host activity
include_hosts_metadataboolean
Include hosts metadata in response
include_muted_hosts_databoolean
Include data for muted hosts

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List IncidentsDATADOG_LIST_INCIDENTSAcción

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

Parámetros de entrada

sortstring
Sort order for incidents (e.g., '-created', 'severity')
includestring
Related resources to include (e.g., 'users,attachments')
page_sizeinteger
Number of incidents per page (1-100, default: 25)
page_offsetinteger
Page offset for pagination (default: 0)
filter_querystring
Filter query for incidents (e.g., 'state:active')

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Log IndexesDATADOG_LIST_LOG_INDEXESAcción

Tool to retrieve a list of all log indexes configured in datadog. use when you need to get the names and configurations of log indexes.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List monitorsDATADOG_LIST_MONITORSAcción

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.

Parámetros de entrada

namestring
Filter monitors by name (substring match)
pageinteger
The page to start paginating from. If this argument is not specified, the request returns all monitors without pagination.
tagsstring[]
A comma separated list indicating what tags, if any, should be used to filter the list of monitors by scope. For example host:host0.
id_offsetinteger
Monitor ID offset for pagination
page_sizeinteger
The number of monitors to return per page. If the page argument is not specified, the default behavior returns all monitors without pagination. Page size is capped at 100.
group_statesstring[]
When specified, shows additional information about the group states. Choose one or more from Alert, Warn, or No Data.
monitor_tagsstring[]
A comma separated list indicating what service and/or custom tags, if any, should be used to filter the list of monitors. Tags created in the Datadog UI automatically have the service key prepended. For example service:my-app.
with_downtimesboolean
If this argument is set to true, then the returned data includes all current downtimes for the monitor.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List RolesDATADOG_LIST_ROLESAcción

List roles from datadog organization. roles define sets of permissions that control what users can do within your datadog organization.

Parámetros de entrada

sortstring
Sort field (name, created_at, user_count)
page_sizeinteger
Number of roles per page (1-100, default: 10)
filter_namestring
Filter roles by name (partial match)
page_numberinteger
Page number for pagination (default: 0)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List service checksDATADOG_LIST_SERVICE_CHECKSAcción

Lists service checks from datadog. service checks are status checks that track the health of your services and infrastructure components.

Parámetros de entrada

endinteger
End time as UNIX timestamp
tagsstring[]
Filter by tags
checkstring
Filter by service check name
startinteger
Start time as UNIX timestamp
statusstring
Filter by service check status. Valid values: 'ok', 'warning', 'critical', 'unknown'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SLOsDATADOG_LIST_SL_OSAcción

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.

Parámetros de entrada

tagsstring
Filter SLOs by tags using a comma-separated list (e.g., 'env:prod,team:backend')
limitinteger
Maximum number of SLOs to return (1-1000, default: 25)
querystring
Search query to filter SLOs by name or description
offsetinteger
Number of SLOs to skip for pagination (default: 0)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Synthetics TestsDATADOG_LIST_SYNTHETICSAcción

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.

Parámetros de entrada

tagsstring
Filter tests by tags using a comma-separated list (e.g., 'env:prod,team:frontend')
limitinteger
Maximum number of tests to return (1-200, default: 50)
offsetinteger
Number of tests to skip for pagination (default: 0)
locationsstring
Filter tests by locations using a comma-separated list

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List UsersDATADOG_LIST_USERSAcción

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

Parámetros de entrada

sortstring
Sort field (name, email, status, created_at)
sort_dirstring
Sort direction (asc or desc)
page_sizeinteger
Number of users per page (1-1000, default: 50)
page_numberinteger
Page number for pagination (default: 0)
filter_statusstring
Filter by user status (Active, Pending, Disabled)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List WebhooksDATADOG_LIST_WEBHOOKSAcción

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

Parámetros de entrada

limitinteger
Maximum number of webhooks to return (1-100, default: 50)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Mute MonitorDATADOG_MUTE_MONITORAcción

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.

Parámetros de entrada

endinteger
POSIX timestamp for when the mute should expire (optional, if not specified the monitor remains muted until manually unmuted)
overrideboolean
Whether to override existing mute settings
monitor_idintegerObligatorio
The ID of the monitor to mute

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Query metricsDATADOG_QUERY_METRICSAcción

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

Parámetros de entrada

querystringObligatorio
Datadog metrics query string
to_timestampintegerObligatorio
End time as UNIX timestamp. Note: Time range cannot exceed 1 year.
from_timestampintegerObligatorio
Start time as UNIX timestamp. Note: Time range cannot exceed 1 year.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Search logsDATADOG_SEARCH_LOGSAcción

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.

Parámetros de entrada

indexstring
Index name to search in
limitinteger
Maximum number of logs to return (max 1000, default 50)
querystringObligatorio
Log search query string
time_tointegerObligatorio
End time as UNIX timestamp (in milliseconds). Note: Time range cannot exceed 15 days.
start_atstring
Pagination cursor for next page
time_fromintegerObligatorio
Start time as UNIX timestamp (in milliseconds). Note: Time range cannot exceed 15 days.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Search Spans AnalyticsDATADOG_SEARCH_SPANS_ANALYTICSAcción

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.

Parámetros de entrada

pageobject
Pagination options
filterobjectObligatorio
Filter criteria for span search
computeobject[]
Aggregations to compute
optionsobject
Additional search options
group_byobject[]
Group by configuration for aggregations

Parámetros de salida

dataobject
Response data containing buckets
metaobject
Response metadata
errorstring
Error if any occurred during the execution of the action
bucketsobject[]
Aggregated span buckets
successfulbooleanObligatorio
Whether or not the action execution was successful or not
total_countinteger
Total number of spans matching the query

Search TracesDATADOG_SEARCH_TRACESAcción

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.

Parámetros de entrada

pageobject
Pagination options
sortobject
Sort configuration for trace search.
filterobjectObligatorio
Filter criteria for trace search
optionsobject
Additional search options

Parámetros de salida

dataobject[]
List of traces matching the search criteria
metaobject
Response metadata including pagination info
errorstring
Error if any occurred during the execution of the action
linksobject
Links for pagination
successfulbooleanObligatorio
Whether or not the action execution was successful or not
total_countinteger
Total number of traces found

Submit metricsDATADOG_SUBMIT_METRICSAcción

Submits custom metrics to datadog. useful for sending application-specific metrics, business kpis, or custom performance indicators.

Parámetros de entrada

seriesobject[]Obligatorio
List of metric series to submit

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Unmute MonitorDATADOG_UNMUTE_MONITORAcción

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.

Parámetros de entrada

all_scopesboolean
Whether to unmute the monitor for all scopes (default: false)
monitor_idintegerObligatorio
The ID of the monitor to unmute

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update DashboardDATADOG_UPDATE_DASHBOARDAcción

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

Parámetros de entrada

tagsstring[]
Tags to associate with the dashboard
titlestring
Dashboard title
widgetsobject[]
List of widgets to include in the dashboard
descriptionstring
Dashboard description
layout_typestring
Dashboard layout type ('ordered' or 'free')
notify_liststring[]
List of users to notify of dashboard changes
dashboard_idstringObligatorio
Dashboard ID to update
is_read_onlyboolean
Whether the dashboard is read-only
template_variablesobject[]
Template variables for dynamic dashboards

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update host tagsDATADOG_UPDATE_HOST_TAGSAcción

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

Parámetros de entrada

tagsstring[]Obligatorio
List of tags to assign to the host (replaces existing tags)
sourcestring
Source of the tags (e.g., 'users', 'chef', 'puppet'). Defaults to 'users'
host_namestringObligatorio
Name of the host to update tags for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update monitorDATADOG_UPDATE_MONITORAcción

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

Parámetros de entrada

namestring
Name of the monitor
tagsstring[]
List of tags to assign to the monitor
typestring
Type of monitor. Valid values: 'metric alert', 'service check', 'event alert', 'query alert', 'composite', 'log alert'
querystring
Query that defines what the monitor tracks
messagestring
Message to include in notifications (supports @mentions and markdown)
optionsobject
Monitor update configuration options.
priorityinteger
Priority level (1-5, where 1 is highest)
monitor_idintegerObligatorio
The ID of the monitor to update

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not