fluent-plugin-kinesis-modified 3.1.3 → 3.1.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +30 -12
- data/lib/fluent/plugin/out_kinesis_streams_aggregated_modified.rb +1 -1
- data/lib/fluent_plugin_kinesis/version.rb +1 -1
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: e5eb2e11af14feafefd700f1cdccbf3e2db10d83
|
4
|
+
data.tar.gz: c439a086a1cd5fdcfab0134c70737c80f4fcc833
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: f2a8c698e569f3aa524c1b11a9f5b9140340532d06bc94b051474920993b4922f16c124bfb29f1f102e83764bd0d3f880720983ddb4ae6b3806056fe33000bed
|
7
|
+
data.tar.gz: 7c7f1c908d027e9e787e65f5c6c9e921aa76382ad14d2ef36ae86a4e2ae09564af9ed07627cd57b6fa6497182741b50bf54866623f6b61730b82b09000ff71dd
|
data/README.md
CHANGED
@@ -2,14 +2,15 @@
|
|
2
2
|
|
3
3
|
[![Gitter](https://badges.gitter.im/awslabs/aws-fluent-plugin-kinesis.svg)](https://gitter.im/awslabs/aws-fluent-plugin-kinesis?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
4
4
|
[![Build Status](https://travis-ci.org/awslabs/aws-fluent-plugin-kinesis.svg?branch=master)](https://travis-ci.org/awslabs/aws-fluent-plugin-kinesis)
|
5
|
-
[![Gem Version](https://badge.fury.io/rb/fluent-plugin-kinesis.svg)](https://rubygems.org/gems/fluent-plugin-kinesis)
|
5
|
+
[![Gem Version](https://badge.fury.io/rb/fluent-plugin-kinesis.svg)](https://rubygems.org/gems/fluent-plugin-kinesis-modified)
|
6
6
|
|
7
7
|
[Fluentd][fluentd] output plugin
|
8
|
-
that sends events to [Amazon Kinesis Data Streams][streams] and [Amazon Kinesis Data Firehose][firehose]. Also it supports [KPL Aggregated record format][kpl]. This gem includes
|
8
|
+
that sends events to [Amazon Kinesis Data Streams][streams] and [Amazon Kinesis Data Firehose][firehose]. Also it supports [KPL Aggregated record format][kpl]. This gem includes four output plugins respectively:
|
9
9
|
|
10
10
|
- `kinesis_streams`
|
11
11
|
- `kinesis_firehose`
|
12
12
|
- `kinesis_streams_aggregated`
|
13
|
+
- `kinesis_streams_aggregated_modified`
|
13
14
|
|
14
15
|
Also, there is a [documentation on Fluentd official site][fluentd-doc-kinesis].
|
15
16
|
|
@@ -18,17 +19,17 @@ Also, there is a [documentation on Fluentd official site][fluentd-doc-kinesis].
|
|
18
19
|
## Installation
|
19
20
|
This Fluentd plugin is available as the `fluent-plugin-kinesis` gem from RubyGems.
|
20
21
|
|
21
|
-
gem install fluent-plugin-kinesis
|
22
|
+
gem install fluent-plugin-kinesis-modified
|
22
23
|
|
23
24
|
Or you can install this plugin for [td-agent][td-agent] as:
|
24
25
|
|
25
|
-
td-agent-gem install fluent-plugin-kinesis
|
26
|
+
td-agent-gem install fluent-plugin-kinesis-modified
|
26
27
|
|
27
28
|
If you would like to build by yourself and install, please see the section below. Your need [bundler][bundler] for this.
|
28
29
|
|
29
30
|
In case of using with Fluentd: Fluentd will be also installed via the process below.
|
30
31
|
|
31
|
-
git clone https://github.com/
|
32
|
+
git clone -b feature_modified_aggregation --single-branch https://github.com/BlackNight95/aws-fluent-plugin-kinesis.git
|
32
33
|
cd aws-fluent-plugin-kinesis
|
33
34
|
bundle install
|
34
35
|
bundle exec rake build
|
@@ -36,15 +37,15 @@ In case of using with Fluentd: Fluentd will be also installed via the process be
|
|
36
37
|
|
37
38
|
Also, you can use this plugin with td-agent: You have to install td-agent before installing this plugin.
|
38
39
|
|
39
|
-
git clone https://github.com/
|
40
|
+
git clone -b feature_modified_aggregation --single-branch https://github.com/BlackNight95/aws-fluent-plugin-kinesis.git
|
40
41
|
cd aws-fluent-plugin-kinesis
|
41
42
|
bundle install
|
42
43
|
bundle exec rake build
|
43
|
-
fluent-gem install pkg/fluent-plugin-kinesis
|
44
|
+
fluent-gem install pkg/fluent-plugin-kinesis-modified
|
44
45
|
|
45
46
|
Or just download specify your Ruby library path. Below is the sample for specifying your library path via RUBYLIB.
|
46
47
|
|
47
|
-
git clone https://github.com/
|
48
|
+
git clone -b feature_modified_aggregation --single-branch https://github.com/BlackNight95/aws-fluent-plugin-kinesis.git
|
48
49
|
cd aws-fluent-plugin-kinesis
|
49
50
|
bundle install
|
50
51
|
export RUBYLIB=$RUBYLIB:/path/to/aws-fluent-plugin-kinesis/lib
|
@@ -92,15 +93,15 @@ For more details, see [Configuration: kinesis_streams](#configuration-kinesis_st
|
|
92
93
|
</match>
|
93
94
|
For more details, see [Configuration: kinesis_firehose](#configuration-kinesis_firehose).
|
94
95
|
|
95
|
-
### kinesis_streams_aggregated
|
96
|
+
### kinesis_streams_aggregated/kinesis_streams_aggregated_modified
|
96
97
|
<match your_tag>
|
97
|
-
@type kinesis_streams_aggregated
|
98
|
+
@type kinesis_streams_aggregated/kinesis_streams_aggregated_modified
|
98
99
|
region us-east-1
|
99
100
|
stream_name your_stream
|
100
101
|
# Unlike kinesis_streams, there is no way to use dynamic partition key.
|
101
102
|
# fixed_partition_key or random.
|
102
103
|
</match>
|
103
|
-
For more details, see [Configuration: kinesis_streams_aggregated](#configuration-kinesis_streams_aggregated).
|
104
|
+
For more details, see [Configuration: kinesis_streams_aggregated](#configuration-kinesis_streams_aggregated) and [Configuration: kinesis_streams_aggregated_modified](#configuration-kinesis_streams_aggregated_modified).
|
104
105
|
|
105
106
|
### For better throughput
|
106
107
|
Add configurations like below:
|
@@ -346,8 +347,9 @@ Default:
|
|
346
347
|
- `kinesis_streams`: 500
|
347
348
|
- `kinesis_firehose`: 500
|
348
349
|
- `kinesis_streams_aggregated`: 100,000
|
350
|
+
- `kinesis_streams_aggregated_modified`: 100,000
|
349
351
|
|
350
|
-
###
|
352
|
+
### size_kb_per_record
|
351
353
|
Integer. The number of max size of making batch request from record chunk. It can't exceed the default value because it's API limit.
|
352
354
|
|
353
355
|
Default:
|
@@ -355,6 +357,7 @@ Default:
|
|
355
357
|
- `kinesis_streams`: 5 MB
|
356
358
|
- `kinesis_firehose`: 4 MB
|
357
359
|
- `kinesis_streams_aggregated`: 1 MB
|
360
|
+
- `kinesis_streams_aggregated_modified`: 1 MB
|
358
361
|
|
359
362
|
## Configuration: kinesis_streams
|
360
363
|
Here are `kinesis_streams` specific configurations.
|
@@ -386,6 +389,21 @@ A value of fixed partition key. Default `nil`, which means partition key will be
|
|
386
389
|
|
387
390
|
Note: if you specified this option, all records go to a single shard.
|
388
391
|
|
392
|
+
## Configuration: kinesis_streams_aggregated_modified
|
393
|
+
Here are `kinesis_streams_aggregated_modified` specific configurations.
|
394
|
+
|
395
|
+
### stream_name
|
396
|
+
Name of the stream to put data.
|
397
|
+
|
398
|
+
### fixed_partition_key
|
399
|
+
A value of fixed partition key. Default `nil`, which means partition key will be generated randomly.
|
400
|
+
|
401
|
+
Note: if you specified this option, all records go to a single shard.
|
402
|
+
|
403
|
+
### max_records_per_call
|
404
|
+
Integer. Max number of aggregated records sent to kinesis with put_records method in each iteration. max_records_per_call * size_kb_per_record should not exceed 5 MB.
|
405
|
+
|
406
|
+
|
389
407
|
## Development
|
390
408
|
|
391
409
|
To launch `fluentd` process with this plugin for development, follow the steps below:
|
@@ -21,7 +21,7 @@ module Fluent
|
|
21
21
|
Fluent::Plugin.register_output('kinesis_streams_aggregated_modified', self)
|
22
22
|
include KinesisHelper::Aggregator::Mixin
|
23
23
|
|
24
|
-
RequestType = :
|
24
|
+
RequestType = :streams
|
25
25
|
BatchRequestLimitCount = 100_000
|
26
26
|
BatchRequestLimitSize = 1024 * 1024
|
27
27
|
include KinesisHelper::API::BatchRequest
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: fluent-plugin-kinesis-modified
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 3.1.
|
4
|
+
version: 3.1.4
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- iHandy
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2019-
|
11
|
+
date: 2019-08-13 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: fluentd
|
@@ -305,7 +305,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
305
305
|
version: '0'
|
306
306
|
requirements: []
|
307
307
|
rubyforge_project:
|
308
|
-
rubygems_version: 2.5.2
|
308
|
+
rubygems_version: 2.5.2
|
309
309
|
signing_key:
|
310
310
|
specification_version: 4
|
311
311
|
summary: Fluentd output plugin that sends events to Amazon Kinesis. Forked from fluent-plugin-kinesis
|