Sign in

v5

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-02-283466592.5 MB
Account usage (beta)

Get observability sessions usage

Get time-series arrays of the number of observability sessions. Supports daily and monthly granularity.

get/api/v2/usage/observability/sessions

Query parameters

fromstring string

The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.

The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.

tostring string

The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.

The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.

projectKeystring string

A project key to filter results by. Can be specified multiple times, one query parameter per project key.

A project key to filter results by. Can be specified multiple times, one query parameter per project key.

granularitystring string

Specifies the data granularity. Defaults to daily. Valid values depend on aggregationType: month_to_date supports daily and monthly; incremental and rolling_30d support daily only.

Specifies the data granularity. Defaults to daily. Valid values depend on aggregationType: month_to_date supports daily and monthly; incremental and rolling_30d support daily only.

aggregationTypestring string

Specifies the aggregation method. Defaults to month_to_date.<br/>Valid values: month_to_date, incremental, rolling_30d.

Specifies the aggregation method. Defaults to month_to_date.<br/>Valid values: month_to_date, incremental, rolling_30d.

Response

Usage response

_linksobject required

The location and content type of related resources

metadataSeriesMetadataRep[] required

Metadata about each series

seriesSeriesTimeSliceRep[] required

An array of data points with timestamps. Each element of the array is an object with a 'time' field, whose value is the timestamp, and one or more key fields. If there are multiple key fields, they are labeled '0', '1', and so on, and are explained in the <code>metadata</code>.

Example response

{
  "series": [
    {
      "0": 11,
      "1": 15,
      "time": 1677888000000
    }
  ]
}