Dynatrace · Schema

MetricData

The result of a metric query, containing time-series data for each requested metric and dimension combination.

AI OperationsAnalyticsAPMApplication Performance MonitoringApplication SecurityAutomationCloud MonitoringDigital Experience ManagementIntelligenceObservability

Properties

Name Type Description
resolution string The resolution of the data points in the response. For example, 1h means each data point represents one hour of data.
nextPageKey string The cursor for the next page of results if the response is paginated. Null if all results are returned.
totalCount integer The total number of data series in the result.
result array The list of metric series collections, one per metric key matched by the selector.
View JSON Schema on GitHub

JSON Schema

dynatrace-metrics-v2-metric-data-schema.json Raw ↑
{
  "type": "object",
  "description": "The result of a metric query, containing time-series data for each requested metric and dimension combination.",
  "properties": {
    "resolution": {
      "type": "string",
      "description": "The resolution of the data points in the response. For example, 1h means each data point represents one hour of data.",
      "example": "example-value"
    },
    "nextPageKey": {
      "type": "string",
      "description": "The cursor for the next page of results if the response is paginated. Null if all results are returned.",
      "example": "example-value"
    },
    "totalCount": {
      "type": "integer",
      "description": "The total number of data series in the result.",
      "format": "int64",
      "example": 500
    },
    "result": {
      "type": "array",
      "description": "The list of metric series collections, one per metric key matched by the selector.",
      "example": [
        {
          "metricId": "abc123",
          "data": [
            {}
          ]
        }
      ],
      "items": {
        "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": "object"
                  }
                },
                "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": "object"
                  }
                },
                "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": "object"
                  }
                }
              },
              "required": [
                "timestamps",
                "values"
              ]
            }
          }
        }
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "MetricData"
}