KAFKA-19011: Improve EndToEndLatency Tool with argument parser and message key/header support

[Rancho-7]

jira: https://issues.apache.org/jira/browse/KAFKA-19011 kip:
https://cwiki.apache.org/confluence/display/KAFKA/KIP-1172%3A+Improve+EndToEndLatency+tool

This PR improves the usability and maintainability of the
kafka-e2e-latency.sh tool:

• Replaces fixed-index argument parsing with a proper argument parser
  (joptsimple)
• Adds support for configuring:
  • -record-key-size: size of the message key
  • -num-headers: number of headers per message
  • -record-header-key-size: size of each header key
  • -record-header-size: size of each header value
• Renames existing arguments to align with Kafka CLI conventions:
  • broker_list → bootstrap-server
  • num_messages → num-records
  • message_size_bytes → record-size
  • properties_file → command-config

[Rancho-7]

The updated usage of the tool with argument parser:

(base) lansg:bin/ (KAFKA-19011✗) $ ./kafka-e2e-latency.sh  --bootstrap-server localhost:9092 --topic test-topic --num-records 1000 --producer-acks 1 --record-size 512 --record-key-size 64 --num-headers 5 --record-header-key-size 64 --record-header-size 128
0       26.187541
Avg latency: 1.2853 ms
Percentiles: 50th = 1, 99th = 3, 99.9th = 26

It's compatible with the legacy version:

(base) lansg:bin/ (KAFKA-19011✗) $ ./kafka-e2e-latency.sh localhost:9092 test-topic 1000 1 512                                                       [21:21:28]
WARNING: Positional argument usage is deprecated and will be removed in Apache Kafka 5.0. Please use named arguments instead: --bootstrap-server, --topic, --num-records, --producer-acks, --record-size, --command-config
0       45.907666
Avg latency: 1.5202 ms
Percentiles: 50th = 1, 99th = 6, 99.9th = 88

[Yunyung]

Thanks for the PR. Partial review, some comments left. Also, could you add the KIP to the title or description?

[Yunyung]

What if -1?

[Rancho-7]

The legacy version only had these two options, so I keep it the same. Since -1 has the same effect as all, I think one is enough?

[Yunyung]

Should we add Deprecated tag?

[Rancho-7]

Thanks for pointing that out! Added it.

[chia7712]

@Rancho-7 could you please run e2e on you local?