MetricSeries

{
  "$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"
  ]
}