Alarm on a custom metric

Put an alarm on a series you publish yourself, named by its namespace, metric name and dimensions.

Last updated 18 November 2026View as Markdown

An alarm on a custom series names the series rather than a resource: resourceType custom, resourceId the namespace, metric the metric name, and dimensions exactly the series' dimensions. A series with other dimensions is another series. The series need not exist yet: until it has datapoints in the evaluated periods, the alarm is INSUFFICIENT_DATA.

You can also alarm on a namespace the platform writes for you, such as EWS/Scheduler.

Prerequisites

  • Permission for monitoring:PutMetricAlarm on rn:ews::<organization id>:monitoring:*.

Create the alarm

Not available in Console. The console's alarm form lists resources, not custom series.

Alarm when something stops

A missing datapoint never crosses a threshold, so an alarm on a series that stops arriving goes to INSUFFICIENT_DATA, not to ALARM. Publish a zero while there is nothing to count (orders_placed with value: 0) and alarm on sum < 1.

When the alarm is refused

  • 400 "dimensions: Dimensions are for custom metrics only" when an alarm on a resource names dimensions.
  • 400 "resourceId: For a custom metric, resourceId is its namespace (letters, digits and . _ / # : -)".
  • 409 when the name is taken, as for any alarm.
Did this page help you?