GET /metrics/{metric}

Get the results for the metric.

You can query the metric based on the start time of the slices in which the data falls. The interval you can specify is: [start, end). Response data is by default sorted on start time, ascending. You can use ascending parameter to sort it descending. There is also an option to sort the data by an other field than the start_time.

Filtering is only supported on the environment of the data.

In order to keep the response small enough, we limit by default the number of metric entries to 1000. If you want more data, you should set it to the wanted number of entries.

Get the data from metric.

GET /metrics/{metric}

Parameters

Type Name Description Schema Default

Path

metric
required

The metric to query, for a list of queryable metrics, see metrics/

string

Query

ascending
optional

A boolean to indicate if the sorting should happen ascending or descending.

boolean

"true"

Query

environment
optional

The environment for which to fetch metrics, if left empty all environments will be used

string

Query

limit
optional

The limit on the number of response values to give.

integer

1000

Query

orderby
optional

The field to order by in the response, these fields need to be present in the queried metric

string

"start_time"

Query

start_time
optional

Range query to select the time frame for which to request data. Allowed fields are gte and lt. Values should be ISO timestamps, with no minutes nor seconds. If gte and lt properties are equal, no data will be returned.

object

Responses

HTTP Code Description Schema

200

OK

400

Error in the query parameters

No Content

404

Metric not found

No Content

500

Error in processing the query

No Content

Produces

  • application/json


MetricOutput

Name Description Schema

nr_results
optional

The number of results in the results list
Example : 1

integer

query_params
optional

This will echo the parameters from the query.

results
optional

total_nr_results
optional

The total number of results that could be found in the results set
Example : 1

integer

query_params

Name Description Schema

ascending
optional

Example : true

boolean

environment
optional

string

limit
optional

Example : 1000

integer

orderby
optional

Example : "time"

string

start_time
optional

start_time

Name Description Schema

gte
optional

ISO timestamp, with 00:00 for minutes, seconds.
Example : "2020-04-01T00:00:00Z"

string

lt
optional

ISO timestamp, with 00:00 for minutes, seconds.
Example : "2020-05-01T00:00:00Z"

string

MetricResults

Type : < MetricResult > array

MetricResult

Name Description Schema

start_time
required

the start of the interval for which this is the value

integer

value
required

the value of the metric

number