› › ›

Watcher 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

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}}" 
    }
  }
}

	The id of the action.
	An optional transform to transform the payload before executing the `logging` action.
	The text to be logged.

Logging action attributes

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`.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/actions-logging.html