fluent-plugin-kinesis-modified 3.1.3 → 3.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|
[](https://gitter.im/awslabs/aws-fluent-plugin-kinesis?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
4
4
|
[](https://travis-ci.org/awslabs/aws-fluent-plugin-kinesis)
|
5
|
-
[](https://rubygems.org/gems/fluent-plugin-kinesis)
|
5
|
+
[](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
|