kinesis-write-stream

kinesis-write-stream

Kinesis writable stream that buffers up records

Usage

Records written to the stream will buffer up until highWaterMark has been reached, or the stream is closed, before writing to Kinesis using putRecords.

Failed items

Failed items will be retried up until options.maxRetries has been reached. The initial timeout before the retry is set in options.retryTimeout and it increases by the fibonnaci sequence.

Partition key

The partition key is by default a random number, but this can be adjusted by overriding streamInstance.getPartitionKey(record).

Flushing

Its also possible to send in the option flushTimeout to indicate that the items currently in the buffer should be flushed after the given amount of milliseconds if the highWaterMark haven't been reached.

Logging

A bunyan, winston or similar logger instance that have methods like debug, error and info may be sent in as options.logger to the constructor.

Example

var KinesisWritable = require('kinesis-write-stream');

var stream = new KinesisWritable(kinesisClient, 'streamName', {
  highWaterMark: 16,
  maxRetries: 3,
  retryTimeout: 100
});

inputStream.pipe(stream);

API

See api.md.

License

MIT

Changelog

[1.1.1] - 2018-01-18

Fixed

• Fixed bug that would cause loss of events written between a write to Kinesis started and finished. Fixed by @chrissharkey.