45 lines
2.1 KiB
Plaintext
45 lines
2.1 KiB
Plaintext
[[condition]]
|
|
== Conditions
|
|
|
|
When a watch is triggered, its condition determines whether or not to execute
|
|
the watch actions. {watcher} supports the following condition types:
|
|
|
|
* <<condition-always, `always`>>: set the watch condition to `true` so the watch
|
|
actions are always executed.
|
|
* <<condition-never, `never`>>: set the watch condition to `false` so the watch
|
|
actions are never executed.
|
|
* <<condition-compare, `compare`>>: perform simple comparisons against values
|
|
in the watch payload to determine whether or not to execute the watch actions.
|
|
* <<condition-array-compare, `array_compare`>>: compare an array of values in the
|
|
watch payload to a given value to determine whether or not to execute the watch
|
|
actions.
|
|
* <<condition-script, `script`>>: use a script to determine whether or not to
|
|
execute the watch actions.
|
|
|
|
NOTE: If you omit the condition definition from a watch, the condition defaults
|
|
to `always`.
|
|
|
|
When a condition is evaluated, it has full access to the watch execution context,
|
|
including the watch payload (`ctx.payload.*`). The <<condition-script, script>>,
|
|
<<condition-compare, compare>> and <<condition-array-compare, array_compare>>
|
|
conditions can use the payload data to determine whether or not the necessary
|
|
conditions are met.
|
|
|
|
In addition to the watch wide condition, you can also configure conditions
|
|
per <<action-conditions, action>>.
|
|
|
|
:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/condition/always.asciidoc
|
|
include::condition/always.asciidoc[]
|
|
|
|
:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/condition/never.asciidoc
|
|
include::condition/never.asciidoc[]
|
|
|
|
:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/condition/compare.asciidoc
|
|
include::condition/compare.asciidoc[]
|
|
|
|
:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/condition/array-compare.asciidoc
|
|
include::condition/array-compare.asciidoc[]
|
|
|
|
:edit_url: https://github.com/elastic/elasticsearch/edit/{branch}/x-pack/docs/en/watcher/condition/script.asciidoc
|
|
include::condition/script.asciidoc[]
|