stats

Returns historical data for the checks and the interval indicated.

Authentication required. User should be part of the check's organization.

post/stats/checks/interval/{interval}

Request

  • Base URL: https://api.30mhz.com/api
  • URL: https://api.30mhz.com/api/stats/checks/interval/{interval}
  • Auth: API key in header Authorization

Path parameters

intervalstring required

Intervals allowed : c, today, (f)1h, (f)2h, ..., (f)xh, (f)1d, (f)2d, ..., (f)xd, (f)1w, (f)2w, ..., (f)xw, (f)1M, (f)2M, ..., (f)xM.

Query parameters

statisticTypestring required

Current statistics supported : averages, counts, maxs, mins, sums.

intervalSizestring required

Size of the time intervals in which to aggregate the data. This parameter is given as a number of minutes, hours, days or weeks, or monthly, e.g. '5m' is five minutes, '1h' is one hour, '5d' is five days, '2w' is two weeks and 'M' is monthly. The optional 'f' prefix is used to retrieve the full interval according to the provided unit, e.g. 'f1w' will retrieve the last full week (Mon to Sun), 'f2d' will retrieve the last two full days (Wed and Thu if it is Fri).

locationstring

Optionally filter only the data from one location. Leave empty or set to 'all' to get all locations

cumulativeboolean

Optional - accumulate the values.

derivativeboolean

Optional - derivative of the values.

timezoneOffsetinteger

The timezone offset, in hours, for which to return the data. For example, 2 for Europe/Amsterdam. -3 for America/Argentina/Buenos_Aires. If empty, then UTC/GMT time is assumed, but it's probably not what you want. See list of timezones: <a>https://en.wikipedia.org/wiki/List_of_tz_database_time_zones</a>

fieldsstring

Optional - list of json fields for which the values should be returned. Separated by comma (,).

debugboolean

Send debug info in the response, such as timestamp in a user friendly format.

partOfDaystring

Optional - filter by daytime or nighttime.

Request body

checkIdsstring[]

Check ids for returning the historical data.

collectionIdsPerFieldobject

Filter/group values based on fields and collection ids

daysOfMonthinteger[]

Day (1-31) list parameter, e.g. [1] for the first of the month.

daysOfWeekinteger[]

Day of the week (1-7) list parameter, e.g. [1] for Monday.

hoursOfDayinteger[]

Hour (0-23) list parameter, e.g. [2, 3] for 2:00 am and 3:00 am.

minutesOfHourinteger[]

Minute within the hour (0-59) list parameter, e.g. [20, 30] for 20th and 30th minute.

organizationIdstring

The id of an organization (when tags are set).

sensorTypestring

The id of a sensor type (when tags are set).

tagsstring[]

Set tags to automatically select checks based on their tags.

tagsOperatorstring

Tags boolean operator (and/or).

Response

Historical data of the check in the requested interval

object required

Changes

No recorded changes to this operation across all 1 revision of this API.