ezgh obs alert-rules apply

ezgh obs alert-rules apply -f <file.json> [flags]

Make an alert rule match a JSON file: the rule’s document, as the console’s JSON tab and get -o json show it (the fields obs-api adds, such as status and version, are ignored). The rule is the one the file’s id or slug names (it must exist), else the one named name, if exactly one is. When there’s none, apply creates it.

An update replaces the fields the file has (the condition whole); fields the file leaves out stay as they are. It’s sent with the ETag ezgh just read: if someone saves the rule in between, nothing changes, and ezgh says to run apply again. obs-api checks the rule first: each problem is printed as path: message, and a rule that would read more than an evaluation may is refused (rule_too_expensive). Creating or changing a condition also needs read access to what it reads (obs.metrics.query, or obs.logs.search or obs.traces.search on its dataset).

Keep rule files next to the service they watch, and apply them from CI.

Part of ezgh obs alert-rules.

Examples

ezgh obs alert-rules apply -f alerts/high-latency.json
ezgh obs alert-rules get "High API latency" -o json > rule.json   # edit, then:
ezgh obs alert-rules apply -f rule.json

Flags

This command also takes the global flags.