deviceSummary

Query

Summarizes devices over a time range.

Response

Returns DeviceSummary

Arguments

Name	Type	Description
`startTime`	`DateTimeOffset!`	Start time for the summary.
`endTime`	`DateTimeOffset!`	End time for the summary.
`filter`	`FilterDeviceSummaryInput`	If provided, only summarize devices matching the filter.
`deviceBucket`	`DeviceSummaryBucketType`	If provided, group the summary buckets by the provided grouping types.

Example

query deviceSummary(
  $startTime: DateTimeOffset!,
  $endTime: DateTimeOffset!,
  $filter: FilterDeviceSummaryInput,
  $deviceBucket: DeviceSummaryBucketType
) {
  deviceSummary(
    startTime: $startTime,
    endTime: $endTime,
    filter: $filter,
    deviceBucket: $deviceBucket
  ) {
    total
    buckets {
      key {
        time
      }
      total
    }
    highestTotalBuckets {
      key {
        time
      }
      total
    }
  }
}

{
  "startTime": "2025-01-01T00:00:00.000Z",
  "endTime": "2025-01-01T00:00:00.000Z"
}

{
  "data": {
    "deviceSummary": {
      "total": 92,
      "buckets": [
        {
          "key": {
            "time": "2025-01-01T00:00:00.000Z"
          },
          "total": 872
        }
      ],
      "highestTotalBuckets": [
        {
          "key": {
            "time": "2025-01-01T00:00:00.000Z"
          },
          "total": 503
        }
      ]
    }
  }
}