v2

latestOpenAPI 3.0.0SolarWinds Software Services Agreement2026-07-2167105153.0 KB

metrics

Create composite metric

Create a composite metric given a PromQL query.

post/v1/metrics

Request body

namestring required

Name of the composite metric.

displayNamestring nullable

Display name of the composite metric. A short description of the metric.

descriptionstring nullable

Description of the composite metric. A detailed description of the metric.

formulastring required

PromQL query to calculate the composite metric.

unitsstring nullable

Unit of the composite metric.

Example request

{
  "name": "composite.custom.system.disk.io.rate",
  "displayName": "Disk IO rate",
  "description": "Disk bytes transferred per second",
  "formula": "rate(system.disk.io[5m])",
  "units": "bytes/s"
}

Response

The request has succeeded and a new resource has been created as a result.