Skip to content

Commit 8ce106a

Browse files
authored
Merge pull request #102 from kenhys/fix-format
Use markdown table for parameters
2 parents 46fe325 + 00f5455 commit 8ce106a

File tree

1 file changed

+42
-78
lines changed

1 file changed

+42
-78
lines changed

README.md

Lines changed: 42 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -29,86 +29,50 @@ Or install it yourself as:
2929

3030
## Configuration
3131

32-
**key** (string) (required)
32+
### Example
3333

34-
The key for part of multiline log.
35-
36-
**separator** (string) (optional)
37-
38-
The separator of lines.
39-
Default value is `"\n"`.
40-
41-
**n\_lines** (integer) (optional)
42-
43-
The number of lines.
44-
This is exclusive with `multiline_start_regex`.
45-
46-
**multiline\_start\_regexp** (string) (optional)
47-
48-
The regexp to match beginning of multiline.
49-
This is exclusive with `n_lines.`
50-
51-
**multiline\_end\_regexp** (string) (optional)
52-
53-
The regexp to match ending of multiline.
54-
This is exclusive with `n_lines.`
55-
56-
**continuous\_line\_regexp** (string) (optional)
57-
58-
The regexp to match continuous lines.
59-
This is exclusive with `n_lines.`
60-
61-
**stream\_identity\_key** (string) (optional)
62-
63-
The key to determine which stream an event belongs to.
64-
65-
**flush\_interval** (integer) (optional)
66-
67-
The number of seconds after which the last received event log will be flushed.
68-
If specified 0, wait for next line forever.
69-
70-
**timeout\_label** (string) (optional)
71-
72-
The label name to handle events caused by timeout.
73-
74-
**use\_first\_timestamp** (bool) (optional)
75-
76-
Use timestamp of first record when buffer is flushed.
77-
Default value is `false`.
78-
79-
**partial\_key** (string) (optional)
80-
81-
The field name that is the reference to concatenate records
82-
83-
**partial\_value** (string) (optional)
84-
85-
The value stored in the field specified by partial_key that represent partial log
86-
87-
**keep\_partial\_key** (bool) (optional)
88-
89-
If true, keep partial_key in concatenated records
90-
Default value is `false`.
91-
92-
**use\_partial\_metadata** (bool) (optional)
93-
94-
Use partial metadata to concatenate multiple records
95-
96-
**keep\_partial\_metadata** (bool) (optional)
97-
98-
If true, keep partial metadata
99-
100-
**partial\_metadata\_format** (enum) (optional)
101-
102-
Input format of the partial metadata (fluentd or journald docker log driver)
103-
104-
Configure based on the input plugin, that is used.
105-
The docker fluentd and journald log drivers are behaving differently, so the plugin needs to know, what to look for.
106-
Use `docker-journald-lowercase`, if you have `fields_lowercase true` in the `journald` source config
107-
108-
Available values: `docker-fluentd`, `docker-journald`, `docker-journald-lowercase`
109-
110-
Default value is `docker-fluentd`
34+
```
35+
<filter docker.log>
36+
@type concat
37+
key loga
38+
#separator "\n"
39+
n_lines 10
40+
#multiline_start_regexp /^Start/
41+
#multiline_end_regexp /^End/
42+
#continuous_line_regexp nil
43+
#stream_identity_key nil
44+
#flush_interval 60
45+
#timeout_label nil
46+
#use_first_timestamp false
47+
#partial_key nil
48+
#partial_value nil
49+
#keep_partial_key false
50+
#use_partial_metadata false
51+
#keep_partial_metadata false
52+
#partial\_metadata\_format docker-fluentd
53+
</filter>
54+
```
11155

56+
### Parameter
57+
58+
|parameter|description|default|
59+
|---|---|---|
60+
|key|The key for part of multiline log||
61+
|separator|The separator of lines|`"\n"`|
62+
|n\_lines|The number of lines. This is exclusive with `multiline_start_regex`|nil|
63+
|multiline\_start\_regexp|The regexp to match beginning of multiline. This is exclusive with `n_lines`|nil|
64+
|multiline\_end\_regexp|The regexp to match ending of multiline.This is exclusive with `n_lines`|nil|
65+
|continuous\_line\_regexp|The regexp to match continuous lines.This is exclusive with `n_lines`|nil|
66+
|stream\_identity\_key|The key to determine which stream an event belongs to|nil|
67+
|flush\_interval|The number of seconds after which the last received event log will be flushed.If specified 0, wait for next line foreverr|60|
68+
|timeout\_label|The label name to handle events caused by timeout|nil|
69+
|use\_first\_timestamp|Use timestamp of first record when buffer is flushed|`false`|
70+
|partial\_key|The field name that is the reference to concatenate records|nil|
71+
|partial\_value|The value stored in the field specified by partial_key that represent partial log|nil|
72+
|keep\_partial\_key|If true, keep partial_key in concatenated records|`false`|
73+
|use\_partial\_metadata|Use partial metadata to concatenate multiple records|`false`|
74+
|keep\_partial\_metadata|If true, keep partial metadata|`false`|
75+
|partial\_metadata\_format|Input format of the partial metadata (fluentd or journald docker log driver) ( `docker-fluentd`, `docker-journald`, `docker-journald-lowercase`)<br>Configure based on the input plugin, that is used. <br>The docker fluentd and journald log drivers are behaving differently, so the plugin needs to know, what to look for.<br>Use `docker-journald-lowercase`, if you have `fields_lowercase true` in the `journald` source config |`docker-fluentd`|
11276

11377
## Usage
11478

0 commit comments

Comments
 (0)