Datadog/traces
@figura/datadog/tracesv2026.07.21.1
01README
Datadog APM Traces — search and aggregate APM trace spans via the Datadog Spans API (v2). Supports all Datadog sites (us1, us3, us5, eu1, ap1, us1-fed).
Authentication
Requires a Datadog API key and Application key, stored in a swamp vault.
Methods
- list_spans — Search APM trace spans with filter, time range, and sort - aggregate_spans — Compute metrics/timeseries over APM spans (count, avg, percentiles, etc. with group-by facets)
02Models
@figura/datadog/tracesv2026.07.21.1datadog/traces.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Datadog API key (DD-API-KEY) |
| appKey | string | Datadog application key (DD-APPLICATION-KEY) |
| site | enum | Datadog site |
fn list_spans(filter_query?: string, filter_from?: string, filter_to?: string, sort?: enum)
Search spans (POST) — query APM trace spans
| Argument | Type | Description |
|---|---|---|
| filter_query? | string | Search query following span search syntax (e.g. 'service:web-store AND resource_name:GET /api/v1/users'). |
| filter_from? | string | Minimum timestamp for requested spans (ISO-8601 or relative like 'now-15m'). |
| filter_to? | string | Maximum timestamp for requested spans (ISO-8601 or relative like 'now'). |
| sort? | enum | Sort order for spans. Use 'timestamp' for ascending, '-timestamp' for descending. |
fn aggregate_spans(compute?: array, filter?: unknown, group_by?: array, options?: unknown)
Aggregate spans — compute metrics/timeseries over APM spans
| Argument | Type | Description |
|---|---|---|
| compute? | array | The list of metrics or timeseries to compute for the retrieved buckets (e.g. [{aggregation: 'count', type: 'total'}]). |
| filter? | unknown | Filter object with query, from, and to fields (e.g. {query: 'service:web-store', from: 'now-1h', to: 'now'}). |
| group_by? | array | The rules for the group by (e.g. [{facet: 'service', limit: 10, sort: {aggregation: 'count', order: 'desc'}}]). |
| options? | unknown | Global query options (e.g. {timezone: 'UTC'}). |
Resources
spans(infinite)— Search spans (POST)
aggregate_spans(infinite)— Aggregate spans
03Stats
A
100 / 100
Downloads
0
Archive size
9.7 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
04Platforms
05Labels