Dynatrace · Schema

MetricSeries

A single time series representing metric values for a specific combination of dimension values over a time range.

AI OperationsAnalyticsAPMApplication Performance MonitoringApplication SecurityAutomationCloud MonitoringDigital Experience ManagementIntelligenceObservability

Properties

Name Type Description
dimensionMap object A map of dimension names to their values for this specific series. For example, {"host": "web-01", "environment": "production"}.
dimensions array An ordered list of dimension values corresponding to the metric's dimension definitions.
timestamps array Unix timestamps in milliseconds for each data point in the series. Aligns one-to-one with the values array.
values array Metric values corresponding to each timestamp. A null value indicates no data was recorded for that time slot (gap in the data).
View JSON Schema on GitHub

JSON Schema

metrics-api-v2-metric-series-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-schema/metrics-api-v2-metric-series-schema.json",
  "title": "MetricSeries",
  "description": "A single time series representing metric values for a specific combination of dimension values over a time range.",
  "type": "object",
  "properties": {
    "dimensionMap": {
      "type": "object",
      "description": "A map of dimension names to their values for this specific series. For example, {\"host\": \"web-01\", \"environment\": \"production\"}.",
      "additionalProperties": {
        "type": "string"
      },
      "example": {}
    },
    "dimensions": {
      "type": "array",
      "description": "An ordered list of dimension values corresponding to the metric's dimension definitions.",
      "items": {
        "type": "string"
      },
      "example": [
        "example-value"
      ]
    },
    "timestamps": {
      "type": "array",
      "description": "Unix timestamps in milliseconds for each data point in the series. Aligns one-to-one with the values array.",
      "items": {
        "type": "integer",
        "format": "int64"
      },
      "example": [
        1718153645993
      ]
    },
    "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).",
      "items": {
        "type": [
          "number",
          "null"
        ],
        "format": "double"
      },
      "example": [
        "example-value"
      ]
    }
  },
  "required": [
    "timestamps",
    "values"
  ]
}