Skip to content

Commit 2eed490

Browse files
committed
parser/filter: refer to <parse> under <filter> accurately
The argument of `<filter>` is a tag pattern, so `<filter parser>` reads as a filter for the tag "parser". Describe it as the `<parse>` section under `<filter>` instead. Also add a note to filter/parser.md. The existing wording says that you can reuse the predefined formats there, which does not hold for `multiline`. Signed-off-by: Shizuo Fujita <fujita@clear-code.com>
1 parent 8019974 commit 2eed490

2 files changed

Lines changed: 5 additions & 1 deletion

File tree

filter/parser.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,10 @@ It is included in the Fluentd's core.
2020

2121
`filter_parser` uses built-in parser plugins and your own customized parser plugin, so you can reuse the predefined formats like `apache2`, `json`, etc. See [Parser Plugin Overview](../parser/) for more details
2222

23+
{% hint style='warning' %}
24+
`filter_parser` receives events which are already split, so `multiline` cannot join them into one record. See [`multiline`](../parser/multiline.md) for the details.
25+
{% endhint %}
26+
2327
With this example, if you receive this event:
2428

2529
```text

parser/multiline.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The `multiline` parser parses log with `formatN` and `format_firstline` paramete
88
This parser plugin itself does not join multiple lines. The logic to buffer lines and detect the start of each record is implemented in `in_tail`.
99

1010
* `<parse>` in `in_tail`: works as described in this article.
11-
* `<filter parser>` and other plugins which receive already-split events: cannot join separate events into one record. It can only parse a value which already contains newline characters.
11+
* `<parse>` section under `<filter>` \([`filter_parser`](../filter/parser.md)\) and other plugins which receive already-split events: cannot join separate events into one record. It can only parse a value which already contains newline characters.
1212

1313
To concatenate multiple events into one record after the input stage, use [`fluent-plugin-concat`](https://github.com/fluent-plugins-nursery/fluent-plugin-concat).
1414
{% endhint %}

0 commit comments

Comments
 (0)