MetricSeries is a JSON Structure definition published by Datadog, describing 8 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-structure/datadog-metrics-metric-series-structure.json",
"name": "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": "int32",
"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": "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"
]
}