New Relic · Schema

MetricDataPoint

A single metric data point

AnalysisAnalyticsAPMDevOpsInfrastructureMonitoringObservabilityPerformancePlatform

Properties

Name	Type	Description
name	string	The metric name (e.g., cpu.usage.percent)
type	string	The metric type
value	object	The metric value. For gauge and count, a number. For summary, an object with count, sum, min, and max fields.
timestamp	integer	Unix timestamp in milliseconds. Overrides the common timestamp for this metric.
interval.ms	integer	Measurement interval in milliseconds. Required for count and summary types.
attributes	object	Additional key-value attributes for this metric point

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/new-relic/refs/heads/main/json-schema/metric-api-metric-data-point-schema.json",
  "title": "MetricDataPoint",
  "description": "A single metric data point",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The metric name (e.g., cpu.usage.percent)",
      "maxLength": 255,
      "example": "example-resource-01"
    },
    "type": {
      "type": "string",
      "description": "The metric type",
      "enum": [
        "gauge",
        "count",
        "summary"
      ],
      "example": "gauge"
    },
    "value": {
      "description": "The metric value. For gauge and count, a number. For summary, an object with count, sum, min, and max fields.",
      "oneOf": [
        {
          "type": "number"
        },
        {
          "$ref": "#/components/schemas/SummaryValue"
        }
      ],
      "example": 42.5
    },
    "timestamp": {
      "type": "integer",
      "description": "Unix timestamp in milliseconds. Overrides the common timestamp for this metric.",
      "example": 1718153645993
    },
    "interval.ms": {
      "type": "integer",
      "description": "Measurement interval in milliseconds. Required for count and summary types.",
      "example": 100
    },
    "attributes": {
      "type": "object",
      "description": "Additional key-value attributes for this metric point",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      },
      "example": {
        "customAttribute": "example_value"
      }
    }
  },
  "required": [
    "name",
    "type",
    "value"
  ]
}