Datadog · Schema
MetricTimeseriesQuery
Request body for querying timeseries metric data
AnalyticsDashboardsMonitoringPlatformT1Visualizations
Properties
| Name | Type | Description |
|---|---|---|
| data | object | The query data object containing type and attributes |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-metrics-metric-timeseries-query-schema.json",
"title": "MetricTimeseriesQuery",
"description": "Request body for querying timeseries metric data",
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "The query data object containing type and attributes",
"required": [
"type",
"attributes"
],
"properties": {
"type": {
"type": "string",
"description": "The type identifier for the query request",
"enum": [
"timeseries_request"
]
},
"attributes": {
"type": "object",
"description": "The query attributes including formulas, queries, and time range",
"required": [
"from",
"to",
"queries"
],
"properties": {
"from": {
"type": "integer",
"format": "int64",
"description": "Unix timestamp in milliseconds for the start of the query time range"
},
"to": {
"type": "integer",
"format": "int64",
"description": "Unix timestamp in milliseconds for the end of the query time range"
},
"interval": {
"type": "integer",
"format": "int64",
"description": "The granularity (in milliseconds) for returned data points"
},
"queries": {
"type": "array",
"description": "List of metric queries to evaluate",
"items": {
"$ref": "#/components/schemas/MetricQueryDefinition"
}
},
"formulas": {
"type": "array",
"description": "List of formula expressions combining the defined queries",
"items": {
"$ref": "#/components/schemas/QueryFormula"
}
}
}
}
}
}
},
"required": [
"data"
]
}