โ† API reference
Query / devices

aggregateMetricPoints

Aggregate metric data points into time buckets with configurable statistics. Automatically routes to pre-computed continuous aggregates for HOUR/DAY/WEEK/MONTH intervals. Supports gap-filling (LOCF/interpolation), time-weighted averages, and counter delta/rate via Toolkit. For counter metrics, computes delta (last-first) per bucket instead of average. Requires metric:read permission.

Arguments

Aggregation parameters

Returns MetricAggregatePointsResult!

Scalar fields at a glance

metricIdMetricID!
totalCountInt!
โ†— View the complete MetricAggregatePointsResult type

Explore in a view

Device Fleet
View exact SDL
"""
Aggregate metric data points into time buckets with configurable statistics. Automatically routes to pre-computed continuous aggregates for HOUR/DAY/WEEK/MONTH intervals. Supports gap-filling (LOCF/interpolation), time-weighted averages, and counter delta/rate via Toolkit. For counter metrics, computes delta (last-first) per bucket instead of average. Requires metric:read permission.
"""
aggregateMetricPoints(
  """Aggregation parameters"""
  input: AggregateMetricPointsInput!
): MetricAggregatePointsResult! @topic(names: ["devices"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.