Datadog · Schema

MetricSeries

A single metric series containing data points and associated metadata

AnalyticsDashboardsMonitoringPlatformT1Visualizations

Properties

Name	Type	Description
metric	string	The name of the metric to submit. Must not exceed 200 characters. Only ASCII alphanumerics, underscores, and periods are allowed.
type	integer	The type of the metric (0=unspecified, 1=count, 2=rate, 3=gauge)
points	array	List of data points, each containing a timestamp (Unix epoch in seconds) and a value
tags	array	List of tags associated with the metric in key:value format (e.g., env:prod)
host	string	The name of the host that produced the metric data
resources	array	A list of resources associated with the metric, such as hosts or services
interval	integer	If the type is rate or count, defines the corresponding interval in seconds
unit	string	The unit of the metric value (e.g., byte, second, request)

View JSON Schema on GitHub

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-series-schema.json",
  "title": "MetricSeries",
  "description": "A single metric series containing data points and associated metadata",
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "description": "The name of the metric to submit. Must not exceed 200 characters. Only ASCII alphanumerics, underscores, and periods are allowed.",
      "example": "example_value"
    },
    "type": {
      "type": "integer",
      "description": "The type of the metric (0=unspecified, 1=count, 2=rate, 3=gauge)",
      "enum": [
        0,
        1,
        2,
        3
      ],
      "default": 3
    },
    "points": {
      "type": "array",
      "description": "List of data points, each containing a timestamp (Unix epoch in seconds) and a value",
      "items": {
        "$ref": "#/components/schemas/MetricPoint"
      }
    },
    "tags": {
      "type": "array",
      "description": "List of tags associated with the metric in key:value format (e.g., env:prod)",
      "items": {
        "type": "string"
      }
    },
    "host": {
      "type": "string",
      "description": "The name of the host that produced the metric data",
      "example": "example_value"
    },
    "resources": {
      "type": "array",
      "description": "A list of resources associated with the metric, such as hosts or services",
      "items": {
        "$ref": "#/components/schemas/MetricResource"
      }
    },
    "interval": {
      "type": "integer",
      "format": "int64",
      "description": "If the type is rate or count, defines the corresponding interval in seconds",
      "example": 42
    },
    "unit": {
      "type": "string",
      "description": "The unit of the metric value (e.g., byte, second, request)",
      "example": "example_value"
    }
  },
  "required": [
    "metric",
    "points"
  ]
}