madhawk57-log 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e658101d8d7eb4fc8bfd4b68b84d173c3160405359ff9643b42c9753b7d55712
+  data.tar.gz: be5eb51793b4876cc4d20ef502b195cc41a65fd3242caf9067b669450a9e47db
+SHA512:
+  metadata.gz: 88ffa2d3a61162e24fe89a3fe92a1afed1737faa97c8e0eda188ce7b11ce5244c266590b36f1514ed617b2980f5886d16b0f947f78159383550565bf8bfe1747
+  data.tar.gz: b9ec57f4c3b4960b57731a8780310c9d71d9340a4ca3e93c08d8acccf151a660ad8e1e66fafc4310429e0e4d857a0135b8fb8d31326e1f894ee6439c5e392faf

data/.gitignore

@@ -0,0 +1,3 @@
+/Gemfile.lock
+*.swp
+.idea

data/.travis.yml

@@ -0,0 +1,21 @@
+language: ruby
+
+rvm:
+  - 2.1
+  - 2.2
+  - 2.3.1
+  - 2.4.1
+  - 2.5.0
+  - ruby-head
+
+before_install:
+  - gem update --system=2.7.8
+script:
+  - bundle exec rake test
+
+sudo: false
+
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+

data/ChangeLog

@@ -0,0 +1,254 @@
+Release 0.13.0 - 2020/03/09
+
+	* Accept ruby-kafka v1 or later
+
+Release 0.12.4 - 2020/03/03
+
+	* output: Follow rdkafka log level
+
+Release 0.12.3 - 2020/02/06
+
+	* output: Show warning message for v0.12 plugins
+
+Release 0.12.2 - 2020/01/07
+
+	* input: Refer sasl_over_ssl parameter in plain SASL
+
+Release 0.12.1 - 2019/10/14
+
+	* input: Add time_source parameter to replace use_record_time
+
+Release 0.12.0 - 2019/09/27
+
+	* Support rdkafka-ruby v0.7. Drop v0.6 support.
+
+Release 0.11.2 - 2019/09/27
+
+	* out_rdkafka2: Add share_producer parameter
+
+Release 0.11.1 - 2019/08/22
+
+	* out_kafka2: Fix mutating issue of headers
+
+Release 0.11.0 - 2019/07/17
+
+	* out_kafka2: Add connect_timeout / socket_timeout parameters
+	* out_kafka2/out_rdkafka2: Add headers / headers_from_record parameters
+	* output: Add use_event_time parameter to use fluentd event time for CreateTime
+	* input: Add get_kafka_client_log parameter. Default is `false`
+
+Release 0.10.0 - 2019/07/03
+
+	* output: Fixed max_send_limit_bytes parameter to be in all kafka outputs
+	* output: Add ssl_verify_hostname parameter
+	* rdkafka output: Fix exceptiona handling
+	* Update ruby-kafka version to v0.7.8 or later
+
+Release 0.9.6 - 2019/05/28
+
+	* out_kafka2: Add metadata nil check
+
+Release 0.9.5 - 2019/05/23
+
+	* output: Support sasl_over_ssl parameter to not use SSL with SASL/GSSAPI
+
+Release 0.9.4 - 2019/05/13
+
+	* out_rdkafka2: Add metadata nil check
+
+Release 0.9.3 - 2019/05/04
+
+	* in_kafka_group: Add connect_timeout and socket_timeout parameters
+
+Release 0.9.2 - 2019/03/26
+
+	* out_kafka_buffered: Fix typo of partition_key usage
+
+Release 0.9.1 - 2019/03/25
+
+	* output: Support sasl_over_ssl parameter
+	* Support ruby-kafka 0.7.6
+
+Release 0.9.0 - 2019/02/22
+
+	* Add v1 API based rdkafka2 output plugin
+	* out_kafka2: Add use_default_for_unknown_topic parameter
+
+Release 0.8.4 - 2019/01/18
+
+	* in_kafka_group: Support integer/float time field with time_format
+
+Release 0.8.3 - 2018/12/16
+
+	* output: Add ssl_client_cert_chain parameter
+
+Release 0.8.2 - 2018/12/07
+
+	* output: Add idempotent parameter
+	* out_kafka2: Fix DeliveryFailed signature mismatch
+
+Release 0.8.1 - 2018/11/20
+
+	* input: Support SASL without SSL
+
+Release 0.8.0 - 2018/10/18
+
+	* output: Support SASL without SSL
+	* output: Add rdkafka based output
+	* Update ruby-kafka dependency to v0.7 or later
+
+Release 0.7.9 - 2018/09/11
+
+	* in_kafka_group: Add fetcher_max_queue_size parameter
+
+Release 0.7.8 - 2018/08/29
+
+	* input: Fix regression of kafka initialization
+
+Release 0.7.7 - 2018/08/27
+
+	* in_kafka_group: Add retry_limit and disable_retry_limit parameters
+	* input: Support SSL parameters
+	* Add ssl_ca_certs_from_system parameter
+	* Make password parameter secret
+
+Release 0.7.6 - 2018/08/15
+
+	* out_kafka2: Add ignore_exceptions and exception_backup parameters
+
+Release 0.7.5 - 2018/08/14
+
+	* out_kafka2: Fix `message_key_key` parameter handling
+	* Limit ruby-kafka version('< 0.7.0') to avoid runtime error
+
+Release 0.7.4 - 2018/07/11
+
+	* out_kafka2: Need event_emitter helper for notification
+
+Release 0.7.3 - 2018/05/30
+
+	* output: Use SSL endpoint when ssl_client_cert is true
+
+Release 0.7.2 - 2018/03/12
+
+	* output: Fix the regression of get_kafka_client_log parameter
+
+Release 0.7.1 - 2018/03/05
+
+	* out_kafka2: Fix the regression of kafka client initialization
+
+Release 0.7.0 - 2018/02/27
+
+	* output: SASL PLAIN/SCRAM support
+	* input: Fix TimeParser location bug in v1
+	* out_kafka2: Fix warning condition for tag chunk key
+
+Release 0.6.6 - 2017/12/25
+
+	* output: Make topic/partition/partition_key/message_key configurable
+
+Release 0.6.5 - 2017/12/14
+
+	* in_kafka_group: Add client_id parameter
+
+Release 0.6.4 - 2017/11/23
+
+	* Multi worker support for v0.14
+	* Add kafka_message_key parameter to input plugins
+	* Relax ruby-kafka version for 0.5 or later
+	* Use oj for json when it is installed
+
+Release 0.6.3 - 2017/11/14
+
+	* in_kafka_group: re-create consumer when error happens during event fetch
+
+Release 0.6.2 - 2017/11/1
+
+	* Fix ltsv parsing issue which generates symbol keys
+
+Release 0.6.1 - 2017/08/30
+
+	* Add stats and datadog monitoring support
+	* ssl_ca_certs now accepts multiple paths
+	* Fix bug by ruby-kafka 0.4.1 changes
+	* Update ruby-kafka dependency to v0.4.1
+
+Release 0.6.0 - 2017/07/25
+
+	* Add principal and keytab parameters for SASL support
+
+Release 0.5.7 - 2017/07/13
+
+	* out_kafka_buffered: Add kafka_agg_max_messages parameter
+
+Release 0.5.6 - 2017/07/10
+
+	* output: Add ActiveSupport notification support
+
+Release 0.5.5 - 2017/04/19
+
+	* output: Some trace log level changed to debug
+	* out_kafka_buffered: Add discard_kafka_delivery_failed parameter
+
+Release 0.5.4 - 2017/04/12
+
+	* out_kafka_buffered: Add max_send_limit_bytes parameter
+	* out_kafka: Improve buffer overflow handling of ruby-kafka
+
+Release 0.5.3 - 2017/02/13
+
+	* Relax ruby-kafka dependency
+
+Release 0.5.2 - 2017/02/13
+
+	* in_kafka_group: Add max_bytes parameter
+
+Release 0.5.1 - 2017/02/06
+
+	* in_kafka_group: Fix uninitialized constant error
+
+Release 0.5.0 - 2017/01/17
+
+	* output: Add out_kafka2 plugin with v0.14 API
+
+Release 0.4.2 - 2016/12/10
+
+	* input: Add use_record_time and time_format parameters
+	* Update ruby-kafka dependency to 0.3.16.beta2
+
+Release 0.4.1 - 2016/12/01
+
+	* output: Support specifying partition
+
+Release 0.4.0 - 2016/11/08
+
+	* Remove zookeeper dependency
+
+Release 0.3.5 - 2016/10/21
+
+	* output: Support message key and related parameters. #91
+
+Release 0.3.4 - 2016/10/20
+
+	* output: Add exclude_topic_key and exclude_partition_key. #89
+
+Release 0.3.3 - 2016/10/17
+
+	* out_kafka_buffered: Add get_kafka_client_log parameter. #83
+	* out_kafka_buffered: Skip and log invalid record to avoid buffer stuck. #86
+	* in_kafka_group: Add retry_emit_limit to handle BufferQueueLimitError. #87
+
+Release 0.3.2 - 2016/10/06
+
+	* in_kafka_group: Re-fetch events after consumer error. #79
+
+Release 0.3.1 - 2016/08/28
+
+	* output: Change default required_acks to -1. #70
+	* Support ruby version changed to 2.1.0 or later
+
+Release 0.3.0 - 2016/08/24
+
+	* Fully replace poseidon ruby library with ruby-kafka to support latest kafka versions
+
+See git commits for older changes

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fluent-plugin-kafka.gemspec
+gemspec
+
+

