From 039beada3c22ab05748b8924c55a8d70367f2b85 Mon Sep 17 00:00:00 2001 From: deepak-narkhede Date: Mon, 27 Feb 2017 14:51:57 +0530 Subject: [PATCH] APEXMALHAR-2427 Kinesis Input Operator documentation. --- .../images/kinesisInput/classdiagram.png | Bin 0 -> 113852 bytes docs/operators/kinesisInputOperator.md | 178 ++++++++++++++++++ 2 files changed, 178 insertions(+) create mode 100644 docs/operators/images/kinesisInput/classdiagram.png create mode 100644 docs/operators/kinesisInputOperator.md diff --git a/docs/operators/images/kinesisInput/classdiagram.png b/docs/operators/images/kinesisInput/classdiagram.png new file mode 100644 index 0000000000000000000000000000000000000000..74b3e95004c561a213c458bf3a71401fc29ed290 GIT binary patch literal 113852 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 Consume new record(s) from latest offset in the shard. + `EARLIEST` => Consume all record(s) available in the shard. + Default value = `InitialOffset.LATEST` + +- ***repartitionInterval*** - Long + - Interval specified in milliseconds. This value specifies the minimum time required between two repartition actions. + Default Value = 30 Seconds. + +- ***repartitionCheckInterval*** - Long + - Interval specified in milliseconds. This value specifies the minimum interval between two stat checks. + Default Value = 5 Seconds. + +- ***maxTuplesPerWindow*** - Integer + - Controls the maximum number of records emitted in each streaming window from this operator. Minimum value is 1. + Default value = `MAX_VALUE` + +- ***holdingBufferSize*** - Long + - Indicates the maximum number of messages kept in memory for emitting. + Default value = 1024. + +- ***windowDataManager*** - WindowDataManager + - If set to a value other than the default, such as `FSWindowDataManager`, specifies that the operator will process the same set of messages in a window before and after a failure. This is important but it comes with higher cost because at the end of each window the operator needs to persist some state with respect to that window. + Default value = `WindowDataManager.NoopWindowDataManager`. + +#### Abstract Methods + +`T getTuple(Record record)`: Converts the Kinesis Stream record(s) to tuple. +`void emitTuple(Pair data)`: This method emits tuples extracted from AWS kinesis streams. + +#### Ports + +`outputPort `: Tuples extracted from Kinesis streams in form of records are emitted through this port. + +### KinesisConsumer + +This is an abstract implementation of Kinesis consumer. It sends the fetch +requests from AWS kinesis streams to Kinesis partitions. For each request, +it receives the set of records and stores them into the buffer which is +ArrayBlockingQueue. + + +### ShardManager + +This is an interface for offset management and is useful when consuming data +from specified offsets. Updates the offsets for all the kinesis partitions +periodically. Below is the code snippet: + +```java +public class ShardManager +{ + public Map loadInitialShardPositions(); + public Map loadInitialShardPositions(); + public void updatePositions(Map shardPositions); +} +``` + +### Partitioning + +The logical instance of the KinesisInputOperator acts as the Partitioner +as well as a StatsListener. This is because the +AbstractKinesisInputOperator implements both the +com.datatorrent.api.Partitioner and com.datatorrent.api.StatsListener +interfaces and provides an implementation of definePartitions(...) and +processStats(...) which makes it auto-scalable. + +#### Response processStats(BatchedOperatorStats stats) + +The application master invokes this method on the logical instance with +the stats (tuplesProcessedPS, bytesPS, etc.) of each partition. +Re-partitioning happens based on whether any new Kinesis streams are added/modified +or based on kinesis shards stats with respective upper bounds. + +#### DefinePartitions + +Based on the repartitionRequired field of the Response object which is +returned by processStats(...) method, the application master invokes +definePartitions(...) on the logical instance which is also the +partitioner instance. Dynamic partition can be disabled by setting the +parameter repartitionInterval value to a negative value. + + +#### KinesisStringInputOperator +This class extends from AbstractKinesisInputOperator and defines the `getTuple()` method which extracts byte array from Kinesis record. + +#### Ports +`outputPort `: Tuples extracted from Kinesis Streams are emitted through this port. + +### Application Example + +This section builds an Apex application using Kinesis input operator. +Below is the code snippet: + +```java +@ApplicationAnnotation(name="KinesisApp") +public class ExampleApplication implements StreamingApplication +{ + + @Override + public void populateDAG(DAG dag, Configuration conf) + { + KinesisStringInputOperator inputOperator = dag.addOperator("kinesisInput", new KinesisStringInputOperator()); + ConsoleOutputOperator outputOperator = dag.addOperator("Console", new ConsoleOutputOperator()); + dag.addStream("kinesis-to-console", inputOperator.outputPort, outputOperator.input); + } +} +``` +Below is the configuration for “KINESIS-STREAM-NAME” Kinesis stream name: + +```xml + + dt.operator.kinesisInput.prop.streamName + KINESIS-STREAM-NAME + + + dt.operator.kinesisInput.prop.accessKey + ACCESSKEY + + + dt.operator.kinesisInput.prop.secretKey + SECRETKEY + + + dt.operator.kinesisInput.prop.endPoint + ENDPOINT + +``` +For a full example application project, refer to https://github.com/DataTorrent/examples/tree/master/tutorials/kinesisInput