Target required xml-filter option

Elastic Stack Logstash
1

I'm using a quite simple xml-filter

filter {
xml {
source => "recordedmessage"
}
}

But when I run logstash I get "ConfigurationError: translation missing" and logstash stops.

So I changed the filter to

filter {
xml {
source => "recordedmessage"
target => "parsed"
}
}

And now it works fine.

Therefore I ask if anyone have had any similar experiences.
As the documentation for 5.0.0-alpha4 xml-filter says:

Required configuration options:

xml {
source => ...
}

It might be a typo in the documentation?

2

Quoting the documentation of the target option:

Required if store_xml is true (which is the default).

In other words, target can't be listed as required since it's only required if store_xml is enabled.

3

Ops, my bad.

But then I suggest that this is included somewhere around the "Required configuration options:" area also.
When I am looking at the documentation for å filter/input/something that I want to try out I dont want to have to read every configuration option.

4

Yeah. Getting that to work with autogenerated documentation might take some work. One would probably have to update the documentation generator to support additional meta markup of configuration options. Feel free to file a GitHub issue.

5

Issue created: https://github.com/elastic/logstash/issues/5586