Skip to content

Add parameters which were missing from the docs - #665

Merged
kenhys merged 3 commits into
fluent:1.0from
Watson1978:docs-undocumented-params
Aug 5, 2026
Merged

Add parameters which were missing from the docs#665
kenhys merged 3 commits into
fluent:1.0from
Watson1978:docs-undocumented-params

Conversation

@Watson1978

Copy link
Copy Markdown
Contributor

Six parameters are accepted by the plugins but were not described anywhere in the documentation. Users could only find them by reading the plugin source.

  • formatter/json.md json_parser (0.14.0)
  • input/exec.md encoding (1.17.1)
  • input/forward.md backlog (0.10.36)
  • input/syslog.md source_host_key (0.10.53)
  • input/tail.md path_delimiter (1.9.1)
  • parser/multiline.md unmatched_lines (1.9.3)

The version column is taken from the commit which introduced each config_param and the first release tag containing it, not guessed.

Two related fixes on pages touched here:

  • input/forward.md: resolve_hostname cannot be false when source_hostname_key is set. The wording matches the note which input/syslog.md already has for the same constraint.
  • input/syslog.md: include_source_host assigns @source_address_key, so it adds the source address under the field name given by source_host_key, not the hostname.

Six parameters are accepted by the plugins but were not described
anywhere in the documentation. Users could only find them by reading the
plugin source.

* formatter/json.md   json_parser      (0.14.0)
* input/exec.md       encoding         (1.17.1)
* input/forward.md    backlog          (0.10.36)
* input/syslog.md     source_host_key  (0.10.53)
* input/tail.md       path_delimiter   (1.9.1)
* parser/multiline.md unmatched_lines  (1.9.3)

The version column is taken from the commit which introduced each
`config_param` and the first release tag containing it, not guessed.

Two related fixes on pages touched here:

* input/forward.md: `resolve_hostname` cannot be `false` when
  `source_hostname_key` is set. The wording matches the note which
  input/syslog.md already has for the same constraint.
* input/syslog.md: `include_source_host` assigns `@source_address_key`,
  so it adds the source *address* under the field name given by
  `source_host_key`, not the hostname.

Signed-off-by: Shizuo Fujita <fujita@clear-code.com>
@Watson1978
Watson1978 requested a review from kenhys August 5, 2026 01:16
Comment thread formatter/json.md Outdated
Comment thread input/syslog.md Outdated
Watson1978 and others added 2 commits August 5, 2026 14:42
Co-authored-by: Kentaro Hayashi <kenhys@gmail.com>
Signed-off-by: Shizuo Fujita <fujita@clear-code.com>
Co-authored-by: Kentaro Hayashi <kenhys@gmail.com>
Signed-off-by: Shizuo Fujita <fujita@clear-code.com>
@Watson1978
Watson1978 force-pushed the docs-undocumented-params branch from c5b8213 to 229dec8 Compare August 5, 2026 05:42
@Watson1978
Watson1978 requested a review from kenhys August 5, 2026 05:42
@kenhys
kenhys merged commit 53ad22e into fluent:1.0 Aug 5, 2026
2 checks passed
@Watson1978
Watson1978 deleted the docs-undocumented-params branch August 5, 2026 08:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants