Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update replace.asciidoc #25055

Merged
merged 6 commits into from
Apr 20, 2021
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions libbeat/processors/actions/docs/replace.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,15 @@ contains a `field: field-name`, `pattern: regex-pattern` and
`replacement: replacement-string`, where:

* `field` is the original field name
* `pattern` is regex pattern to match field's value
* `replacement` is the replacement string to use for updating the field's value
* `pattern` is the regex pattern to match the field's value
* `replacement` is the replacement string to use to update the field's value

The `replace` processor cannot be used to replace value with a completely new value.

TIP: You can replace field value to truncate part of field value or replace
TIP: Replace the field value to truncate part of the field value or replace
it with a new string. It can also be used for masking PII information.
leahleahy marked this conversation as resolved.
Show resolved Hide resolved

Following example will change path from /usr/bin to /usr/local/bin
The following example will change path from /usr/bin to /usr/local/bin:

[source,yaml]
-------
Expand All @@ -35,11 +35,11 @@ processors:

The `replace` processor has following configuration settings:

`ignore_missing`:: (Optional) If set to true, no error is logged in case a specifiedfield
`ignore_missing`:: (Optional) If set to `true`, no error is logged in case a specified field
is missing. Default is `false`.
leahleahy marked this conversation as resolved.
Show resolved Hide resolved

`fail_on_error`:: (Optional) If set to true, in case of an error the replacement of
field values is stopped and the original event is returned. If set to false, replacement
`fail_on_error`:: (Optional) If set to `true`, in case of an error the replacement of
field values is stopped and the original event is returned. If set to `false`, replacement
continues even if an error occurs during replacement. Default is `true`.
leahleahy marked this conversation as resolved.
Show resolved Hide resolved

See <<conditions>> for a list of supported conditions.
Expand Down