The user can retrieve telemetry data that has been aggregated across a group of sites via the endpoint /telemetry/history/operational/aggregate. This endpoint has the following additional query parameters that are applied after any individual telemetry signal parameters that have been defined are applied:

• group rollup: This parameter defines the function applied to each concurrent period across all of the sites in the group. The “rollup” is applied to the site-level timeseries, while the “group_rollup” is applied across the set of sites in the group. The options include:
  • sum
  • mean
• group fill: This parameter defines the function used for sites for which a specified period contains no raw telemetry data from any site. If raw telemetry data is available for any site in the group for the specified period, then the following fill function does not apply. The “fill” applies to the site-level timeseries, while the “group_fill” applies only when none of the sites have data. Periods that contain no data can be reported by the following methods:
  • none - Reports no timestamp and no value for the period with no data
  • null - Reports null for the period with no data but returns a timestamp
  • previous - Reports the value from the previous period at the same site for the adjacent periods with no data
  • linear - Performs linear interpolation between the adjacent periods for the site, for the period with no data