Query Timeseries

Queries timeseries in Datadog.

This node is also exposed as an AI Agent tool.

This node has 1 input port and 1 output port.

Common Properties

Every node shares these.

Name — the node's display name on the canvas.
Color — the node's colour on the canvas.
Delay Before (sec) — wait this long before the node runs.
Delay After (sec) — wait this long after the node runs.
Continue On Error — carry on instead of failing the flow. Defaults to false.

info

When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.

Property	Field	Description
Client ID	`inClientID`	Client ID from Connect node (optional if credentials provided)
From (Unix Timestamp)	`inFrom`	Start time as Unix timestamp in seconds
Query	`inQuery`	Datadog metrics query (e.g. avg:system.cpu.user{*})
To (Unix Timestamp)	`inTo`	End time as Unix timestamp in seconds

Property	Field	Description
Series	`outSeries`	Timeseries data with metric name، tags، and data points
Status	`outStatus`	Query status

Property	Field	Description
Credentials	`optCredentials`	Datadog API keys
Site	`optSite`	Datadog site (defaults to datadoghq.com)
Timeout (seconds)	`optTimeout`	Maximum time in seconds to wait

A Client ID from this package's Connect node, unless you set credentials directly on this node.
Datadog API Keys — API Key and Application Key for Datadog authentication
- value — API Key (password, required). Your Datadog API key
- application_key — Application Key (password, optional). Required for query and management operations (monitors, logs, downtimes)

Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.