Metrics API Occurrence Query Examples

Below are examples of the format of the request body for queries to the occurrence metrics API endpoint

https://docs.rollbar.com/reference/post_api-1-metrics-occurrences

Query time format

The start_time and end_time in the queries is unix epoch time in seconds

Example 1

This query returns an occurrence count of info and higher occurrences grouped by environment and level

{
  "start_time": start_time,
  "end_time":  end_time,
    "group_by": ["environment", "item_level"],
      "filters": [
        {
          "field": "item_level",
          "values": ["error", "critical", "warning", "info"],
          "operator": "eq"
        }
      ]
}

Example 2

This query returns the item_count and occurrence_id for every occurrence associated with a specific person_ids in a given time window

{
  "start_time": starttime_unix,
  "end_time":  endtime_unix,
  "group_by": ["item_counter", "occurrence_id"],
  "filters": [
   {
     "field": "person_id",
      "values": ["12345", "67890"],
      "operator": "eq"
   }
  ]
}

Example 3

This query gives the occurrence counts of each level in a time window. The date returned is for each hour in the time window.
This type of query is useful to see the pattern of occurrence counts over a period of time

{
    "filters": [{ "field": "item_level", 
                    "values": ["warning", "error", "critical"],
                    "operator": "eq"
                }],
    "start_time": starttime_unix,
    "end_time": endtime_unix,
    "group_by": ["item_level"],
    "granularity": "hour",
    "timezone": "US/Pacific"
}

Example 4

The occurrence counts for each item that is occurring in an environment. Each code_version is grouped separately. This could be useful if multiple code_versions are running concurrently

{
    "filters": [{ "field": "item_level", 
                    "values": ["error", "critical"],
                    "operator": "eq"
                },
                {"field": "environment",
                "values": ["production"],
                "operator": "eq"
                }
                ],
    "start_time": start_time,
    "end_time": end_time,
    "group_by": ["code_version", "item_counter", "environment", "item_level"],
    "granularity": "hour",
    "timezone": "US/Pacific"
}

Updated about 1 year ago