This is a Kafka Connector to send random generated values.
Kafka Random Connector is source connector of Kafka Connect to send random values. This is useful to test of streaming application reading data from Apache Kafka(such as Kafka Streams, Spark Streaming, and so on). You can see here about Apache Kafka and Kafka Connect.
You can build this connector with Apache Maven 3.3.3+.
$ mvn clean
$ mvn package -DskipTests
You should add created (and depended) jar file to class path when you run Kafka Connect.
For example(Using Kafka Connect standalone mode),
$ CLASSPATH=target/random-connector-1.0-SNAPSHOT.jar:commons-lang.jar \
{KAFKA_HOME}/bin/connect-standalone.sh {KAFKA_HOME}/config/connect-standalone.properties config/random-connector.properties
{KAFKA_HOME} is Kafka's home directory.
This connector depends on Commons Lang(detail). If you use Random String Generator, you should also add classpath this library.
Generator is the module to generate random values.
This connector has 2 generators Random Int Generator and Random String Generator.
-
Random Int Generator: send random integer and you can set range of value with configs.
-
Random String Generator: send random strings of alphabets(a-z, A-Z)
In addition to these generator, you can use your original generator.
You should new class extended Generator and implements a few methods as below.
-
setTaskConfigs
-
getKeySchema
-
getValueSchema
-
generate
In addition to these methods, you can overwrite 2 methods, if you need.
-
start
-
stop
If you don't overwrite these, nothing to do for initialize and finalize.
You can see details of these in Generator class's comments.
Name | Description | Default value |
---|---|---|
connector.class | A connector class to use (Usually, you need not to change this) |
sasakitoa.kafka.connect.random.RandomSourceConnector |
generator.class | A generator class to use. You want to use Random Int Generator or Random String Generator, should set sasakitoa.kafka.connect.random.generator.{RandomInt, RandomString} |
(none) |
name | A name of this connector | random-connector |
tasks.max | Number of tasks | 1 |
messages.per.second | Number of messages will send in a second -1 is unlimited |
-1 |
topic | Topic name will send generated random value | topic |
task.summary.enable | Enable display task summary when connector close | false |
Name | Description | Default value |
---|---|---|
random.int.key.min | Minimum value which generates for Key | 0 |
random.int.key.max | Maximum value which generates for Key | 100 |
random.int.value.min | Minimum value which generates for Value | 0 |
random.int.value.max | Maximum value which generates for Value | 100 |
Name | Description | Default value |
---|---|---|
random.string.key.length | Length of strings which generates for Key | 10 |
random.string.key.length | Length of strings which generates for Value | 10 |
This Connector has task summary funtion.
This can show task summary information such below each lanched tasks, if you enable(you can enable set task.summary.enalbe=true in connect configure).
sample(This sample is RandomInt's and 2 tasks were)
Task: 0 Processed 2351500 messages Generated key min:1 max:3, Generated value min:0 max:100
Task: 1 Processed 2351500 messages Generated key min:1 max:3, Generated value min:0 max:100
This information will be printed to stdout.
Taak Summary is readied for generic and RandomInt, and in addition this, you can implement original one. You can see how to implement original task summary as sample in below classes.
-
sasakitoa.kafka.connect.random.summary.RanmdomIntTaskSumary
-
sasakitoa.kafka.connect.random.generator.RandomInt