Dynatrace · JSON Structure

Dynatrace Metrics V2 Metric Descriptor Structure

Describes a single metric including its metadata, supported aggregations, entity dimensions, and default aggregation settings.

Type: object Properties: 12
AI OperationsAnalyticsAPMApplication Performance MonitoringApplication SecurityAutomationCloud MonitoringDigital Experience ManagementIntelligenceObservability

MetricDescriptor is a JSON Structure definition published by Dynatrace, describing 12 properties. It conforms to the https://json-structure.org/draft/2020-12/schema meta-schema.

Properties

metricId displayName description unit dduBillable created lastWritten entityType aggregationTypes dimensionDefinitions transformations defaultAggregation

Meta-schema: https://json-structure.org/draft/2020-12/schema

JSON Structure

Raw ↑
{
  "type": "object",
  "description": "Describes a single metric including its metadata, supported aggregations, entity dimensions, and default aggregation settings.",
  "name": "MetricDescriptor",
  "properties": {
    "metricId": {
      "type": "string",
      "description": "The fully qualified key of the metric, potentially including applied transformations. For example, builtin:host.cpu.usage:avg."
    },
    "displayName": {
      "type": "string",
      "description": "The human-readable display name of the metric."
    },
    "description": {
      "type": "string",
      "description": "A detailed description of what the metric measures."
    },
    "unit": {
      "type": "string",
      "description": "The unit of the metric values. For example, Percent, Byte, MilliSecond."
    },
    "dduBillable": {
      "type": "boolean",
      "description": "Whether ingesting this metric consumes Davis Data Units (DDUs)."
    },
    "created": {
      "type": "integer",
      "description": "The Unix timestamp in milliseconds when the metric was created."
    },
    "lastWritten": {
      "type": "integer",
      "description": "The Unix timestamp in milliseconds when the metric was last written."
    },
    "entityType": {
      "type": "array",
      "description": "The entity types that can be used to filter this metric, e.g., HOST, SERVICE, PROCESS_GROUP.",
      "items": {
        "type": "string"
      }
    },
    "aggregationTypes": {
      "type": "array",
      "description": "The list of aggregation types supported for this metric. Valid values include min, max, sum, count, avg, median, and percentile.",
      "items": {
        "type": "string",
        "enum": [
          "min",
          "max",
          "sum",
          "count",
          "avg",
          "median",
          "percentile"
        ]
      }
    },
    "dimensionDefinitions": {
      "type": "array",
      "description": "The list of dimension definitions for this metric. Each dimension provides a label for data splitting.",
      "items": {
        "type": "object",
        "description": "Defines a single dimension of a metric.",
        "properties": {
          "key": {
            "type": "string",
            "description": "The unique key identifying this dimension."
          },
          "name": {
            "type": "string",
            "description": "The display name of the dimension."
          },
          "type": {
            "type": "string",
            "description": "The type of the dimension. For example, ENTITY for entity dimensions or STRING for string dimensions."
          },
          "displayName": {
            "type": "string",
            "description": "The human-readable display name of the dimension."
          }
        }
      }
    },
    "transformations": {
      "type": "array",
      "description": "The list of transformation expressions that can be applied to this metric using the metric selector.",
      "items": {
        "type": "string"
      }
    },
    "defaultAggregation": {
      "type": "object",
      "description": "The default aggregation setting for the metric.",
      "properties": {
        "type": {
          "type": "string",
          "description": "The aggregation type to apply when no aggregation is specified in the query. For example, avg, sum, or max.",
          "enum": [
            "min",
            "max",
            "sum",
            "count",
            "avg",
            "median",
            "percentile"
          ]
        },
        "parameter": {
          "type": "number",
          "description": "The parameter for the aggregation type, used for percentile aggregation to specify the percentile value (e.g., 95)."
        }
      }
    }
  },
  "$schema": "https://json-structure.org/draft/2020-12/schema"
}