EstimateMetricsOutputSeries
Calculate estimated metric cardinality for specific tags, percentiles, and aggregation configurations using Metrics without Limits™ on Datadog MCP Server's observability platform.
Instructions
Returns the estimated cardinality for a metric with a given tag, percentile and number of aggregations configuration using Metrics without Limits™.
Path Parameters:
metric_name (Required): The name of the metric.
Query Parameters:
filter[groups]: Filtered tag keys that the metric is configured to query with.
filter[hours_ago]: The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.
filter[num_aggregations]: Deprecated. Number of aggregations has no impact on volume.
filter[pct]: A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators.
filter[timespan_h]: A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
Responses:
200 (Success): Success
Content-Type:
application/jsonResponse Properties:
Example:
{
"data": "unknown_type"
}400: API error response.
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}403: API error response.
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}404: API error response.
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}429: Too Many Requests
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter[groups] | No | Filtered tag keys that the metric is configured to query with. | |
| filter[hours_ago] | No | The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours. | |
| filter[num_aggregations] | No | Deprecated. Number of aggregations has no impact on volume. | |
| filter[pct] | No | A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators. | |
| filter[timespan_h] | No | A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour. | |
| metric_name | Yes | The name of the metric. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No |