EstimateMetricsOutputSeries

Estimate the cardinality of a metric for a given tag, percentile, and aggregation configuration using Metrics without Limits™ on the Datadog MCP Server.

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/json
- Response Properties:
- Example:

{
  "data": "unknown_type"
}

400: API error response.
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

403: API error response.
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

404: API error response.
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

429: Too Many Requests
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

Input Schema

Name	Required	Description
`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.

Input Schema (JSON Schema)

{
  "properties": {
    "filter[groups]": {
      "description": "Filtered tag keys that the metric is configured to query with.",
      "type": "string"
    },
    "filter[hours_ago]": {
      "description": "The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.",
      "format": "int32",
      "maximum": 2147483647,
      "minimum": 49,
      "type": "integer"
    },
    "filter[num_aggregations]": {
      "description": "Deprecated. Number of aggregations has no impact on volume.",
      "format": "int32",
      "maximum": 9,
      "type": "integer"
    },
    "filter[pct]": {
      "description": "A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators.",
      "type": "boolean"
    },
    "filter[timespan_h]": {
      "description": "A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.",
      "format": "int32",
      "maximum": 2147483647,
      "type": "integer"
    },
    "metric_name": {
      "description": "The name of the metric.",
      "type": "string"
    }
  },
  "required": [
    "metric_name"
  ],
  "type": "object"
}

Datadog MCP Server

EstimateMetricsOutputSeries

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API