New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Execute enrich policy API Explore API »
Elastic Docs ›Elasticsearch Guide [7.5] ›REST APIs ›Enrich APIs

Enrich stats API

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Enrich stats API

edit

Returns enrich coordinator statistics and information about enrich policies that are currently executing.

GET /_enrich/_stats
Copy as curlTry in Elastic 

Request

edit

GET /_enrich/_stats

Response body

edit
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
(Task object) Object containing detailed information about the policy execution task.
coordinator_stats

(Array of objects) Objects containing information about each coordinating ingest node 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.

Examples

edit
GET /_enrich/_stats
Copy as curlTry in Elastic 

The API returns the following response:

{
    "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",
            "queue_size": 0,
            "remote_requests_current": 0,
            "remote_requests_total": 0,
            "executed_searches_total": 0
        }
    ]
}
« Execute enrich policy API Explore API »
Was this helpful?
Feedback