TeamCity REST API Reference 2026.2 Help

MetricValue

Represents a single numeric measurement within a metric. Simple gauge metrics expose one MetricValue named value. Compound metrics such as timers and histograms expose multiple MetricValues with names such as count and total.

Related Help article: Metrics

Properties

name

The name of this sub-measurement. Typically value for simple gauges; count, total, or max for compound metrics such as timers and histograms.

value

The numeric measurement.

tags

Additional key-value labels specific to this sub-measurement. Used by histogram-style metrics to tag individual buckets. Not included in responses by default.

Schema

Below, you can find a full schema of this object, in XML and JSON formats. You can choose what fields to submit depending on your current needs. Different methods might expect different fields: the best approach is to request this entity via GET and use the response as a base for the following POST request.

A link to another object implies that you can substitute it with the schema of the linked object, if it is required for your call.

<metricValue name="value" value="247.0"> <tags count="2"> <metricTag>[[[metricTag...|metrictag.html]]]</metricTag> </tags> </metricValue>
{ "name" : "value", "value" : 247.0, "tags" : "[[[metricTags...|metrictags.html]]]" }
Last modified: 18 August 2026