Datadog/metrics

@webframp/datadog/metricsv2026.09.08.1· 2d agoMODELS

01README

Datadog Metrics — metric queries, submissions, tag configurations, and metadata

02Release Notes

2026.09.08.1

Added: Initial code-generated release of @webframp/datadog/metrics with 14 methods covering the Datadog metrics API surface.

03Models1

@webframp/datadog/metricsv2026.09.08.1datadog/metrics.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Datadog API key (DD-API-KEY)
appKey	string	yes	Datadog application key (DD-APPLICATION-KEY)
site	enum	yes	Datadog site

fn list_tag_configurations(filter_configured?: boolean, filter_is_configurable?: boolean, filter_tags_configured?: string, filter_metric_type?: string, filter_include_percentiles?: boolean, filter_queried?: boolean, filter_queried_window_seconds?: number, filter_tags?: string, filter_related_assets?: boolean, include?: string, sort?: string, window_seconds?: number)

Get a list of metrics

Argument	Type	Required	Description
filter_configured?	boolean	no	Only return custom metrics that have been configured (`true`) or not configur...
filter_is_configurable?	boolean	no	Only return metrics that are eligible (`true`) or ineligible (`false`) for co...
filter_tags_configured?	string	no	Only return metrics that have the given tag key(s) in their Metrics Without L...
filter_metric_type?	string	no	Only return metrics of the given metric type.
filter_include_percentiles?	boolean	no
filter_queried?	boolean	no	Only return metrics that have been queried (true) or not queried (false) in t...
filter_queried_window_seconds?	number	no	This parameter has no effect unless `filter[queried]` is also set. Only retur...
filter_tags?	string	no	Only return metrics that were submitted with tags matching this expression. Y...
filter_related_assets?	boolean	no	Only return metrics that are used in at least one dashboard, monitor, noteboo...
include?	string	no	Include related resources in the response. Set to `metric_volumes` to include...
sort?	string	no	Sort results by metric volume. Prefix a key with `-` for descending order. Su...
window_seconds?	number	no	Only return metrics that have been actively reporting in the specified window...

fn list_active_metric_configurations(metric_name: string, window_seconds?: number)

List active tags and aggregations

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.
window_seconds?	number	no

fn list_tags_by_metric_name(metric_name: string, window_seconds?: number, filter_tags?: string, filter_match?: string, filter_include_tag_values?: boolean, filter_allow_partial?: boolean)

