AutoMerge is generally available

Generated at:

Component schema

ServiceStatistic

string1 direct reference

Definition

Selects which statistics the server computes. The unit of selection is the measurement, not the response field, which is why the granularity differs between the status breakdown and the duration distribution.

  • count: total request count.
  • statusCounts: the per-status request breakdown, as a whole. It has no leaf members: unset, ok and error are a closed partition of OTel's StatusCode, produced by a single aggregate over the status key, so requesting a proper subset saves nothing. Leaf members would advertise configurability this endpoint cannot deliver.
  • duration: prefix alias for all nine duration fields.
  • duration.min, duration.max, duration.sum, duration.avg, duration.p50, duration.p75, duration.p90, duration.p95, duration.p99: individually selectable. Unlike the status breakdown these are an open set of distinct aggregate functions — each is its own aggregate, and a tenth (say p999) could be added without disturbing the existing nine.

Four rules govern the vocabulary. None is expressible in OpenAPI, so this description is where they live.

  1. duration means all nine fields. It previously meant only the four scalars, alongside a separate durationPercentiles member; both are gone, and "scalars only" is now those four leaves spelled out.
  2. The list is a set. Duplicates and overlaps collapse: ["duration", "duration.p99"] is the same request as ["duration"], not an error. uniqueItems is deliberately not set: it would reject a repeated member rather than collapse it.
  3. Cost is documented, never encoded. Naming any duration.p* pays an exponential-histogram bucket read; count, statusCounts and the four scalar duration fields come off scalar columns. That is guidance for callers, not a viability constraint: no member implies any other, and the server never widens a request to a superset.
  4. Ordering requires coverage, not an exact match. An alias covers its leaves, so ordering by duration.p99 is satisfied by either duration.p99 or duration, and ordering by statusCounts.error is satisfied by statusCounts. An ordering key the requested set does not cover is rejected with 400, rather than silently added, so a sort can never widen the query beyond what was asked for; the error message names both the offending ordering key and the statistic that would have covered it. Note that statusCounts does not cover count, even though the three counts sum to it, which is why errorRate requires both — rejected the same way, naming count and statusCounts as what is missing.
string
Allowed values"count""statusCounts""duration""duration.min""duration.max""duration.sum""duration.avg""duration.p50""duration.p75""duration.p90""duration.p95""duration.p99"

Used by 1

These schemas and endpoints reference this type directly.