README.md in fluent-plugin-out-http-1.2.0 vs README.md in fluent-plugin-out-http-1.3.0
- old
+ new
@@ -1,38 +1,45 @@
-# fluent-plugin-out-http, a plugin for [Fluentd](http://fluentd.org)
-
-A generic [fluentd][1] output plugin for sending logs to an HTTP endpoint.
-
-[](https://travis-ci.org/fluent-plugins-nursery/fluent-plugin-out-http)
-
-## Configuration options
-
- <match *>
- @type http
- endpoint_url http://localhost.local/api/
- http_method put # default: post
- serializer json # default: form
- rate_limit_msec 100 # default: 0 = no rate limiting
- raise_on_error false # default: true
- authentication basic # default: none
- username alice # default: ''
- password bobpop # default: '', secret: true
- buffered true # default: false. Switch non-buffered/buffered mode
- cacert_file /etc/ssl/endpoint1.cert # default: ''
- client_cert_path /path/to/client_cert.crt # default: ''
- private_key_path /path/to/private_key.key # default: ''
- private_key_passphrase yourpassphrase # default: ''
- token tokent # default: ''
- custom_headers {"token":"arbitrary"} # default: nil
- </match>
-
-## Usage notes
-
-If you'd like to retry failed requests, consider using [fluent-plugin-bufferize][3].
-
-----
-
-Heavily based on [fluent-plugin-growthforecast][2]
-
- [1]: http://fluentd.org/
- [2]: https://github.com/tagomoris/fluent-plugin-growthforecast
- [3]: https://github.com/sabottenda/fluent-plugin-bufferize
+# fluent-plugin-out-http, a plugin for [Fluentd](http://fluentd.org)
+
+A generic [fluentd][1] output plugin for sending logs to an HTTP endpoint.
+
+[](https://travis-ci.org/fluent-plugins-nursery/fluent-plugin-out-http)
+
+## Configuration options
+
+ <match *>
+ @type http
+ endpoint_url http://localhost.local/api/
+ http_method put # default: post
+ serializer json # default: form
+ rate_limit_msec 100 # default: 0 = no rate limiting
+ raise_on_error false # default: true
+ recoverable_status_codes 503, 400 # default: 503
+ authentication basic # default: none
+ username alice # default: ''
+ password bobpop # default: '', secret: true
+ buffered true # default: false. Switch non-buffered/buffered mode
+ bulk_request false # default: false. Send events as application/x-ndjson
+ cacert_file /etc/ssl/endpoint1.cert # default: ''
+ client_cert_path /path/to/client_cert.crt # default: ''
+ private_key_path /path/to/private_key.key # default: ''
+ private_key_passphrase yourpassphrase # default: ''
+ token tokent # default: ''
+ custom_headers {"token":"arbitrary"} # default: nil
+ </match>
+
+## Usage notes
+
+If you'd like to retry failed requests, consider using [fluent-plugin-bufferize][3].
+Or, specify appropriate `recoverable_status_codes` parameter.
+
+To send events with bulk_request, you should specify `bulk_request` as `true`
+Note that when this parameter as `true`, Fluentd always send events as `application/x-ndjson`.
+Currently, `application/x-ndjson` is only supported MIME type for bulk_request.
+
+----
+
+Heavily based on [fluent-plugin-growthforecast][2]
+
+ [1]: http://fluentd.org/
+ [2]: https://github.com/tagomoris/fluent-plugin-growthforecast
+ [3]: https://github.com/sabottenda/fluent-plugin-bufferize