Guides & SDKsAPI Reference
Log InSign Up

Metrics API Occurrence Query Examples

Suggest Edits

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 5 months ago