#docs #tql

Group By Query

Groups a set of events by a set of dimensions and aggregates them by a set of metrics.

A group by query can group arbitrary values using aggregations and post-aggregations. This is slightly more complicated than the Top N query, but allows you more flexibility and more complex queries.


  "aggregations": [
      "fieldName": "count",
      "name": "Number of Signals",
      "type": "longSum"
  "dataSource": "telemetry-signals",
  "dimensions": [
      "dimension": "majorSystemVersion",
      "outputName": "Major System Version",
      "outputType": "STRING",
      "type": "default"
  "filter": {
    "dimension": "appID",
    "type": "selector",
    "value": "AAABBBCCC"
  "granularity": "all",
  "queryType": "groupBy"


All default properties and the following properties are supported:

dimensionsA list of DimensionSpec objects to do the groupBy over.