Skip to content

Commit 55630a7

Browse files
authored
sample: add explanation about reuse_record (#515)
Signed-off-by: Kentaro Hayashi <hayashi@clear-code.com>
1 parent f9a77a0 commit 55630a7

File tree

1 file changed

+18
-1
lines changed

1 file changed

+18
-1
lines changed

input/sample.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,5 +105,22 @@ The sample data to be generated. It should be either an array of JSON hashes or
105105

106106
If you use fluentd v1.11.1 or earlier, use `dummy`.
107107

108-
If this article is incorrect or outdated, or omits critical information, please [let us know](https://github.com/fluent/fluentd-docs-gitbook/issues?state=open). [Fluentd](http://www.fluentd.org/) is an open-source project under [Cloud Native Computing Foundation \(CNCF\)](https://cncf.io/). All components are available under the Apache 2 License.
108+
### `reuse_record`
109+
110+
| type | default | version |
111+
| :--- | :--- | :--- |
112+
| bool | false | 1.17.1 |
113+
114+
If specified, it reuses the previously generated sample data.
115+
This is the default behavior in v1.17.0 or older version of Fluentd.
109116

117+
Since v1.17.1, the default behavior was changed to copy sample data
118+
by default to avoid the impact of destructive changes by subsequent plugins.
119+
120+
The new default behavior (`reuse_record false`) increases the load when generating large amounts of sample data.
121+
You can use this new parameter to have the same performance as before with `reuse_record`.
122+
123+
Note that there is one exception not to reuse the sample data even though `reuse_record` is specified.
124+
If `auto_increment_key` was specified, `reuse_record` will be ignored.
125+
126+
If this article is incorrect or outdated, or omits critical information, please [let us know](https://github.com/fluent/fluentd-docs-gitbook/issues?state=open). [Fluentd](http://www.fluentd.org/) is an open-source project under [Cloud Native Computing Foundation \(CNCF\)](https://cncf.io/). All components are available under the Apache 2 License.

0 commit comments

Comments
 (0)