vamossagar12 commented on code in PR #13095: URL: https://github.com/apache/kafka/pull/13095#discussion_r1088161412
########## tools/src/main/java/org/apache/kafka/tools/EndToEndLatency.java: ########## @@ -0,0 +1,225 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to You under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.kafka.tools; + +import org.apache.kafka.clients.CommonClientConfigs; +import org.apache.kafka.clients.admin.Admin; +import org.apache.kafka.clients.admin.NewTopic; +import org.apache.kafka.clients.consumer.ConsumerConfig; +import org.apache.kafka.clients.consumer.ConsumerRecords; +import org.apache.kafka.clients.consumer.KafkaConsumer; +import org.apache.kafka.clients.producer.KafkaProducer; +import org.apache.kafka.clients.producer.ProducerConfig; +import org.apache.kafka.clients.producer.ProducerRecord; +import org.apache.kafka.common.TopicPartition; +import org.apache.kafka.common.utils.Exit; +import org.apache.kafka.common.utils.Utils; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.time.Duration; +import java.util.Arrays; +import java.util.Collections; +import java.util.Properties; +import java.util.List; +import java.util.Random; +import java.util.Optional; +import java.util.concurrent.ExecutionException; +import java.util.stream.Collectors; + +/** + * This class records the average end to end latency for a single message to travel through Kafka + * + * broker_list = location of the bootstrap broker for both the producer and the consumer + * num_messages = # messages to send + * producer_acks = See ProducerConfig.ACKS_DOC + * message_size_bytes = size of each message in bytes + * + * e.g. [localhost:9092 test 10000 1 20] + */ +public class EndToEndLatency { + + private final static long POLL_TIMEOUT_MS = 60000; + + public static void main(String... args) { + Exit.exit(mainNoExit(args)); + } + + static int mainNoExit(String... args) { + try { + execute(args); + return 0; + } catch (TerseException e) { + System.err.println(e.getMessage()); + return 1; + } catch (Throwable e) { + System.err.println(e.getMessage()); + System.err.println(Utils.stackTrace(e)); + return 1; + } + } + + // Visible for testing + static void execute(String... args) throws Exception { + if (args.length != 5 && args.length != 6) { + throw new TerseException("USAGE: java " + EndToEndLatency.class.getName() + + " broker_list topic num_messages producer_acks message_size_bytes [optional] properties_file"); + } + + String brokers = args[0]; + String topic = args[1]; + int numMessages = Integer.parseInt(args[2]); + String acks = args[3]; + int messageSizeBytes = Integer.parseInt(args[4]); + Optional<String> propertiesFile = args.length > 5 ? (Utils.isBlank(args[5]) ? Optional.empty() : Optional.of(args[5])) : Optional.empty(); + + if (!Arrays.asList("1", "all").contains(acks)) { + throw new IllegalArgumentException("Latency testing requires synchronous acknowledgement. Please use 1 or all"); + } + + try (KafkaConsumer<byte[], byte[]> consumer = createKafkaConsumer(propertiesFile, brokers); + KafkaProducer<byte[], byte[]> producer = createKafkaProducer(propertiesFile, brokers, acks)) { + + if (!consumer.listTopics().containsKey(topic)) { + createTopic(propertiesFile, brokers, topic); + } + setupConsumer(topic, consumer); + double totalTime = 0.0; + long[] latencies = new long[numMessages]; + Random random = new Random(0); + + for (int i = 0; i < numMessages; i++) { + byte[] message = randomBytesOfLen(random, messageSizeBytes); + long begin = System.nanoTime(); + //Send message (of random bytes) synchronously then immediately poll for it + producer.send(new ProducerRecord<>(topic, message)).get(); + ConsumerRecords<byte[], byte[]> records = consumer.poll(Duration.ofMillis(POLL_TIMEOUT_MS)); + long elapsed = System.nanoTime() - begin; + + validate(consumer, message, records); + + //Report progress + if (i % 1000 == 0) + System.out.println(i + "\t" + elapsed / 1000.0 / 1000.0); + totalTime += elapsed; + latencies[i] = elapsed / 1000 / 1000; + } + + printResults(numMessages, totalTime, latencies); + consumer.commitSync(); + } + } + + // Visible for testing + static void validate(KafkaConsumer<byte[], byte[]> consumer, byte[] message, ConsumerRecords<byte[], byte[]> records) { + if (records.isEmpty()) { + consumer.commitSync(); + throw new RuntimeException("poll() timed out before finding a result (timeout:[" + POLL_TIMEOUT_MS + "])"); + } + + //Check result matches the original record + String sent = new String(message, StandardCharsets.UTF_8); + String read = new String(records.iterator().next().value(), StandardCharsets.UTF_8); + + if (!read.equals(sent)) { + consumer.commitSync(); + throw new RuntimeException("The message read [" + read + "] did not match the message sent [" + sent + "]"); + } + + //Check we only got the one message + if (records.count() != 1) { + int count = records.count(); + consumer.commitSync(); + throw new RuntimeException("Only one result was expected during this test. We found [" + count + "]"); + } + } + + private static void setupConsumer(String topic, KafkaConsumer<byte[], byte[]> consumer) { + List<TopicPartition> topicPartitions = consumer. + partitionsFor(topic). + stream().map(p -> new TopicPartition(p.topic(), p.partition())) + .collect(Collectors.toList()); + consumer.assign(topicPartitions); + consumer.seekToEnd(topicPartitions); + consumer.assignment().forEach(consumer::position); + } + + private static void printResults(int numMessages, double totalTime, long[] latencies) { + System.out.printf("Avg latency: %.4f ms%n", totalTime / numMessages / 1000.0 / 1000.0); + Arrays.sort(latencies); + int p50 = (int) latencies[(int) (latencies.length * 0.5)]; + int p99 = (int) latencies[(int) (latencies.length * 0.99)]; + int p999 = (int) latencies[(int) (latencies.length * 0.999)]; + System.out.printf("Percentiles: 50th = %d, 99th = %d, 99.9th = %d%n", p50, p99, p999); + } + + private static byte[] randomBytesOfLen(Random random, int length) { + byte[] randomBytes = new byte[length]; + Arrays.fill(randomBytes, Integer.valueOf(random.nextInt(26) + 65).byteValue()); + return randomBytes; + } + + private static void createTopic(Optional<String> propertiesFile, String brokers, String topic) throws IOException { + short defaultReplicationFactor = 1; + int defaultNumPartitions = 1; Review Comment: done -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org