The stats API returns the current Watcher metrics.

Request

GET _watcher/stats

GET _watcher/stats/<metric>

Description

This API always returns basic metrics. You retrieve more metrics by using the metric parameter.

Current executing watches metric

The current executing watches metric gives insight into the watches that are currently being executed by Watcher. Additional information is shared per watch that is currently executing. This information includes the watch_id, the time its execution started and its current execution phase.

To include this metric, the metric option should be set to current_watches or _all. In addition you can also specify the emit_stacktraces=true parameter, which adds stack traces for each watch that is being executed. These stack traces can give you more insight into an execution of a watch.

Queued watches metric

Watcher moderates the execution of watches such that their execution won’t put too much pressure on the node and its resources. If too many watches trigger concurrently and there isn’t enough capacity to execute them all, some of the watches are queued, waiting for the current executing watches to finish their execution. The queued watches metric gives insight on these queued watches.

To include this metric, the metric option should include queued_watches or _all.

Path Parameters

Authorization

You must have manage_watcher or monitor_watcher cluster privileges to use this API. For more information, see Security Privileges.

Examples

The following example calls the stats API to retrieve basic metrics:

GET _watcher/stats

A successful call returns a JSON structure similar to the following example:

{
   "watcher_state": "started",  
   "watch_count": 1, 
   "execution_thread_pool": {
      "size": 1000, 
      "max_size": 1 
   }
}

The following example specifies the metric option as a query string argument and will include the basic metrics and metrics about the current executing watches:

GET _watcher/stats?metric=current_watches

The following example specifies the metric option as part of the url path:

GET _watcher/stats/current_watches

The following snippet shows an example of a successful JSON response that captures a watch in execution:

{
   "watcher_state": "started",
   "watch_count": 2,
   "execution_thread_pool": {
      "queue_size": 1000,
      "max_size": 20
   },
   "current_watches": [ 
      {
         "watch_id": "slow_condition", 
         "watch_record_id": "slow_condition_3-2015-05-13T07:42:32.179Z", 
         "triggered_time": "2015-05-12T11:53:51.800Z", 
         "execution_time": "2015-05-13T07:42:32.179Z", 
         "execution_phase": "condition" 
      }
   ]
}

The following example specifies the queued_watches metric option and includes both the basic metrics and the queued watches:

GET _watcher/stats/queued_watches

An example of a successful JSON response that captures a watch in execution:

{
   "watcher_state": "started",
   "watch_count": 10,
   "execution_thread_pool": {
      "queue_size": 1000,
      "max_size": 20
   },
   "queued_watches": [ 
         {
            "watch_id": "slow_condition4", 
            "watch_record_id": "slow_condition4_223-2015-05-21T11:59:59.811Z", 
            "triggered_time": "2015-05-21T11:59:59.811Z", 
            "execution_time": "2015-05-21T11:59:59.811Z" 
         },
      ...
   ]
}