points

POST

/metrics/v2/points

curl --request POST \
  --url https://api.siteqwality.com/metrics/v2/points \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "metric": "example", "range": { "from": "example", "to": "example" }, "series_ids": [ "example" ], "interval": "example" }'

• Production

Authorizations

• bearer_auth

Request Body ^required

Media type application/json

object

metric

required

string

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

series_ids

required

Decimal UInt64 strings from the series endpoint, at most 100.

Array<string>

interval

T2 interval or auto, with at most 300 buckets per series.

string | null

Example ^generated

{
  "metric": "example",
  "range": {
    "from": "example",
    "to": "example"
  },
  "series_ids": [
    "example"
  ],
  "interval": "example"
}

Responses

200

OK

Media type application/json

object

data

required

Array<object>

object

series_id

required

string

timestamp

required

string

start_time

required

string

bucket

required

string

kind

required

string

flags

required

integer format: int32

samples

required

integer format: int64

value

number | null format: double

histogram

One of:

object

object

temporality

required

string

layout

required

string

layout_id

required

string

count

required

string

sum

number | null format: double

min

number | null format: double

max

number | null format: double

bounds

required

Array<number>

bucket_counts

required

Array<string>

scale

required

integer format: int32

zero_count

required

string

positive

required

object

key

additional properties

string

negative

required

object

key

additional properties

string

null

null

step_seconds

required

integer format: int64

aggregation

required

Last ingested sample per bucket, kind and flags, without rate or increase math.

string

meta

required

object

from

required

string

to

required

string

clamped_from

string | null

partial

required

boolean

slow_terms

required

Array<string>

Example ^generated

{
  "data": [
    {
      "series_id": "example",
      "timestamp": "example",
      "start_time": "example",
      "bucket": "example",
      "kind": "example",
      "flags": 1,
      "samples": 1,
      "value": 1,
      "histogram": {
        "temporality": "example",
        "layout": "example",
        "layout_id": "example",
        "count": "example",
        "sum": 1,
        "min": 1,
        "max": 1,
        "bounds": [
          1
        ],
        "bucket_counts": [
          "example"
        ],
        "scale": 1,
        "zero_count": "example",
        "positive": {
          "additionalProperty": "example"
        },
        "negative": {
          "additionalProperty": "example"
        }
      }
    }
  ],
  "step_seconds": 1,
  "aggregation": "example",
  "meta": {
    "from": "example",
    "to": "example",
    "clamped_from": "example",
    "partial": true,
    "slow_terms": [
      "example"
    ]
  }
}

400

Invalid query, data contains QueryError

403

Signal restricted

429

Read quota exhausted

503

Telemetry paused, busy or unavailable

504

Narrow the query