Skip to content

Commit

Permalink
Clarify "Top level ORs" (#25505)
Browse files Browse the repository at this point in the history
* Clarify "Top level ORs"

Adding an example to clarify what "Top level ORs" are, in response to some customer confusion

* Update content/en/monitors/downtimes/_index.md

---------

Co-authored-by: Michael Cretzman <[email protected]>
  • Loading branch information
DavidGrashton and michaelcretzman authored Oct 3, 2024
1 parent 9ecc204 commit 00dac27
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion content/en/monitors/downtimes/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ There are a few limitations that are **not supported** which include:

* More than two levels of nesting, such as `team:app AND (service:auth OR (service:graphics-writer AND (env:prod OR (type:metric AND status:ok))))`, are not supported. At most, Downtimes accept two levels of nesting. Use separate Downtimes instead to break down the logic.
* Negation is only supported for key/value pairs and tags with `OR`. For example, `-key:value` and `-key(A OR B)`. Scopes such as `-service:(A AND B)`, `service:(-A OR -B)`, or `-service(A B)` are not supported.
* Top level ORs are not supported, for example, `service:A OR host:X`. This requires two separate Downtimes.
* Top level ORs are not supported. For example, `service:A OR service:B` is valid, but `service:A OR host:X` does not work. An `OR` between two different top level tags requires two separate Downtimes.
* Keyless tags, such as `prod AND service:(A or B)` or just `prod`, aren't supported. Tags need to have a key, in this case for example `env:prod`.
* Question mark wildcards: `service:auth?` are not supported. Use `*` instead if you need to use wildcards.
* Invalid characters within the key: `en&v:prod` is not a valid Downtime scope and will be rejected.
Expand Down

0 comments on commit 00dac27

Please sign in to comment.