v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBMetrics
Create a tag configuration
Create and define a list of queryable tag keys for an existing count/gauge/rate/distribution metric. Optionally, include percentile aggregations on any distribution metric. By setting exclude_tags_mode to true, the behavior is changed from an allow-list to a deny-list, and tags in the defined list are not queryable. Can only be used with application keys of users with the Manage Tags for Metrics permission.
post/api/v2/metrics/{metric_name}/tags
Path parameters
metric_namestring required
The name of the metric.
Request body
Example request
{
"data": {
"attributes": {
"include_percentiles": false,
"metric_type": "distribution",
"tags": [
"app",
"datacenter"
]
},
"id": "http.endpoint.request",
"type": "manage_tags"
}
}Response
Created
Example response
{
"data": {
"attributes": {
"aggregations": [
{
"space": "avg",
"time": "avg"
}
],
"created_at": "2020-03-25T09:48:37.463835Z",
"metric_type": "gauge",
"modified_at": "2020-04-25T09:48:37.463835Z",
"tags": [
"app",
"datacenter"
]
},
"id": "http.request.latency",
"type": "manage_tags"
}
}