Skip to content

Commit

Permalink
[DOCS] Fix case of ingest processor titles (#61024)
Browse files Browse the repository at this point in the history
Converts page headings to sentence case.
Adds a title abbreviation.
  • Loading branch information
jrodewig committed Aug 12, 2020
1 parent 6d01480 commit 4eb09cb
Show file tree
Hide file tree
Showing 34 changed files with 161 additions and 34 deletions.
7 changes: 6 additions & 1 deletion docs/reference/ingest/processors/append.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
[[append-processor]]
=== Append Processor
=== Append processor
++++
<titleabbrev>Append</titleabbrev>
++++


Appends one or more values to an existing array if the field already exists and it is an array.
Converts a scalar to an array and appends one or more values to it if the field exists and it is a scalar.
Creates an array containing the provided values if the field doesn't exist.
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/bytes.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[bytes-processor]]
=== Bytes Processor
=== Bytes processor
++++
<titleabbrev>Bytes</titleabbrev>
++++

Converts a human readable byte value (e.g. 1kb) to its value in bytes (e.g. 1024). If the field is an array of strings, all members of the array will be converted.

Supported human readable units are "b", "kb", "mb", "gb", "tb", "pb" case insensitive. An error will occur if
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/circle.asciidoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,11 @@
[role="xpack"]
[testenv="basic"]
[[ingest-circle-processor]]
=== Circle Processor
=== Circle processor
++++
<titleabbrev>Circle</titleabbrev>
++++

Converts circle definitions of shapes to regular polygons which approximate them.

[[circle-processor-options]]
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/convert.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[convert-processor]]
=== Convert Processor
=== Convert processor
++++
<titleabbrev>Convert</titleabbrev>
++++

Converts a field in the currently ingested document to a different type, such as converting a string to an integer.
If the field value is an array, all members will be converted.

Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/csv.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[csv-processor]]
=== CSV Processor
=== CSV processor
++++
<titleabbrev>CSV</titleabbrev>
++++

Extracts fields from CSV line out of a single text field within a document. Any empty field in CSV will be skipped.

[[csv-options]]
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/date-index-name.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[date-index-name-processor]]
=== Date Index Name Processor
=== Date index name processor
++++
<titleabbrev>Date index name</titleabbrev>
++++

The purpose of this processor is to point documents to the right time based index based
on a date or timestamp field in a document by using the <<date-math-index-names, date math index name support>>.
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/date.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[date-processor]]
=== Date Processor
=== Date processor
++++
<titleabbrev>Date</titleabbrev>
++++

Parses dates from fields, and then uses the date or timestamp as the timestamp for the document.
By default, the date processor adds the parsed date as a new field called `@timestamp`. You can specify a
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/dissect.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[dissect-processor]]
=== Dissect Processor
=== Dissect processor
++++
<titleabbrev>Dissect</titleabbrev>
++++


Similar to the <<grok-processor,Grok Processor>>, dissect also extracts structured fields out of a single text field
within a document. However unlike the <<grok-processor,Grok Processor>>, dissect does not use
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/dot-expand.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[dot-expand-processor]]
=== Dot Expander Processor
=== Dot expander processor
++++
<titleabbrev>Dot expander</titleabbrev>
++++

Expands a field with dots into an object field. This processor allows fields
with dots in the name to be accessible by other processors in the pipeline.
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/drop.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[drop-processor]]
=== Drop Processor
=== Drop processor
++++
<titleabbrev>Drop</titleabbrev>
++++

Drops the document without raising any errors. This is useful to prevent the document from
getting indexed based on some condition.

Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/enrich.asciidoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
[role="xpack"]
[testenv="basic"]
[[enrich-processor]]
=== Enrich Processor
=== Enrich processor
++++
<titleabbrev>Enrich</titleabbrev>
++++

The `enrich` processor can enrich documents with data from another index.
See <<ingest-enriching-data,enrich data>> section for more information about how to set this up.
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/fail.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[fail-processor]]
=== Fail Processor
=== Fail processor
++++
<titleabbrev>Fail</titleabbrev>
++++

Raises an exception. This is useful for when
you expect a pipeline to fail and want to relay a specific message
to the requester.
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/foreach.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[foreach-processor]]
=== Foreach Processor
=== Foreach processor
++++
<titleabbrev>Foreach</titleabbrev>
++++

Processes elements in an array of unknown length.

Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/geoip.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[geoip-processor]]
=== GeoIP Processor
=== GeoIP processor
++++
<titleabbrev>GeoIP</titleabbrev>
++++

The `geoip` processor adds information about the geographical location of IP addresses, based on data from the Maxmind databases.
This processor adds this information by default under the `geoip` field. The `geoip` processor can resolve both IPv4 and
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/grok.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[grok-processor]]
=== Grok Processor
=== Grok processor
++++
<titleabbrev>Grok</titleabbrev>
++++

Extracts structured fields out of a single text field within a document. You choose which field to
extract matched fields from, as well as the grok pattern you expect will match. A grok pattern is like a regular
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/gsub.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[gsub-processor]]
=== Gsub Processor
=== Gsub processor
++++
<titleabbrev>Gsub</titleabbrev>
++++

