Skip to main content
An alert (monitor) reacts to a trigger by opening an issue and/or notifying Slack channels and webhooks. Pick one of three trigger types with trigger.type; the type is immutable once created (a change is delete-and-recreate).

​
Threshold

Watch a metric aggregate over a rolling window. Opens an issue when it crosses the threshold, and optionally notifies Slack/webhooks. metric is the metric’s slug (a custom metric you defined, or a Roark system metric); the variant defaults to the metric’s default.

​
Event

Fire on platform events (call/chat analysis, simulation jobs, metric collection, issues).

​
Simulation

Notify on a simulation run-plan job outcome. runPlan (by name) scopes it to one run plan; omit for project-wide. A simulation alert requires exactly one Slack channel and does not support webhooks.
  • Threshold alerts always open an issue; Slack and webhook delivery are optional additions.
  • Slack channels are referenced by their Slack-native channelId (e.g. C0123ABC) plus a channelName. The Slack workspace is resolved from the project’s connected Slack integration, so no UUIDs go in config.
  • Webhooks must be public http(s) URLs.
Referencing a Slack channel requires a Slack integration connected to the project in Roark first. Connect Slack under the project’s integration settings, then reference the channel by id here.
For the full field reference of every kind, see the Config DSL reference schema.