diff --git a/docs/reference/ingest.asciidoc b/docs/reference/ingest.asciidoc index da1164930bc1e..18349beab6ab1 100644 --- a/docs/reference/ingest.asciidoc +++ b/docs/reference/ingest.asciidoc @@ -3,26 +3,27 @@ [partintro] -- -You can use ingest node to pre-process documents before the actual indexing takes place. -This pre-processing happens by an ingest node that intercepts bulk and index requests, applies the -transformations, and then passes the documents back to the index or bulk APIs. +Use an ingest node to pre-process documents before the actual document indexing happens. +The ingest node intercepts bulk and index requests, it applies transformations, and it then +passes the documents back to the index or bulk APIs. -You can enable ingest on any node or even have dedicated ingest nodes. Ingest is enabled by default -on all nodes. To disable ingest on a node, configure the following setting in the `elasticsearch.yml` file: +All nodes enable ingest by default, so any node can handle ingest tasks. You can also create +dedicated ingest nodes. To disable ingest for a node, configure the following setting in the +elasticsearch.yml file: [source,yaml] -------------------------------------------------- node.ingest: false -------------------------------------------------- -To pre-process documents before indexing, you <> that specifies -a series of <>. Each processor transforms the document in some way. -For example, you may have a pipeline that consists of one processor that removes a field from -the document followed by another processor that renames a field. Configured pipelines are then stored -in the <>. +To pre-process documents before indexing, <> that specifies a series of +<>. Each processor transforms the document in some specific way. For example, a +pipeline might have one processor that removes a field from the document, followed by +another processor that renames a field. The <> then stores +the configured pipelines. -To use a pipeline, you simply specify the `pipeline` parameter on an index or bulk request to -tell the ingest node which pipeline to use. For example: +To use a pipeline, simply specify the `pipeline` parameter on an index or bulk request. This +way, the ingest node knows which pipeline to use. For example: [source,js] --------------------------------------------------