CLcloudzero
monitors

Create monitor

Changed on

Creates a monitor. Returns 409 with the existing monitor in error.existing_id if another monitor already has the same filter_set, group_by, threshold, and cost_type, so a retried create can adopt it.

post/v2/monitors

Request

Request body

cost_type'REAL_COST' | 'AMORTIZED_COST' | 'BILLED_COST' | 'CUSTOM_COST' | 'DISCOUNTED_AMORTIZED_COST' | 'DISCOUNTED_COST' | 'INVOICED_AMORTIZED_COST' | 'ON_DEMAND_COST'
descriptionstring nullable

Optional human-readable description for the monitor

detection_type'anomaly'

The type of detection to perform. Currently only "anomaly" is supported.

filter_setobject

Cost filters for the monitor. An empty object is valid.

group_bystring[]

Dimensions to group by. Empty means no grouping; create/update requests are capped to a single dimension.

is_enabledboolean

Whether the monitor is running. When false the monitor will not be sent for evaluation.

monitor_namestring required

Human-readable name for the monitor

Response

Successful Response

cost_type'REAL_COST' | 'AMORTIZED_COST' | 'BILLED_COST' | 'CUSTOM_COST' | 'DISCOUNTED_AMORTIZED_COST' | 'DISCOUNTED_COST' | 'INVOICED_AMORTIZED_COST' | 'ON_DEMAND_COST'
created_atstring date-time required

When the monitor was created, as an ISO 8601 UTC timestamp

descriptionstring nullable

Optional human-readable description for the monitor

detection_type'anomaly'

The type of detection to perform. Currently only "anomaly" is supported.

filter_setobject

Cost filters for the monitor. An empty object is valid.

group_bystring[]

Dimensions to group by. Empty means no grouping; create/update requests are capped to a single dimension.

is_enabledboolean

Whether the monitor is running. When false the monitor will not be sent for evaluation.

last_triggered_atstring date-time nullable

When the monitor last raised an incident, as an ISO 8601 UTC timestamp; null until it first raises one.

monitor_idstring required

Unique identifier for the monitor

monitor_namestring required

Human-readable name for the monitor

open_incident_countinteger nullable

Number of unresolved incidents at read time; null if they could not be counted.

owner_idstring required

Email of the user who created the monitor; system for monitors CloudZero creates; Set via API for monitors created with an API key.

total_incident_countinteger

Total incidents this monitor has ever fired, including resolved ones.

updated_atstring date-time required

When the monitor was last updated, as an ISO 8601 UTC timestamp

Changes