{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-metrics-metric-series-schema.json", "title": "MetricSeries", "description": "A single metric series containing data points and associated metadata", "type": "object", "properties": { "metric": { "type": "string", "description": "The name of the metric to submit. Must not exceed 200 characters. Only ASCII alphanumerics, underscores, and periods are allowed.", "example": "example_value" }, "type": { "type": "integer", "description": "The type of the metric (0=unspecified, 1=count, 2=rate, 3=gauge)", "enum": [ 0, 1, 2, 3 ], "default": 3 }, "points": { "type": "array", "description": "List of data points, each containing a timestamp (Unix epoch in seconds) and a value", "items": { "$ref": "#/components/schemas/MetricPoint" } }, "tags": { "type": "array", "description": "List of tags associated with the metric in key:value format (e.g., env:prod)", "items": { "type": "string" } }, "host": { "type": "string", "description": "The name of the host that produced the metric data", "example": "example_value" }, "resources": { "type": "array", "description": "A list of resources associated with the metric, such as hosts or services", "items": { "$ref": "#/components/schemas/MetricResource" } }, "interval": { "type": "integer", "format": "int64", "description": "If the type is rate or count, defines the corresponding interval in seconds", "example": 42 }, "unit": { "type": "string", "description": "The unit of the metric value (e.g., byte, second, request)", "example": "example_value" } }, "required": [ "metric", "points" ] }