data/LICENSE

@@ -0,0 +1,14 @@
+Copyright (C) 2014 htgc
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

data/README.md

@@ -0,0 +1,463 @@
+# fluent-plugin-kafka, a plugin for [Fluentd](http://fluentd.org)
+
+[![Build Status](https://travis-ci.org/fluent/fluent-plugin-kafka.svg?branch=master)](https://travis-ci.org/fluent/fluent-plugin-kafka)
+
+A fluentd plugin to both consume and produce data for Apache Kafka.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'fluent-plugin-kafka'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install fluent-plugin-kafka --no-document
+
+If you want to use zookeeper related parameters, you also need to install zookeeper gem. zookeeper gem includes native extension, so development tools are needed, e.g. ruby-devel, gcc, make and etc.
+
+## Requirements
+
+- Ruby 2.1 or later
+- Input plugins work with kafka v0.9 or later
+- Output plugins work with kafka v0.8 or later
+
+## Usage
+
+### Common parameters
+
+#### SSL authentication
+
+- ssl_ca_cert
+- ssl_client_cert
+- ssl_client_cert_key
+- ssl_ca_certs_from_system
+
+Set path to SSL related files. See [Encryption and Authentication using SSL](https://github.com/zendesk/ruby-kafka#encryption-and-authentication-using-ssl) for more detail.
+
+#### SASL authentication 
+
+##### with GSSAPI
+
+- principal
+- keytab
+
+Set principal and path to keytab for SASL/GSSAPI authentication. 
+See [Authentication using SASL](https://github.com/zendesk/ruby-kafka#authentication-using-sasl) for more details.
+
+##### with Plain/SCRAM
+
+- username
+- password
+- scram_mechanism
+- sasl_over_ssl
+
+Set username, password, scram_mechanism and sasl_over_ssl for SASL/Plain or Scram authentication. 
+See [Authentication using SASL](https://github.com/zendesk/ruby-kafka#authentication-using-sasl) for more details.
+
+##### fetch auth info from GSM
+- secretName
+- projectId
+- version :optional
+
+***Requires GOOGLE_APPLICATION_CREDENTIALS env var to be set***
+
+### Input plugin (@type 'kafka')
+
+Consume events by single consumer.
+
+    <source>
+      @type kafka
+
+      brokers <broker1_host>:<broker1_port>,<broker2_host>:<broker2_port>,..
+      topics <listening topics(separate with comma',')>
+      format <input text type (text|json|ltsv|msgpack)> :default => json
+      message_key <key (Optional, for text format only, default is message)>
+      add_prefix <tag prefix (Optional)>
+      add_suffix <tag suffix (Optional)>
+
+      # Optionally, you can manage topic offset by using zookeeper
+      offset_zookeeper    <zookeer node list (<zookeeper1_host>:<zookeeper1_port>,<zookeeper2_host>:<zookeeper2_port>,..)>
+      offset_zk_root_node <offset path in zookeeper> default => '/fluent-plugin-kafka'
+
+      # ruby-kafka consumer options
+      max_bytes     (integer) :default => nil (Use default of ruby-kafka)
+      max_wait_time (integer) :default => nil (Use default of ruby-kafka)
+      min_bytes     (integer) :default => nil (Use default of ruby-kafka)
+    </source>
+
+Supports a start of processing from the assigned offset for specific topics.
+
+    <source>
+      @type kafka
+
+      brokers <broker1_host>:<broker1_port>,<broker2_host>:<broker2_port>,..
+      format <input text type (text|json|ltsv|msgpack)>
+      <topic>
+        topic     <listening topic>
+        partition <listening partition: default=0>
+        offset    <listening start offset: default=-1>
+      </topic>
+      <topic>
+        topic     <listening topic>
+        partition <listening partition: default=0>
+        offset    <listening start offset: default=-1>
+      </topic>
+    </source>
+
+See also [ruby-kafka README](https://github.com/zendesk/ruby-kafka#consuming-messages-from-kafka) for more detailed documentation about ruby-kafka.
+
+Consuming topic name is used for event tag. So when the target topic name is `app_event`, the tag is `app_event`. If you want to modify tag, use `add_prefix` or `add_suffix` parameters. With `add_prefix kafka`, the tag is `kafka.app_event`.
+
+### Input plugin (@type 'kafka_group', supports kafka group)
+
+Consume events by kafka consumer group features..
+
+    <source>
+      @type kafka_group
+
+      brokers <broker1_host>:<broker1_port>,<broker2_host>:<broker2_port>,..
+      consumer_group <consumer group name, must set>
+      topics <listening topics(separate with comma',')>
+      format <input text type (text|json|ltsv|msgpack)> :default => json
+      message_key <key (Optional, for text format only, default is message)>
+      add_prefix <tag prefix (Optional)>
+      add_suffix <tag suffix (Optional)>
+      retry_emit_limit <Wait retry_emit_limit x 1s when BuffereQueueLimitError happens. The default is nil and it means waiting until BufferQueueLimitError is resolved>
+      use_record_time (Deprecated. Use 'time_source record' instead.) <If true, replace event time with contents of 'time' field of fetched record>
+      time_source <source for message timestamp (now|kafka|record)> :default => now
+      time_format <string (Optional when use_record_time is used)>
+
+      # ruby-kafka consumer options
+      max_bytes               (integer) :default => 1048576
+      max_wait_time           (integer) :default => nil (Use default of ruby-kafka)
+      min_bytes               (integer) :default => nil (Use default of ruby-kafka)
+      offset_commit_interval  (integer) :default => nil (Use default of ruby-kafka)
+      offset_commit_threshold (integer) :default => nil (Use default of ruby-kafka)
+      fetcher_max_queue_size  (integer) :default => nil (Use default of ruby-kafka)
+      start_from_beginning    (bool)    :default => true
+    </source>
+
+See also [ruby-kafka README](https://github.com/zendesk/ruby-kafka#consuming-messages-from-kafka) for more detailed documentation about ruby-kafka options.
+
+Consuming topic name is used for event tag. So when the target topic name is `app_event`, the tag is `app_event`. If you want to modify tag, use `add_prefix` or `add_suffix` parameter. With `add_prefix kafka`, the tag is `kafka.app_event`.
+
+### Output plugin
+
+This `kafka2` plugin is for fluentd v1.0 or later. This will be `out_kafka` plugin in the future.
+
+    <match app.**>
+      @type kafka2
+
+      brokers               <broker1_host>:<broker1_port>,<broker2_host>:<broker2_port>,.. # Set brokers directly
+      topic_key             (string) :default => 'topic'
+      partition_key         (string) :default => 'partition'
+      partition_key_key     (string) :default => 'partition_key'
+      message_key_key       (string) :default => 'message_key'
+      default_topic         (string) :default => nil
+      default_partition_key (string) :default => nil
+      default_message_key   (string) :default => nil
+      exclude_topic_key     (bool)   :default => false
+      exclude_partition_key (bool)   :default => false
+      exclude_partition     (bool)   :default => false
+      exclude_message_key   (bool)   :default => false
+      get_kafka_client_log  (bool)   :default => false
+      headers               (hash)   :default => {}
+      headers_from_record   (hash)   :default => {}
+      use_default_for_unknown_topic (bool) :default => false
+
+      <format>
+        @type (json|ltsv|msgpack|attr:<record name>|<formatter name>) :default => json
+      </format>
+
+      # Optional. See https://docs.fluentd.org/v/1.0/configuration/inject-section
+      <inject>
+        tag_key tag
+        time_key time
+      </inject>
+
+      # See fluentd document for buffer related parameters: https://docs.fluentd.org/v/1.0/configuration/buffer-section
+      # Buffer chunk key should be same with topic_key. If value is not found in the record, default_topic is used.
+      <buffer topic>
+        flush_interval 10s
+      </buffer>
+
+      # ruby-kafka producer options
+      idempotent        (bool)    :default => false
+      sasl_over_ssl     (bool)    :default => true
+      max_send_retries  (integer) :default => 1
+      required_acks     (integer) :default => -1
+      ack_timeout       (integer) :default => nil (Use default of ruby-kafka)
+      compression_codec (string)  :default => nil (No compression. Depends on ruby-kafka: https://github.com/zendesk/ruby-kafka#compression)
+    </match>
+
+The `<formatter name>` in `<format>` uses fluentd's formatter plugins. See [formatter article](https://docs.fluentd.org/v/1.0/formatter).
+
+ruby-kafka sometimes returns `Kafka::DeliveryFailed` error without good information.
+In this case, `get_kafka_client_log` is useful for identifying the error cause.
+ruby-kafka's log is routed to fluentd log so you can see ruby-kafka's log in fluentd logs.
+
+Supports following ruby-kafka's producer options.
+
+- max_send_retries - default: 1 - Number of times to retry sending of messages to a leader.
+- required_acks - default: -1 - The number of acks required per request. If you need flush performance, set lower value, e.g. 1, 2.
+- ack_timeout - default: nil - How long the producer waits for acks. The unit is seconds.
+- compression_codec - default: nil - The codec the producer uses to compress messages.
+- max_send_limit_bytes - default: nil - Max byte size to send message to avoid MessageSizeTooLarge. For example, if you set 1000000(message.max.bytes in kafka), Message more than 1000000 byes will be dropped.
+- discard_kafka_delivery_failed - default: false - discard the record where [Kafka::DeliveryFailed](http://www.rubydoc.info/gems/ruby-kafka/Kafka/DeliveryFailed) occurred
+- monitoring_list - default: [] - library to be used to monitor. statsd and datadog are supported
+
+If you want to know about detail of monitoring, see also https://github.com/zendesk/ruby-kafka#monitoring
+
+See also [Kafka::Client](http://www.rubydoc.info/gems/ruby-kafka/Kafka/Client) for more detailed documentation about ruby-kafka.
+
+This plugin supports compression codec "snappy" also.
+Install snappy module before you use snappy compression.
+
+    $ gem install snappy --no-document
+
+snappy gem uses native extension, so you need to install several packages before.
+On Ubuntu, need development packages and snappy library.
+
+    $ sudo apt-get install build-essential autoconf automake libtool libsnappy-dev
+
+On CentOS 7 installation is also necessary.
+
+    $ sudo yum install gcc autoconf automake libtool snappy-devel
+
+This plugin supports compression codec "lz4" also.
+Install extlz4 module before you use lz4 compression.
+
+    $ gem install extlz4 --no-document
+
+This plugin supports compression codec "zstd" also.
+Install zstd-ruby module before you use zstd compression.
+
+    $ gem install zstd-ruby --no-document
+
+#### Load balancing
+
+Messages will be assigned a partition at random as default by ruby-kafka, but messages with the same partition key will always be assigned to the same partition by setting `default_partition_key` in config file.
+If key name `partition_key_key` exists in a message, this plugin set the value of partition_key_key as key.
+
+|default_partition_key|partition_key_key| behavior |
+| --- | --- | --- |
+|Not set|Not exists| All messages are assigned a partition at random |
+|Set| Not exists| All messages are assigned to the specific partition |
+|Not set| Exists | Messages which have partition_key_key record are assigned to the specific partition, others are assigned a partition at random |
+|Set| Exists | Messages which have partition_key_key record are assigned to the specific partition with partition_key_key, others are assigned to the specific partition with default_parition_key |
+
+If key name `message_key_key` exists in a message, this plugin publishes the value of message_key_key to kafka and can be read by consumers. Same message key will be assigned to all messages by setting `default_message_key` in config file. If message_key_key exists and if partition_key_key is not set explicitly, messsage_key_key will be used for partitioning.
+
+#### Headers
+It is possible to set headers on Kafka messages. This only works for kafka2 and rdkafka2 output plugin.
+
+The format is like key1:value1,key2:value2. For example:
+
+    <match app.**>
+      @type kafka2
+      [...]
+      headers some_header_name:some_header_value
+    <match>
+
+You may set header values based on a value of a fluentd record field. For example, imagine a fluentd record like:
+
+    {"source": { "ip": "127.0.0.1" }, "payload": "hello world" }
+
+And the following fluentd config:
+
+    <match app.**>
+      @type kafka2
+      [...]
+      headers_from_record source_ip:$.source.ip
+    <match>
+
+The Kafka message will have a header of source_ip=12.7.0.0.1.
+
+The configuration format is jsonpath. It is descibed in https://docs.fluentd.org/plugin-helper-overview/api-plugin-helper-record_accessor
+
+### Buffered output plugin
+
+This plugin uses ruby-kafka producer for writing data. This plugin is for v0.12. If you use v1, see `kafka2`.
+Support of fluentd v0.12 has ended. `kafka_buffered` will be an alias of `kafka2` and will be removed in the future.
+
+    <match app.**>
+      @type kafka_buffered
+
+      # Brokers: you can choose either brokers or zookeeper. If you are not familiar with zookeeper, use brokers parameters.
+      brokers             <broker1_host>:<broker1_port>,<broker2_host>:<broker2_port>,.. # Set brokers directly
+      zookeeper           <zookeeper_host>:<zookeeper_port> # Set brokers via Zookeeper
+      zookeeper_path      <broker path in zookeeper> :default => /brokers/ids # Set path in zookeeper for kafka
+
+      topic_key             (string) :default => 'topic'
+      partition_key         (string) :default => 'partition'
+      partition_key_key     (string) :default => 'partition_key'
+      message_key_key       (string) :default => 'message_key'
+      default_topic         (string) :default => nil
+      default_partition_key (string) :default => nil
+      default_message_key   (string) :default => nil
+      exclude_topic_key     (bool)   :default => false
+      exclude_partition_key (bool)   :default => false
+      exclude_partition     (bool)   :default => false
+      exclude_message_key   (bool)   :default => false
+      output_data_type      (json|ltsv|msgpack|attr:<record name>|<formatter name>) :default => json
+      output_include_tag    (bool) :default => false
+      output_include_time   (bool) :default => false
+      exclude_topic_key     (bool) :default => false
+      exclude_partition_key (bool) :default => false
+      get_kafka_client_log  (bool) :default => false
+
+      # See fluentd document for buffer related parameters: https://docs.fluentd.org/v/0.12/buffer
+
+      # ruby-kafka producer options
+      idempotent                   (bool)    :default => false
+      sasl_over_ssl                (bool)    :default => true
+      max_send_retries             (integer) :default => 1
+      required_acks                (integer) :default => -1
+      ack_timeout                  (integer) :default => nil (Use default of ruby-kafka)
+      compression_codec            (string)  :default => nil (No compression. Depends on ruby-kafka: https://github.com/zendesk/ruby-kafka#compression)
+      kafka_agg_max_bytes          (integer) :default => 4096
+      kafka_agg_max_messages       (integer) :default => nil (No limit)
+      max_send_limit_bytes         (integer) :default => nil (No drop)
+      discard_kafka_delivery_failed   (bool) :default => false (No discard)
+      monitoring_list              (array)   :default => []
+    </match>
+
+`kafka_buffered` has two additional parameters:
+
+- kafka_agg_max_bytes - default: 4096 - Maximum value of total message size to be included in one batch transmission.
+- kafka_agg_max_messages - default: nil - Maximum number of messages to include in one batch transmission.
+
+### Non-buffered output plugin
+
+This plugin uses ruby-kafka producer for writing data. For performance and reliability concerns, use `kafka_bufferd` output instead. This is mainly for testing.
+
+    <match app.**>
+      @type kafka
+
+      # Brokers: you can choose either brokers or zookeeper.
+      brokers        <broker1_host>:<broker1_port>,<broker2_host>:<broker2_port>,.. # Set brokers directly
+      zookeeper      <zookeeper_host>:<zookeeper_port> # Set brokers via Zookeeper
+      zookeeper_path <broker path in zookeeper> :default => /brokers/ids # Set path in zookeeper for kafka
+
+      default_topic         (string) :default => nil
+      default_partition_key (string) :default => nil
+      default_message_key   (string) :default => nil
+      output_data_type      (json|ltsv|msgpack|attr:<record name>|<formatter name>) :default => json
+      output_include_tag    (bool) :default => false
+      output_include_time   (bool) :default => false
+      exclude_topic_key     (bool) :default => false
+      exclude_partition_key (bool) :default => false
+
+      # ruby-kafka producer options
+      max_send_retries    (integer) :default => 1
+      required_acks       (integer) :default => -1
+      ack_timeout         (integer) :default => nil (Use default of ruby-kafka)
+      compression_codec   (string)  :default => nil (No compression. Depends on ruby-kafka: https://github.com/zendesk/ruby-kafka#compression)
+      max_buffer_size     (integer) :default => nil (Use default of ruby-kafka)
+      max_buffer_bytesize (integer) :default => nil (Use default of ruby-kafka)
+    </match>
+
+This plugin also supports ruby-kafka related parameters. See Buffered output plugin section.
+
+### rdkafka based output plugin
+
+This plugin uses `rdkafka` instead of `ruby-kafka` for kafka client.
+You need to install rdkafka gem.
+
+    # rdkafka is C extension library. Need to install development tools like ruby-devel, gcc and etc
+    # for v0.12 or later
+    $ gem install rdkafka --no-document
+    # for v0.11 or earlier
+    $ gem install rdkafka -v 0.6.0 --no-document
+
+`rdkafka2` is for fluentd v1.0 or later.
+
+    <match app.**>
+      @type rdkafka2
+
+      brokers <broker1_host>:<broker1_port>,<broker2_host>:<broker2_port>,.. # Set brokers directly
+
+      topic_key             (string) :default => 'topic'
+      default_topic         (string) :default => nil
+      partition_key         (string) :default => 'partition'
+      partition_key_key     (string) :default => 'partition_key'
+      message_key_key       (string) :default => 'message_key'
+      default_topic         (string) :default => nil
+      default_partition_key (string) :default => nil
+      default_message_key   (string) :default => nil
+      exclude_topic_key     (bool) :default => false
+      exclude_partition_key (bool) :default => false
+
+      # same with kafka2
+      headers               (hash) :default => {}
+      headers_from_record   (hash) :default => {}
+
+      <format>
+        @type (json|ltsv|msgpack|attr:<record name>|<formatter name>) :default => json
+      </format>
+
+      # Optional. See https://docs.fluentd.org/v/1.0/configuration/inject-section
+      <inject>
+        tag_key tag
+        time_key time
+      </inject>
+
+      # See fluentd document for buffer section parameters: https://docs.fluentd.org/v/1.0/configuration/buffer-section
+      # Buffer chunk key should be same with topic_key. If value is not found in the record, default_topic is used.
+      <buffer topic>
+        flush_interval 10s
+      </buffer>
+
+      # You can set any rdkafka configuration via this parameter: https://github.com/edenhill/librdkafka/blob/master/CONFIGURATION.md
+      rdkafka_options {
+        "log_level" : 7
+      }
+
+      # rdkafka2 specific parameters
+
+      # share kafka producer between flush threads. This is mainly for reducing kafka operations like kerberos
+      share_producer (bool) :default => false
+      # Timeout for polling message wait. If 0, no wait.
+      rdkafka_delivery_handle_poll_timeout (integer) :default => 30
+      # If the record size is larger than this value, such records are ignored. Default is no limit
+      max_send_limit_bytes (integer) :default => nil
+    </match>
+
+If you use v0.12, use `rdkafka` instead.
+
+    <match kafka.**>
+      @type rdkafka
+
+      default_topic kafka
+      flush_interval 1s
+      output_data_type json
+
+      rdkafka_options {
+        "log_level" : 7
+      }
+    </match>
+
+## FAQ
+
+### Why fluent-plugin-kafka can't send data to our kafka cluster?
+
+We got lots of similar questions. Almost cases, this problem happens by version mismatch between ruby-kafka and kafka cluster.
+See ruby-kafka README for more details: https://github.com/zendesk/ruby-kafka#compatibility
+
+To avoid the problem, there are 2 approaches:
+
+- Upgrade your kafka cluster to latest version. This is better becase recent version is faster and robust.
+- Downgrade ruby-kafka/fluent-plugin-kafka to work with your older kafka.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request