The out_http Output plugin writes records into via HTTP/HTTPS.

This plugin is introduced since fluentd v1.7.0.

Example Configuration

out_http is included in Fluentd's core. No additional installation process is required.

<match pattern>
  @type http
​
  endpoint http://logserver.com:9000/api
  open_timeout 2
​
  <format>
    @type json
  </format>
  <buffer>
    flush_interval 10s
  </buffer>
</match>

Please see the Config File article for the basic structure and syntax of the configuration file. For <buffer> section, please check Buffer section cofiguration.

Parameters

@type

The value must be http.

endpoint

The endpoint for HTTP request. If you want to use HTTPS, use https prefix.

# Use HTTP
endpoint http://example.com/api
# USe HTTPS. You can set additional HTTPS parameters like tls_xxx
endpoint https://example.com/api

The endpoint parameter supports placeholders, so you can embed time, tag and record fields in the endpoint. Here is an example:

endpoint http://example.com/api/${tag}-${key}
<buffer tag,key>
  # buffer parameters
</buffer>

See Buffer section configurations for more details.

http_method

The method for HTTP request

proxy

The proxy for HTTP request

content_type

Content-Type for HTTP request. out_http automatically set Content-Type for built-in formatters when this parameter is not specified. Here is a table:

• json: application/x-ndjson

• csv: text/csv

• tsv, ltsv: text/tab-separated-values

• msgpack: application/x-msgpack

• out_file, single_value, stdout, hash: text/plain

<format> directive

The format of the payload. The default @type is json. Here is single_value example:

<format>
  @type single_value
</format>

See formatter article for more detail.

headers

Additional headers for HTTP request

headers {"key1":"value1", "key2":"value2"}

open_timeout

The connection open timeout in seconds. See also Ruby document​

read_timeout

The read timeout in seconds. See also Ruby document​

ssl_timeout

The TLS timeout in seconds

tls_ca_cert_path

The CA certificate path for TLS

tls_client_cert_path

The client certificate path for TLS

tls_private_key_path

The client private key path for TLS

tls_private_key_passphrase

The client private key passphrase for TLS

tls_verify_mode

The verify mode of TLS

tls_version

The default version of TLS

tls_ciphers

The cipher suites configuration of TLS.

error_response_as_unrecoverable

Raise UnrecoverableError when the response code is non success, 1xx/3xx/4xx/5xx. If false, out_http logs error message instead of raising UnrecoverableError.

See also Handling Unrecoverable Errors​

retryable_response_codes

The list of retryable response code. If the response code is included in this list, out_http retries the buffer flush.

<auth> section

Specify HTTP authentication.

<auth>
  method basic
  username fluentd
  password hello
</auth>

method

The method for HTTP authentication. Now only basic.

username

The username for basic authentication

password

The password for basic authentication

Common Output / Buffer parameters

For common output / buffer parameters, please check the following articles.

• ​Output Plugin Overview​

• ​Buffer Section Configuration​

The payload content

out_http's request body depends on <format> configuration. For example, the default setting generates newline delimited json like below:

# \n is added by `add_newline true` parameter in <format>
{"key1":"value1","key2":"value2",...}\n
{"key1":"value1","key2":"value2",...}\n
{"key1":"value1","key2":"value2",...}\n
{"key1":"value1","key2":"value2",...}\n
...

With @type single_value:

log line1\n
log line2\n
log line3\n
log line4\n
...

If this article is incorrect or outdated, or omits critical information, please let us know. Fluentd is a open source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.