Loading

Logging action

Stack

Use the logging action to write text to the standard Elasticsearch logs when watch conditions are met. This action is primarily used during development and debugging to verify watch execution and inspect payload data.

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:

"actions" : {
  "log" : {
    "transform" : { ... },
    "logging" : {
      "text" : "executed at {{ctx.execution_time}}"
    }
  }
}
		
  1. The id of the action.
  2. An optional transform to transform the payload before executing the logging action.
  3. The text to be logged.
Name Required Default Description
text yes - The text that should be logged. Can be static text or include Mustache 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.