diff --git a/docs/reference/ingest/apis/enrich/enrich-stats.asciidoc b/docs/reference/ingest/apis/enrich/enrich-stats.asciidoc
index d1b82907848..550374abd54 100644
--- a/docs/reference/ingest/apis/enrich/enrich-stats.asciidoc
+++ b/docs/reference/ingest/apis/enrich/enrich-stats.asciidoc
@@ -3,24 +3,121 @@
[[enrich-stats-api]]
=== Enrich stats API
++++
-Enrich stats API
+Enrich stats
++++
-Returns enrich coordinator stats and information about currently executing enrich policies.
+Returns <> statistics
+and information about enrich policies
+that are currently executing.
-[source,js]
---------------------------------------------------
+[source,console]
+----
GET /_enrich/_stats
---------------------------------------------------
-// CONSOLE
-// TEST
+----
+
+
+[[enrich-stats-api-request]]
+==== {api-request-title}
+
+`GET /_enrich/_stats`
+
+
+[[enrich-stats-api-response-body]]
+==== {api-response-body-title}
+
+`executing_policies`::
++
+--
+(Array of objects)
+Objects containing information
+about each enrich policy
+that is currently executing.
+
+Returned parameters include:
+
+`name`::
+(String)
+Name of the enrich policy.
+
+`task`::
+(<>)
+Object containing detailed information
+about the policy execution task.
+--
+
+`coordinator_stats`::
++
+--
+(Array of objects)
+Objects containing information
+about each <>
+for configured enrich processors.
+
+Returned parameters include:
+
+`node_id`::
+(String)
+ID of the ingest node coordinating search requests
+for configured enrich processors.
+
+`queue_size`::
+(Integer)
+Number of search requests in the queue.
+
+`remote_requests_current`::
+(Integer)
+Current number of outstanding remote requests.
+
+`remote_requests_total`::
+(Integer)
+Number of outstanding remote requests executed
+since node startup.
++
+In most cases,
+a remote request includes multiple search requests.
+This depends on the number of search requests in the queue
+when the remote request is executed.
+
+`executed_searches_total`::
+(Integer)
+Number of search requests
+that enrich processors have executed
+since node startup.
+--
+
+
+[[enrich-stats-api-example]]
+==== {api-examples-title}
+
+
+[source,console]
+----
+GET /_enrich/_stats
+----
+//TEST[s/^/PUT \/_enrich\/policy\/my-policy\/_execute\/n/\
The API returns the following response:
-[source,js]
---------------------------------------------------
+[source,console-result]
+----
{
- "executing_policies": [],
+ "executing_policies": [
+ {
+ "name": "my-policy",
+ "task": {
+ "id" : 124,
+ "type" : "direct",
+ "action" : "cluster:admin/xpack/enrich/execute",
+ "start_time_in_millis" : 1458585884904,
+ "running_time_in_nanos" : 47402,
+ "cancellable" : false,
+ "parent_task_id" : "oTUltX4IQMOUUVeiohTt8A:123",
+ "headers" : {
+ "X-Opaque-Id" : "123456"
+ }
+ },
+ }
+ ],
"coordinator_stats": [
{
"node_id": "1sFM8cmSROZYhPxVsiWew",
@@ -31,22 +128,8 @@ The API returns the following response:
}
]
}
---------------------------------------------------
+----
+// TESTRESPONSE[s/"executing_policies": \[[^\]]*\]/"executing_policies": $body.$_path/]
// TESTRESPONSE[s/"node_id": "1sFM8cmSROZYhPxVsiWew"/"node_id" : $body.coordinator_stats.0.node_id/]
// TESTRESPONSE[s/"remote_requests_total": 0/"remote_requests_total" : $body.coordinator_stats.0.remote_requests_total/]
// TESTRESPONSE[s/"executed_searches_total": 0/"executed_searches_total" : $body.coordinator_stats.0.executed_searches_total/]
-
-The top level `executing_policies` field includes an object for each policy that is currently executing.
-Each object contains the following fields:
-* `name` - The name of policy that is executing
-* `task` - A full blow task info object that is executing the policy.
-
-The top level `coordinator_stats` field includes an object for each ingest node with information about the coordinator.
-Each object contains the following fields:
-* `node_id` - The id of the ingest node that is coordinating search requests for configured `enrich` processors.
-* `queue_size` - The current number of search requests in the queue.
-* `remote_requests_current` - The number of current outstanding remote requests.
-* `remote_requests_total` - The total number of outstanding remote requests that have been executed since node startup.
- Each remote request is likely to include multiple search requests. This depends on how much
- search requests are in the queue at the time when the remote request is performed.
-* `executed_searches_total` - The total number of search requests that `enrich` processors have executed since node startup.
\ No newline at end of file
diff --git a/docs/reference/ingest/apis/enrich/index.asciidoc b/docs/reference/ingest/apis/enrich/index.asciidoc
index a11a61934f8..bd24e73c059 100644
--- a/docs/reference/ingest/apis/enrich/index.asciidoc
+++ b/docs/reference/ingest/apis/enrich/index.asciidoc
@@ -7,7 +7,7 @@ The following enrich APIs are available for managing enrich policies:
* <> to delete an enrich policy
* <> to return information about an enrich policy
* <> to execute an enrich policy
-* <> to get enrich related stats
+* <> to get enrich-related stats
include::put-enrich-policy.asciidoc[]