Http plugin for Fluentd 🔗︎

Overview 🔗︎

Sends logs to HTTP/HTTPS endpoints. More info at

Example output configurations 🔗︎

      tags: "[]"
      flush_interval: 10s

Configuration 🔗︎

Output Config 🔗︎

endpoint (string, required) {#output config-endpoint} 🔗︎

Endpoint for HTTP request.

Default: -

http_method (string, optional) {#output config-http_method} 🔗︎

Method for HTTP request. [post, put]

Default: post

proxy (string, optional) {#output config-proxy} 🔗︎

Proxy for HTTP request.

Default: -

content_type (string, optional) {#output config-content_type} 🔗︎

Content-Profile for HTTP request.

Default: -

json_array (bool, optional) {#output config-json_array} 🔗︎

Using array format of JSON. This parameter is used and valid only for json format. When json_array as true, Content-Profile should be application/json and be able to use JSON data for the HTTP request body.

Default: false

format (*Format, optional) {#output config-format} 🔗︎


Default: -

headers (map[string]string, optional) {#output config-headers} 🔗︎

Additional headers for HTTP request.

Default: -

open_timeout (int, optional) {#output config-open_timeout} 🔗︎

Connection open timeout in seconds.

Default: -

read_timeout (int, optional) {#output config-read_timeout} 🔗︎

Read timeout in seconds.

Default: -

ssl_timeout (int, optional) {#output config-ssl_timeout} 🔗︎

TLS timeout in seconds.

Default: -

tls_version (string, optional) {#output config-tls_version} 🔗︎

The default version of TLS transport. [TLSv1_1, TLSv1_2]

Default: TLSv1_2

tls_ciphers (string, optional) {#output config-tls_ciphers} 🔗︎

The cipher configuration of TLS transport.

Default: ALL:!aNULL:!eNULL:!SSLv2

tls_ca_cert_path (*secret.Secret, optional) {#output config-tls_ca_cert_path} 🔗︎

The CA certificate path for TLS.

Default: -

tls_client_cert_path (*secret.Secret, optional) {#output config-tls_client_cert_path} 🔗︎

The client certificate path for TLS.

Default: -

tls_private_key_path (*secret.Secret, optional) {#output config-tls_private_key_path} 🔗︎

The client private key path for TLS.

Default: -

tls_private_key_passphrase (*secret.Secret, optional) {#output config-tls_private_key_passphrase} 🔗︎

The client private key passphrase for TLS.

Default: -

tls_verify_mode (string, optional) {#output config-tls_verify_mode} 🔗︎

The verify mode of TLS. [peer, none]

Default: peer

error_response_as_unrecoverable (*bool, optional) {#output config-error_response_as_unrecoverable} 🔗︎

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

Default: true

retryable_response_codes ([]int, optional) {#output config-retryable_response_codes} 🔗︎

List of retryable response codes. If the response code is included in this list, the plugin retries the buffer flush. Since Fluentd v2 the Status code 503 is going to be removed from default.

Default: [503]

auth (*HTTPAuth, optional) {#output config-auth} 🔗︎

HTTP auth

Default: -

buffer (*Buffer, optional) {#output config-buffer} 🔗︎


Default: -

slow_flush_log_threshold (string, optional) {#output config-slow_flush_log_threshold} 🔗︎

The threshold for chunk flush performance check. Parameter type is float, not time, default: 20.0 (seconds) If chunk flush takes longer time than this threshold, fluentd logs warning message and increases metric fluentd_output_status_slow_flush_count.

Default: -

HTTP auth config 🔗︎


username (*secret.Secret, required) {#http auth config-username} 🔗︎

Username for basic authentication. Secret

Default: -

password (*secret.Secret, required) {#http auth config-password} 🔗︎

Password for basic authentication. Secret

Default: -