List tags by metric name

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.
window_seconds?	number	no	The number of seconds of look back (from now) to query for tag data. Default ...
filter_tags?	string	no	Filter results to tags from data points that have the specified tags. For exa...
filter_match?	string	no	Filter returned tags to those matching a substring. For example, `filter[matc...
filter_include_tag_values?	boolean	no	Whether to include tag values in the response. Defaults to true.
filter_allow_partial?	boolean	no	Whether to allow partial results. Defaults to false.

fn list_metric_assets(metric_name: string)

Related Assets to a Metric

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.

fn estimate_metrics_output_series(metric_name: string, filter_groups?: string, filter_exclude_tags_mode?: boolean, filter_hours_ago?: number, filter_num_aggregations?: number, filter_pct?: boolean, filter_timespan_h?: number)

Tag Configuration Cardinality Estimator

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.
filter_groups?	string	no	Comma-separated list of tag keys that the metric is configured to query with....
filter_exclude_tags_mode?	boolean	no	When `true`, `filter[groups]` is treated as an exclude list instead of an inc...
filter_hours_ago?	number	no	The number of hours of look back (from now) to estimate cardinality with. If ...
filter_num_aggregations?	number	no	Deprecated. Number of aggregations has no impact on volume.
filter_pct?	boolean	no	Deprecated. This query parameter has no effect on the estimate.
filter_timespan_h?	number	no	A window, in hours, from the look back to estimate cardinality with. The mini...

fn get_metric_tag_cardinality_details(metric_name: string)

Get tag key cardinality details

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.

fn list_tag_configuration_by_name(metric_name: string)

List tag configuration by name

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.

fn create_tag_configuration(metric_name: string, aggregations?: unknown, exclude_tags_mode?: boolean, include_percentiles?: boolean, metric_type: unknown, tags: array)

Create a tag configuration

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.
aggregations?	unknown	no
exclude_tags_mode?	boolean	no	When set to true, the configuration will exclude the configured tags and incl...
include_percentiles?	boolean	no	Toggle to include/exclude percentiles for a distribution metric. Defaults to ...
metric_type	unknown	yes
tags	array	yes	A list of tag keys that will be queryable for your metric.

fn update_tag_configuration(metric_name: string, aggregations?: unknown, exclude_tags_mode?: boolean, include_percentiles?: boolean, tags?: array)

Update a tag configuration

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.
aggregations?	unknown	no
exclude_tags_mode?	boolean	no	When set to true, the configuration will exclude the configured tags and incl...
include_percentiles?	boolean	no	Toggle to include/exclude percentiles for a distribution metric. Defaults to ...
tags?	array	no	A list of tag keys that will be queryable for your metric.

fn delete_tag_configuration(metric_name: string)

Delete a tag configuration

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.

fn list_volumes_by_metric_name(metric_name: string, window_seconds?: number)

List distinct metric volumes by metric name

Argument	Type	Required	Description
metric_name	string	yes	The name of the metric.
window_seconds?	number	no

fn query_scalar_data(formulas?: array, from: number, queries: unknown, to: number)

Query scalar data across multiple products

Argument	Type	Required	Description
formulas?	array	no	List of formulas to be calculated and returned as responses.
from	number	yes	Start date (inclusive) of the query in milliseconds since the Unix epoch.
queries	unknown	yes
to	number	yes	End date (exclusive) of the query in milliseconds since the Unix epoch.

fn query_timeseries_data(formulas?: array, from: number, interval?: number, queries: unknown, to: number)

Query timeseries data across multiple products

Argument	Type	Required	Description
formulas?	array	no	List of formulas to be calculated and returned as responses.
from	number	yes	Start date (inclusive) of the query in milliseconds since the Unix epoch.
interval?	number	no	A time interval in milliseconds. May be overridden by a larger interval if th...
queries	unknown	yes
to	number	yes	End date (exclusive) of the query in milliseconds since the Unix epoch.

fn submit_metrics(series: array)

Submit metrics

Argument	Type	Required	Description
series	array	yes	A list of timeseries to submit to Datadog.

Resources

tag_configurations(infinite)— Get a list of metrics

list_active_metric_configurations(infinite)— List active tags and aggregations

tags_by_metric_name(infinite)— List tags by metric name

list_metric_assets(infinite)— Related Assets to a Metric

estimate_metrics_output_series(infinite)— Tag Configuration Cardinality Estimator

metric_tag_cardinality_details(infinite)— Get tag key cardinality details

list_tag_configuration_by_name(infinite)— List tag configuration by name

tag_configuration(infinite)— Create a tag configuration

list_volumes_by_metric_name(infinite)— List distinct metric volumes by metric name

query_scalar_data(infinite)— Query scalar data across multiple products

query_timeseries_data(infinite)— Query timeseries data across multiple products

submit_metrics(infinite)— Submit metrics

04Previous Versions8

2026.08.28.2Aug 28, 2026

2026.08.28.2

Hardened codegen: instance names sanitized against path traversal; string schema patterns emit regex validation; output schemas passthrough unknown fields.

updated labels

2026.08.28.1Aug 28, 2026

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.26.2Aug 27, 2026

2026.08.26.2

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.25.1Aug 26, 2026

2026.08.25.1

Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.

updated labels

2026.08.24.1Aug 24, 2026

2026.08.24.1

Added: Output metadata attributes for observability.

durationMs: Method execution duration in milliseconds.
collectedBy: Extension name that produced the data.
fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).

2026.08.21.2Aug 22, 2026

2026.08.21.2

Changed: Every Datadog API call made by this model (via the shared _lib/api.ts helper) now names the HTTP method and path in its error message, instead of a bare "Datadog API HTTP 500: ...". A failure now reads, for example, Datadog API POST /api/v2/series failed with HTTP 500: ... rather than just the status code and response body. Network-level failures (DNS, connection reset, etc.) that previously surfaced as a raw TypeError now also say which Datadog operation was being attempted.

submit_metrics now rejects an empty series array at validation time with a clear "at least 1 element" error, instead of silently sending a no-op request to the Datadog Metrics API.

No other changes to method arguments, resource schemas, or successful-call behavior.

2026.08.21.1Aug 21, 2026

2026.08.21.1

Changed: Schema-only tightening pass, no behavioral change.

Added .min(1) to apiKey/appKey in the global arguments and to the required metric_name argument across all ten methods that use it as a path parameter, so empty identifiers are rejected before making an API call.
Added .describe() to previously undocumented fields: id, relationships, and type on the metric-assets resource schema; the attributes and type fields on the scalar/timeseries query response schemas; and the aggregations, metric_type, and queries arguments on create_tag_configuration, update_tag_configuration, query_scalar_data, and query_timeseries_data.