Datadog · JSON Structure

Datadog Metrics Metric Query Definition Structure

A metric query definition referencing a Datadog metrics query expression

Type: object Properties: 3 Required: 3
AnalyticsDashboardsMonitoringPlatformT1Visualizations

MetricQueryDefinition is a JSON Structure definition published by Datadog, describing 3 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

name data_source query

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-structure/datadog-metrics-metric-query-definition-structure.json",
  "name": "MetricQueryDefinition",
  "description": "A metric query definition referencing a Datadog metrics query expression",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "A unique name used to reference this query in formula expressions",
      "example": "Example Monitor"
    },
    "data_source": {
      "type": "string",
      "description": "The data source for the query",
      "enum": [
        "metrics",
        "cloud_cost"
      ],
      "example": "metrics"
    },
    "query": {
      "type": "string",
      "description": "The Datadog metrics query string (e.g., avg:system.cpu.user{*} by {host})",
      "example": "avg:system.cpu.user{*}"
    }
  },
  "required": [
    "name",
    "data_source",
    "query"
  ]
}