Header Field Reference and Example Needed

[eternalyperplxed]

Tell us about the issue

Description:
Kafka headers can be added to the event by using the decorate_events field, however the field name is not included in the documentation URL's listed below. The only reference to headers is in the line "Option to add Kafka metadata like topic, message size and header key values to the event."

Additional information needs to be added that says when using the extended option for decorate_events, the field [@metadata][kafka][headers] will also be included in the available attributes. The header keys and values will be arbitrary based on the Kafka implementation, however giving an example in the list of attributes would be helpful.

URL:

https://www.elastic.co/guide/en/logstash/8.0/plugins-inputs-kafka.html#_metadata_fields
https://www.elastic.co/guide/en/logstash/8.0/plugins-inputs-kafka.html#plugins-inputs-kafka-decorate_events

[limdoglim]

"Option to add Kafka metadata like topic, message size and header key values to the event."

not included meesage size