Skip to main content
POST
Create an alert

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Body for creating a threshold alert in a project.

aggregation
enum<string>
required
Available options:
sum,
avg,
count,
max,
min,
p50,
p75,
p90,
p95,
p99,
uniq
measure
string
required

A measure of the view, e.g. latency, cost, count

name
string
required
project_id
string
required
renotify
AlertRenotifyRequest · object
required

How often an alert re-notifies while it stays in the alerting state.

threshold
number
required
threshold_operator
enum<string>
required
Available options:
>,
>=,
<,
<=,
=,
!=
view
string
required
Allowed value: "SPANS"
window
enum<string>
required
Available options:
1m,
5m,
10m,
30m,
1h,
2h
filters
AlertFilterItemRequest · object[]

Row predicates the measure is evaluated over

no_data_mode
enum<string> | null

What a window that measured nothing means; column default when omitted

Available options:
HOLD,
ZERO,
NOTIFY

Response

Successful Response

The created alert with its full rule (alert creation is strict, never idempotent).

alert
AlertDetail · object
required

One alert with its full rule: the summary plus filters and gap handling.

created
boolean
required