{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/new-relic/refs/heads/main/json-structure/new-relic-metric-payload-structure.json",
  "name": "New Relic Metric API Payload",
  "description": "Schema for metric data payloads submitted to the New Relic Metric API. Represents an array of metric batch objects, each containing a set of metrics and optional shared attributes applied to all metrics in the batch.",
  "type": "array",
  "items": {
    "$ref": "#/$defs/MetricDataObject"
  },
  "$defs": {
    "MetricDataObject": {
      "type": "object",
      "description": "A container for a batch of related metrics with optional shared attributes",
      "required": [
        "metrics"
      ],
      "properties": {
        "common": {
          "$ref": "#/$defs/CommonBlock"
        },
        "metrics": {
          "type": "array",
          "description": "Array of individual metric data points in this batch",
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/MetricDataPoint"
          }
        }
      }
    },
    "CommonBlock": {
      "type": "object",
      "description": "Shared default values and attributes applied to all metrics in the batch",
      "properties": {
        "timestamp": {
          "type": "int32",
          "description": "Default Unix timestamp in milliseconds. Applied to all metrics unless overridden at the metric level.",
          "minimum": 0
        },
        "interval.ms": {
          "type": "int32",
          "description": "Default measurement interval in milliseconds. Required for count and summary metric types.",
          "minimum": 1
        },
        "attributes": {
          "$ref": "#/$defs/AttributeMap"
        }
      }
    },
    "MetricDataPoint": {
      "type": "object",
      "description": "A single metric data point with type, value, and optional attributes",
      "required": [
        "name",
        "type",
        "value"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "The metric name used for NRQL queries (e.g., cpu.utilization.percent)",
          "maxLength": 255,
          "pattern": "^[^\\s].{0,254}$"
        },
        "type": "{'type': 'string', 'description': 'The metric type determines how values are aggregated and interpreted', 'enum': ['gauge', 'count', 'summary']}",
        "value": {
          "description": "Metric value. Number for gauge and count; SummaryValue object for summary type.",
          "oneOf": [
            {
              "type": "double",
              "description": "Numeric value for gauge or count metric types"
            },
            {
              "$ref": "#/$defs/SummaryValue"
            }
          ]
        },
        "timestamp": {
          "type": "int32",
          "description": "Unix timestamp in milliseconds. Overrides the common block timestamp for this metric.",
          "minimum": 0
        },
        "interval.ms": {
          "type": "int32",
          "description": "Measurement interval in milliseconds. Required for count and summary types if not in common block.",
          "minimum": 1
        },
        "attributes": {
          "$ref": "#/$defs/AttributeMap"
        }
      }
    },
    "SummaryValue": {
      "type": "object",
      "description": "Aggregated statistical value for summary metric type",
      "required": [
        "count",
        "sum",
        "min",
        "max"
      ],
      "properties": {
        "count": {
          "type": "double",
          "description": "The number of individual measurements included in this summary",
          "minimum": 0
        },
        "sum": {
          "type": "double",
          "description": "The sum of all measurement values in this interval"
        },
        "min": {
          "type": "double",
          "description": "The minimum individual measurement value in this interval"
        },
        "max": {
          "type": "double",
          "description": "The maximum individual measurement value in this interval"
        }
      }
    },
    "AttributeMap": {
      "type": "object",
      "description": "Key-value attribute pairs. Keys must not start with nr. (reserved prefix). Values can be strings (max 4096 chars), numbers, or booleans.",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string",
            "maxLength": 4096
          },
          {
            "type": "double"
          },
          {
            "type": "boolean"
          }
        ]
      }
    }
  }
}