Skip to Content
Mux Docs: Home
Get Monitoring Timeseries
get

Gets Time series information for a specific metric along with the number of concurrent viewers.

Request path & query params
MONITORING_METRIC_ID
string
Possible values: "current-concurrent-viewers""current-rebuffering-percentage""exits-before-video-start""playback-failure-percentage""current-average-bitrate""video-startup-failure-percentage"

ID of the Monitoring Metric

filters[]
array

Limit the results to rows that match conditions from provided key:value pairs. Must be provided as an array query string parameter.

To exclude rows that match a certain condition, prepend a ! character to the dimension.

Possible filter names are the same as returned by the List Monitoring Dimensions endpoint.

Example:

  • filters[]=operating_system:windows&filters[]=!country:US
timestamp
integer

Timestamp to use as the start of the timeseries data. This value must be provided as a unix timestamp. Defaults to 30 minutes ago.

get
200
/data/v1/monitoring/metrics/{MONITORING_METRIC_ID}/timeseries
Response
(application/json)
{
  "data": [
    {
      "concurrent_viewers": 2790,
      "date": "2021-01-08T15:31:20Z",
      "value": 2790
    },
    {
      "concurrent_viewers": 2788,
      "date": "2021-01-08T15:31:25Z",
      "value": 2788
    },
    {
      "concurrent_viewers": 2791,
      "date": "2021-01-08T15:31:30Z",
      "value": 2791
    },
    {
      "concurrent_viewers": 2791,
      "date": "2021-01-08T15:31:35Z",
      "value": 2791
    },
    {
      "concurrent_viewers": 2792,
      "date": "2021-01-08T15:31:40Z",
      "value": 2792
    }
  ],
  "timeframe": [
    1610119880,
    1610121675
  ],
  "total_row_count": 1
}