Converts a string field by applying a regular expression and a replacement.
If the field is an array of string, all members of the array will be converted. If any non-string values are encountered, the processor will throw an exception.

Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/html_strip.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[htmlstrip-processor]]
=== HTML Strip Processor
=== HTML strip processor
++++
<titleabbrev>HTML strip</titleabbrev>
++++

Removes HTML tags from the field. If the field is an array of strings, HTML tags will be removed from all members of the array.

NOTE: Each HTML tag is replaced with a `\n` character.
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/inference.asciidoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
[role="xpack"]
[testenv="basic"]
[[inference-processor]]
=== {infer-cap} Processor
=== {infer-cap} processor
++++
<titleabbrev>{infer-cap}</titleabbrev>
++++

Uses a pre-trained {dfanalytics} model to infer against the data that is being
ingested in the pipeline.
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/join.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[join-processor]]
=== Join Processor
=== Join processor
++++
<titleabbrev>Join</titleabbrev>
++++

Joins each element of an array into a single string using a separator character between each element.
Throws an error when the field is not an array.

Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/json.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[json-processor]]
=== JSON Processor
=== JSON processor
++++
<titleabbrev>JSON</titleabbrev>
++++

Converts a JSON string into a structured JSON object.

[[json-options]]
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/kv.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[kv-processor]]
=== KV Processor
=== KV processor
++++
<titleabbrev>KV</titleabbrev>
++++

This processor helps automatically parse messages (or specific event fields) which are of the `foo=bar` variety.

For example, if you have a log message which contains `ip=1.2.3.4 error=REFUSED`, you can parse those fields automatically by configuring:
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/lowercase.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[lowercase-processor]]
=== Lowercase Processor
=== Lowercase processor
++++
<titleabbrev>Lowercase</titleabbrev>
++++

Converts a string to its lowercase equivalent. If the field is an array of strings, all members of the array will be converted.

[[lowercase-options]]
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/pipeline.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[pipeline-processor]]
=== Pipeline Processor
=== Pipeline processor
++++
<titleabbrev>Pipeline</titleabbrev>
++++

Executes another pipeline.

[[pipeline-options]]
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/remove.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[remove-processor]]
=== Remove Processor
=== Remove processor
++++
<titleabbrev>Remove</titleabbrev>
++++

Removes existing fields. If one field doesn't exist, an exception will be thrown.

[[remove-options]]
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/rename.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[rename-processor]]
=== Rename Processor
=== Rename processor
++++
<titleabbrev>Rename</titleabbrev>
++++

Renames an existing field. If the field doesn't exist or the new name is already used, an exception will be thrown.

[[rename-options]]
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/script.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[script-processor]]
=== Script Processor
=== Script processor
++++
<titleabbrev>Script</titleabbrev>
++++

Allows inline and stored scripts to be executed within ingest pipelines.

Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/set-security-user.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[ingest-node-set-security-user-processor]]
=== Set Security User Processor
=== Set security user processor
++++
<titleabbrev>Set security user</titleabbrev>
++++

Sets user-related details (such as `username`, `roles`, `email`, `full_name`,
`metadata`, `api_key`, `realm` and `authentication_type`) from the current
authenticated user to the current document by pre-processing the ingest.
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/set.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[set-processor]]
=== Set Processor
=== Set processor
++++
<titleabbrev>Set</titleabbrev>
++++

Sets one field and associates it with the specified value. If the field already exists,
its value will be replaced with the provided one.

Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/sort.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[sort-processor]]
=== Sort Processor
=== Sort processor
++++
<titleabbrev>Sort</titleabbrev>
++++

Sorts the elements of an array ascending or descending. Homogeneous arrays of numbers will be sorted
numerically, while arrays of strings or heterogeneous arrays of strings + numbers will be sorted lexicographically.
Throws an error when the field is not an array.
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/split.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[split-processor]]
=== Split Processor
=== Split processor
++++
<titleabbrev>Split</titleabbrev>
++++

Splits a field into an array using a separator character. Only works on string fields.

[[split-options]]
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/trim.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[trim-processor]]
=== Trim Processor
=== Trim processor
++++
<titleabbrev>Trim</titleabbrev>
++++

Trims whitespace from field. If the field is an array of strings, all members of the array will be trimmed.

NOTE: This only works on leading and trailing whitespace.
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/uppercase.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[uppercase-processor]]
=== Uppercase Processor
=== Uppercase processor
++++
<titleabbrev>Uppercase</titleabbrev>
++++

Converts a string to its uppercase equivalent. If the field is an array of strings, all members of the array will be converted.

[[uppercase-options]]
Expand Down
6 changes: 5 additions & 1 deletion docs/reference/ingest/processors/url-decode.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
[[urldecode-processor]]
=== URL Decode Processor
=== URL decode processor
++++
<titleabbrev>URL decode</titleabbrev>
++++

URL-decodes a string. If the field is an array of strings, all members of the array will be decoded.

[[urldecode-options]]
Expand Down
5 changes: 4 additions & 1 deletion docs/reference/ingest/processors/user-agent.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[[user-agent-processor]]
=== User Agent processor
=== User agent processor
++++
<titleabbrev>User agent</titleabbrev>
++++

The `user_agent` processor extracts details from the user agent string a browser sends with its web requests.
This processor adds this information by default under the `user_agent` field.
Expand Down

0 comments on commit 4eb09cb

Please sign in to comment.