{
  "type": "object",
  "description": "A collection of time-series data for a single metric key, containing one series per unique dimension combination.",
  "properties": {
    "metricId": {
      "type": "string",
      "description": "The metric key for this collection, including any applied transformations.",
      "example": "abc123"
    },
    "data": {
      "type": "array",
      "description": "The list of individual time series, one per unique combination of dimension values.",
      "example": [
        {
          "dimensionMap": {},
          "dimensions": [
            {}
          ],
          "timestamps": [
            {}
          ],
          "values": [
            {}
          ]
        }
      ],
      "items": {
        "type": "object",
        "description": "A single time series representing metric values for a specific combination of dimension values over a time range.",
        "properties": {
          "dimensionMap": {
            "type": "object",
            "description": "A map of dimension names to their values for this specific series. For example, {\"host\": \"web-01\", \"environment\": \"production\"}.",
            "example": {}
          },
          "dimensions": {
            "type": "array",
            "description": "An ordered list of dimension values corresponding to the metric's dimension definitions.",
            "example": [
              "example-value"
            ],
            "items": {
              "type": "string"
            }
          },
          "timestamps": {
            "type": "array",
            "description": "Unix timestamps in milliseconds for each data point in the series. Aligns one-to-one with the values array.",
            "example": [
              1718153645993
            ],
            "items": {
              "type": "integer",
              "format": "int64"
            }
          },
          "values": {
            "type": "array",
            "description": "Metric values corresponding to each timestamp. A null value indicates no data was recorded for that time slot (gap in the data).",
            "example": [
              "example-value"
            ],
            "items": {
              "type": "['number', 'null']",
              "format": "double"
            }
          }
        },
        "required": [
          "timestamps",
          "values"
        ]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "MetricSeriesCollection"
}