Overview

Datadog is the observability platform – metrics, logs, APM, monitors, dashboards, incidents, SLOs. The Automize Datadog connector covers monitor CRUD, metric submission + queries, log search, dashboards, events, incidents, SLOs, downtimes, and infrastructure host listing.

Regions: Datadog has regional deployments: US1, US3, US5, EU, US1-FED, AP1. API endpoint differs (api.datadoghq.com vs api.datadoghq.eu etc.). Pick your site at connection time.
Plans: Pricing per host + per metric + per ingested GB of logs. API access on all plans.

Setting up the connection

Auth type: API Key.

Sign in to Datadog → Organization Settings → API Keys → New Key.
Application Keys → New (for reading + admin operations beyond just submitting metrics).
Copy both API Key + Application Key.
In Automize, open Settings → Connectors → Datadog → Add connection. Paste both + pick your Datadog site (US, EU, etc.).

Find your credentials at https://app.datadoghq.com/organization-settings/api-keys.

Rate limits

Per-endpoint, varies. Metric submission ~300/min/host (very generous). Log search lower. Connector reads X-RateLimit-Remaining + retries.

Data model

Datadog's primitives:

    Monitors – alert definitions (metric, log, anomaly, etc.)
    Dashboards – widget compositions
    Events – discrete notable occurrences (deploys, alarms)
    Metrics – time-series data (submitted by agents or API)
    Logs – searchable structured logs
    Incidents – major outages tracked through resolution
    SLOs – service-level objectives
    Downtimes – scheduled muting

Available operations

18 operations available. Click any row to jump to its detail.

Operation	Category	What it does
Create downtime	General	Schedule a Datadog downtime/mute.
Create Event	General	Post a custom event
Create Monitor	General	Create a new monitor
Delete monitor	General	Delete a Datadog monitor.
Get Dashboard	General	Get dashboard details
Get Monitor	General	Get monitor details
List Dashboards	General	List all dashboards
List downtimes	General	List Datadog scheduled downtimes.
List Hosts	General	List infrastructure hosts
List Incidents	General	List all incidents
List Monitors	General	List all monitors
List SLOs	General	List service level objectives
Mute Monitor	General	Mute a monitor
Query Metrics	General	Query time series metrics
Search Logs	General	Search logs
Submit Metrics	General	Submit custom metrics
Unmute monitor	General	Unmute a Datadog monitor.
Update monitor	General	Update a Datadog monitor.

Operations

Create downtime

Schedule a Datadog downtime/mute.

Parameter	Required	Type
Scope `scope`	Yes	text
Start `start`	No	textarea
End `end`	No	textarea
Message `message`	No	textarea

Tips

Schedule a mute period. scope: host:foo OR env:staging OR a tag query.
start / end Unix timestamps.

Create Event

Post a custom event

Parameter	Required	Type
Title `title`	Yes	text
Text `text`	Yes	text
Tags `tags`	Yes	text
Alert Type `alert_type`	Yes	text

Tips

Post a discrete event – useful for marking deploys, releases, incidents.
alert_type: error, warning, info, success.
tags help filter the event stream + cross-reference with metrics.

Create Monitor

Create a new monitor

Parameter	Required	Type
Name `name`	Yes	text
Type `type`	Yes	text
Query `query`	Yes	text
Message `message`	Yes	text
Tags `tags`	Yes	text
Options `options`	Yes	text

Tips

name + type (metric alert, log alert, anomaly detection, composite, etc.) + query + message.
query: Datadog metric query (e.g. 'avg(last_5m):avg:system.cpu.user{host:prod-web-*} > 80').
message: notification text + @user / @slack-channel routing.
tags: ['env:prod', 'service:api'].

Delete monitor

Delete a Datadog monitor.

Parameter	Required	Type	Description
Monitor Id `monitor_id`	Yes	text

Tips

Hard-delete. Use Mute + Unmute for temporary silencing.

Get Dashboard

Get dashboard details

Parameter	Required	Type	Description
Dashboard Id `dashboard_id`	Yes	text

Tips

Returns dashboard incl. all widgets, layouts, template vars.

Get Monitor

Get monitor details

Parameter	Required	Type	Description
Monitor Id `monitor_id`	Yes	text

Tips

Returns monitor + state (Alert, OK, Warn, No Data).

List Dashboards

List all dashboards

No input parameters.

Tips

Returns dashboard summaries. Use Get Dashboard for full widget definitions.

List downtimes

List Datadog scheduled downtimes.

No input parameters.

Tips

Active + scheduled downtimes.

List Hosts

List infrastructure hosts

No input parameters.

Tips

Infrastructure hosts. Filter by tags.

List Incidents

List all incidents

No input parameters.

Tips

Open + closed incidents. Filter by state.

List Monitors

List all monitors

No input parameters.

Tips

Filter by tags, monitor_tags, name (substring), group_states.

List SLOs

List service level objectives

No input parameters.

Tips

Service-Level Objectives. Each has a target % + monitoring queries.

Mute Monitor

Mute a monitor

Parameter	Required	Type	Description
Monitor Id `monitor_id`	Yes	text

Tips

Silences notifications. scope: 'host:foo' for scoped mute. end (Unix timestamp) for time-bounded.

Query Metrics

Query time series metrics

No input parameters.

Tips

Datadog query syntax with from + to (Unix sec).
Example query: 'avg:system.cpu.user{host:prod-web-1}.rollup(avg, 60)'.

Search Logs

Search logs

Parameter	Required	Type
Filter `filter`	Yes	text
Sort `sort`	Yes	text
Page `page`	Yes	text

Tips

filter.query: log search query. filter.from / filter.to: time range.
sort: '-@timestamp' for newest first.

Submit Metrics

Submit custom metrics

Parameter	Required	Type	Description
Series `series`	Yes	text

Tips

Push custom metrics. series:[{metric, points:[[timestamp, value], ...], type:'count'|'gauge'|'rate', tags, host}].

Unmute monitor

Unmute a Datadog monitor.

Parameter	Required	Type	Description
Monitor Id `monitor_id`	Yes	text

Tips

Resumes notifications. all_scopes=true to unmute all scopes at once.

Update monitor

Update a Datadog monitor.

Parameter	Required	Type	Description
Monitor Id `monitor_id`	Yes	text

Tips

PUT-style with full monitor object. Get-modify-PUT pattern.

FAQ

Why are some endpoints returning 403?: Datadog distinguishes API Key (sufficient for metrics + events) from Application Key (needed for reads + admin ops). Connector needs both – verify both are configured.
Which site am I on?: Look at your Datadog URL – app.datadoghq.com (US1), app.datadoghq.eu (EU), etc. Set the matching site on the connection.
How do I correlate events to metric spikes?: Submit Create Event with tags matching your metric tags. Datadog overlays events on metric graphs automatically when tags align.
Webhooks for monitor triggers?: Configure via Datadog UI (Integrations → Webhooks), then reference via @webhook-name in monitor message. Not API-creatable from this connector.

Datadog integration

Overview

Setting up the connection

Rate limits

Data model

Available operations

Operations

Create downtime

Create Event

Create Monitor

Delete monitor

Get Dashboard

Get Monitor

List Dashboards

List downtimes

List Hosts

List Incidents

List Monitors

List SLOs

Mute Monitor

Query Metrics

Search Logs

Submit Metrics

Unmute monitor

Update monitor

FAQ

Related connectors

See it working on your own data