2019-09-10 13:32:51 -04:00
|
|
|
[role="xpack"]
|
2017-03-28 17:23:01 -04:00
|
|
|
[[actions-logging]]
|
|
|
|
=== Logging Action
|
|
|
|
|
|
|
|
Use the `logging` action to log text to the standard Elasticsearch
|
|
|
|
logs. See <<logging-action-attributes>> for the supported attributes.
|
|
|
|
|
|
|
|
This action is primarily used during development and for debugging purposes.
|
|
|
|
|
|
|
|
[[configuring-logging-actions]]
|
2019-09-30 13:18:50 -04:00
|
|
|
==== Configuring logging actions
|
2017-03-28 17:23:01 -04:00
|
|
|
|
|
|
|
You configure logging actions in the `actions` array. Action-specific attributes
|
|
|
|
are specified using the `logging` keyword.
|
|
|
|
|
|
|
|
The following snippet shows a simple logging action definition:
|
|
|
|
|
|
|
|
[source,js]
|
|
|
|
--------------------------------------------------
|
|
|
|
"actions" : {
|
|
|
|
"log" : { <1>
|
|
|
|
"transform" : { ... }, <2>
|
|
|
|
"logging" : {
|
|
|
|
"text" : "executed at {{ctx.execution_time}}" <3>
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
--------------------------------------------------
|
2018-06-22 21:09:37 -04:00
|
|
|
// NOTCONSOLE
|
2017-03-28 17:23:01 -04:00
|
|
|
<1> The id of the action.
|
|
|
|
<2> An optional <<transform, transform>> to transform the payload before
|
|
|
|
executing the `logging` action.
|
|
|
|
<3> The text to be logged.
|
|
|
|
|
|
|
|
|
|
|
|
[[logging-action-attributes]]
|
2019-09-30 13:18:50 -04:00
|
|
|
==== Logging action attributes
|
2017-03-28 17:23:01 -04:00
|
|
|
|
|
|
|
[options="header"]
|
|
|
|
|======
|
|
|
|
| Name |Required | Default | Description
|
|
|
|
|
|
|
|
| `text` | yes | - | The text that should be logged. Can be static text or
|
|
|
|
include Mustache <<templates, templates>>.
|
|
|
|
|
|
|
|
| `category` | no | xpack.watcher.actions.logging | The category under which the text will be logged.
|
|
|
|
|
|
|
|
| `level` | no | info | The logging level. Valid values are: `error`, `warn`,
|
|
|
|
`info`, `debug` and `trace`.
|
|
|
|
|======
|